Create user custom key
    • PDF

    Create user custom key

    • PDF

    기사 요약

    개요

    임의의 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
    

    요청

    요청 파라미터

    파라미터 명타입설명
    keyTagString(Required)생성된 키 봉인에 사용할 마스터키의 tag 값

    요청 바디

    {
      "requestPlainKey" : boolean,
      "bits" : integer
    }
    
    파라미터 명타입설명
    requestPlainKeyBoolean(Required)생성된 키를 평문 형태로 반환받을지 선택하는 플래그
    bitsInteger(Optional)- 생성될 키의 비트
    128, 256, 512 (기본 256)
    contextString(Optional)마스터키가 수렴 암호가 적용되었을 때 사용
    컨텍스트 데이터 (최대 50Byte)
    Base64 Encoding 필요

    응답

    응답 바디

    {
      "plaintext" : string,
      "key_version": integer
      "ciphertext" : string
    }
    
    파라미터 명타입설명
    plaintextString- 생성된 키의 평문 형태
    requestPlainKey: true일 때만 반환
    Base64 Encoding 되어 있음
    key_versionInteger- 마스터키의 버전 정보
    ciphertextString- 생성된 키의 봉인된 형태
    Base64 Encoding 되어 있음

    필요 권한

    Manager, Encryptor, Encryptor/Decryptor


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

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.