Decrypt
    • PDF

    Decrypt

    • PDF

    기사 요약

    개요

    지정된 마스터키로 암호문을 복호화합니다. 복호화 요청 시 지정된 키 버전으로 복호화되기 때문에 암호문과 함께 KMS prefix가 정확히 명시되어야 합니다. 암/복호화용 키 타입으로만 요청 가능합니다.

    POST https://kms.apigw.ntruss.com/keys/v1/{keyTag}/decrypt
    POST https://kms.apigw.ntruss.com/keys/v2/{keyTag}/decrypt
    

    요청

    요청 파라미터

    파라미터명타입설명
    keyTagString(Required)복호화에 사용할 마스터키의 tag 값

    요청 바디

    {
      "ciphertext" : string 또는 string list,
      "context" : string
    }
    
    파라미터명타입설명
    ciphertextString 또는 String List(Required)- 복호화할 데이터
    kms prefix와 Base64 Encoding된 암호문으로 구성되어야 함
    리스트는 전체 항목 합산 최대 32KB
    contextString(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]
    }
    
    파라미터명타입설명
    plaintextString- 평문 데이터
    Base64 Encoding 되어있음
    String 타입으로 요청하는 경우 반환
    plaintextListString List- 평문 데이터
    Base64 Encoding 되어있음
    String List 타입으로 요청하는 경우 반환

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

    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.