메서드: wrapprivatekey

사용자의 비공개 키를 래핑합니다. 이는 권한이 있는 작업이며 승인된 키 액세스제어 목록 서비스 (KACLS) 관리자만 수행할 수 있습니다. 이 API는 선택사항입니다. Google과 Gmail 클라이언트는 이 API를 호출하지 않습니다. 제공된 사양은 권장사항이 아닌 권장사항입니다.

HTTP 요청

POST https://BASE_URL/wrapprivatekey

BASE_URL를 기준 URL로 바꿉니다.

경로 매개변수

없음

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "authentication": string,
  "perimeter_id": string,
  "private_key": string
}
필드
authentication

string

사용자를 어설션하는 ID 공급업체 (IdP)에서 발급한 JWT입니다. 인증 토큰을 참조하세요.
perimeter_id

string (UTF-8)

키로 암호화할 경계 ID입니다.
private_key

string

base64로 인코딩된 DEK입니다. 최대 크기: 128바이트

응답 본문

성공하면 이 메서드는 래핑된 비공개 키를 반환합니다.

작업이 실패하면 구조화된 오류 응답이 반환됩니다.

JSON 표현 
{
  "wrapped_private_key": string
}
필드
wrapped_private_key

string

base64로 인코딩된 래핑된 비공개 키입니다. 최대 크기: 8KB.

예

이 예에서는 wrapprivatekey 메서드에 대한 샘플 요청 및 응답을 제공합니다.

요청

POST https://mykacls.example.org/v1/wrapprivatekey

{
  "private_key": "-----BEGIN RSA PRIVATE KEY-----\\nMIIJ......\\n-----END RSA PRIVATE KEY-----",
  "perimeter_id": ""
}

응답

{
  "wrapped_private_key": "LpyCSy5ddy82PIp/87JKaMF4Jmt1KdrbfT1iqpB7uhVd3OwZiu+oq8kxIzB7Lr0iX4aOcxM6HiUyMrGP2PG8x0HkpykbUKQxBVcfm6SLdsqigT9ho5RYw20M6ZXNWVRetFSleKex4SRilTRny38e2ju/lUy0KDaCt1hDUT89nLZ1wsO3D1F3xk8J7clXv5fe7GPRd1ojo82Ny0iyVO7y7h1lh2PACHUFXOMzsdURYFCnxhKAsadccCxpCxKh5x8p78PdoenwY1tnT3/X4O/4LAGfT4fo98Frxy/xtI49WDRNZi6fsL6BQT4vS/WFkybBX9tXaenCqlRBDyZSFhatPQ==",
}