Create user custom key

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

개요

임의의 high-entropy 키를 주어진 bit로 생성합니다(대칭키 방식으로만 지원). 지정된 마스터키의 현재 버전으로 봉인된 키와 함께 평문 형태의 키를 반환받을 수도 있습니다. 암/복호화용 키 타입으로만 요청 가능합니다.

POST https://kms.apigw.fin-ntruss.com/keys/v1/{keyTag}/createCustomKey
POST https://kms.apigw.fin-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,
  "key_version": integer
  "ciphertext" : string
}

파라미터 명	타입	설명
plaintext	String	- 생성된 키의 평문 형태 requestPlainKey: true일 때만 반환 Base64 Encoding 되어 있음
key_version	Integer	- 마스터키의 버전 정보
ciphertext	String	- 생성된 키의 봉인된 형태 Base64 Encoding 되어 있음

Manager, Encryptor, Encryptor/Decryptor

이 문서가 도움이 되었습니까?

태그