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