Create user custom key
- 인쇄
- PDF
Create user custom key
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
임의의 high-entropy 키를 주어진 bit로 생성합니다(대칭키 방식으로만 지원). 지정된 마스터키의 현재 버전으로 봉인된 키와 함께 평문 형태의 키를 반환받을 수도 있습니다. 암/복호화용 키 타입으로만 요청 가능합니다.
POST https://kms.apigw.gov-ntruss.com/keys/v1/{keyTag}/createCustomKey
POST https://kms.apigw.gov-ntruss.com/keys/v2/{keyTag}/createCustomKey
요청
요청 파라미터
파라미터명 | 타입 | 설명 |
---|---|---|
keyTag | String(Required) | 생성된 키 봉인에 사용할 마스터키의 tag 값 |
요청 바디
{
"requestPlainKey" : boolean,
"bits" : integer
}
파라미터명 | 타입 | 설명 |
---|---|---|
requestPlainKey | Boolean(Required) | 생성된 키를 평문 형태로 반환받을지 선택하는 플래그 |
bits | Integer(Optional) | 생성될 키의 비트 128, 256, 512(기본 256) |
context | String(Optional) | 마스터키가 수렴 암호가 적용되었을 때 사용 컨텍스트 데이터 (최대 50Byte) Base64 Encoding 필요 |
응답
응답 바디
{
"plaintext" : string,
"ciphertext" : string
}
파라미터명 | 타입 | 설명 |
---|---|---|
plaintext | String | 생성된 키의 평문 형태(requestPlainKey: true일 때만 반환) (Base64 Encoding 되어 있음) |
ciphertext | String | 생성된 키의 봉인된 형태 (Base64 Encoding 되어 있음) |
필요 권한
Manager, Encryptor, Encryptor/Decryptor
이 문서가 도움이 되었습니까?