Decrypt
- 인쇄
- PDF
Decrypt
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
개요
지정된 마스터키로 암호문을 복호화합니다. 복호화 요청 시 지정된 키 버전으로 복호화되기 때문에 암호문과 함께 KMS prefix가 정확히 명시되어야 합니다. 암/복호화용 키 타입으로만 요청 가능합니다.
POST https://kms.apigw.ntruss.com/keys/v1/{keyTag}/decrypt
POST https://kms.apigw.ntruss.com/keys/v2/{keyTag}/decrypt
요청
요청 파라미터
| 파라미터명 | 타입 | 설명 |
|---|---|---|
| keyTag | String(Required) | 복호화에 사용할 마스터키의 tag 값 |
요청 바디
{
"ciphertext" : string 또는 string list,
"context" : string
}
| 파라미터명 | 타입 | 설명 |
|---|---|---|
| ciphertext | String 또는 String List(Required) | - 복호화할 데이터 kms prefix와 Base64 Encoding된 암호문으로 구성되어야 함 리스트는 전체 항목 합산 최대 32KB |
| context | String(Optional) | - 컨텍스트 데이터 (최대 50Byte) Base64 Encoding 필요 수렴 암호 방식의 AES-256 키 타입인 경우에만 필수 입력 |
요청 바디 예시
{
"ciphertext" : "ncpkms:v1:+xQZ2wyDin4vK7O4tue8QSnFB9Tu8MjiE1xTlhlGnrM=",
"context" : "dGhpcyBpcyBhIHRlc3QgY29udGV4dA=="
}
또는
{
"ciphertext" : ["ncpkms:v1:+xQZ2wyDin4vK7O4tue8QSnFB9Tu8MjiE1xTlhlGnrM=", "ncpkms:v1:QoRYNd8LxURIEWpwMBRS0Sntv5Zx5cl78dWCTB1T2Ic=", "ncpkms:v1:wPgBmRczInROzKqvnStna9vMX7Q+tApFX8Xh4xGWPL4="],
"context" : "dGhpcyBpcyBhIHRlc3QgY29udGV4dA=="
}
응답
응답 바디
{
"plaintext" : string
}
또는
{
"plaintextList" : [string, string, string]
}
| 파라미터명 | 타입 | 설명 |
|---|---|---|
| plaintext | String | - 평문 데이터 Base64 Encoding 되어있음 String 타입으로 요청하는 경우 반환 |
| plaintextList | String List | - 평문 데이터 Base64 Encoding 되어있음 String List 타입으로 요청하는 경우 반환 |
필요 권한
Manager, Decryptor, Encryptor/Decryptor
이 문서가 도움이 되었습니까?