Decrypt
- Print
- PDF
Decrypt
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Overview
Decrypts ciphertext with the specified master key. Since decryption is performed with the specified key version, the KMS prefix as well as the ciphertext should be exactly specified. Only a key type for encryption and decryption can be specified.
POST https://kms.apigw.ntruss.com/keys/v1/{keyTag}/decrypt
POST https://kms.apigw.ntruss.com/keys/v2/{keyTag}/decrypt
Request
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| keyTag | String | Y | Tag of the master key for decryption. |
Request body
{
"ciphertext" : string or string list,
"context" : string
}
| Parameter | Type | Required | Description |
|---|---|---|---|
| ciphertext | String or List of Strings | Y | Ciphertext to decrypt (It must be composed of a KMS prefix and Base64-encoded ciphertext.) |
| context | String | N | Context for key derivation (up to 50Byte) (It needs to be Base64-encoded.) Required only for Convergent Encryption |
Example of Request body
{
"ciphertext" : "ncpkms:v1:+xQZ2wyDin4vK7O4tue8QSnFB9Tu8MjiE1xTlhlGnrM=",
"context" : "dGhpcyBpcyBhIHRlc3QgY29udGV4dA=="
}
Or
{
"ciphertext" : ["ncpkms:v1:+xQZ2wyDin4vK7O4tue8QSnFB9Tu8MjiE1xTlhlGnrM=", "ncpkms:v1:QoRYNd8LxURIEWpwMBRS0Sntv5Zx5cl78dWCTB1T2Ic=", "ncpkms:v1:wPgBmRczInROzKqvnStna9vMX7Q+tApFX8Xh4xGWPL4="],
"context" : "dGhpcyBpcyBhIHRlc3QgY29udGV4dA=="
}
Response
Response body
{
"plaintext" : string
}
| Field | Type | Description |
|---|---|---|
| plaintext | String | Plaintext (It is Base64-encoded.) |
Roles
Manager, Decryptor, Encryptor/Decryptor
Was this article helpful?