메서드: digest
이 호출은 wrap API로 래핑된 데이터 암호화 키 (DEK)를 사용합니다.
는 base64로 인코딩된
리소스 키 해시를 사용합니다.
참고 항목: rewrap
HTTP 요청
POST https://KACLS_URL/digest
KACLS_URL
를 키 액세스 제어 목록으로 바꿉니다.
서비스 (KACLS) URL입니다.
경로 매개변수
없음
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
{
"authorization": string,
"reason": string,
"wrapped_key": string
}
|
필드 |
authorization |
string
사용자가 resource_name 의 키를 래핑 해제할 수 있음을 어설션하는 JWT입니다. 승인 토큰을 참조하세요.
|
reason |
string (UTF-8)
작업에 대한 추가 컨텍스트를 제공하는 패스 스루 JSON 문자열입니다. 제공된 JSON은 표시하기 전에 정리해야 합니다. 최대 크기: 1KB
|
wrapped_key |
string
wrap 에서 반환된 base64 바이너리 객체입니다.
|
응답 본문
성공할 경우 이 메서드는
리소스 키 해시를 사용합니다.
작업에 실패하면
구조화된 오류 답장
반환합니다.
JSON 표현 |
{
"resource_key_hash": string
}
|
예
요청
POST https://mykacls.example.com/v1/digest
{
"wrapped_key": "7qTh6Mp+svVwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg==",
"authorization": "eyJhbGciOi...",
"reason": "{client:'drive' op:'read'}"
}
응답
{
"resource_key_hash": "qClT153ghqBOLPpdMsc4S4n6okPrRaLPBYT0zRcn+go="
}
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-08-22(UTC)
[null,null,["최종 업데이트: 2024-08-22(UTC)"],[[["This API call takes a wrapped Data Encryption Key (DEK) and returns a base64 encoded resource key hash."],["The request body requires an authorization token, a reason for the operation, and the wrapped key."],["A successful response provides the resource key hash, while failures return a structured error reply."],["The `digest` endpoint is used for this operation within the Key Access Control List Service (KACLS)."],["See the provided links for more details on authorization tokens, resource key hash, wrap API, rewrap API and structured errors."]]],["This call digests a wrapped Data Encryption Key (DEK) using a POST request to the KACLS URL's `/digest` endpoint. The request body includes a `wrapped_key`, an `authorization` JWT, and a `reason` string. Upon success, the response returns a JSON object containing the base64 encoded `resource_key_hash`. Failure results in a structured error reply. The `resource_key_hash` can be later used in resources.\n"]]