Lệnh gọi này sẽ lấy một Khoá mã hoá dữ liệu (DEK) được gói bằng API bao bọc, và trả về mã hoá base64 băm khoá tài nguyên.
Xem thêm: rewrap
Yêu cầu HTTP
POST https://KACLS_URL/digest
Thay thế KACLS_URL
bằng Danh sách kiểm soát quyền truy cập vào khoá
URL của Dịch vụ (KACLS).
Tham số đường dẫn
Không có.
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON | |
---|---|
{ "authorization": string, "reason": string, "wrapped_key": string } |
Trường | |
---|---|
authorization |
Một JWT khẳng định rằng người dùng được phép khám phá khoá của |
reason |
Chuỗi JSON truyền qua cung cấp thêm ngữ cảnh về thao tác. JSON được cung cấp phải được dọn dẹp trước khi hiển thị. Kích thước tối đa: 1 KB. |
wrapped_key |
Đối tượng nhị phân base64 do |
Nội dung phản hồi
Nếu thành công, phương thức này sẽ trả về một mã hoá base64 băm khoá tài nguyên.
Nếu thao tác không thành công, trả lời lỗi có cấu trúc sẽ được trả về.
Biểu diễn dưới dạng JSON | |
---|---|
{ "resource_key_hash": string } |
Trường | |
---|---|
resource_key_hash |
đối tượng nhị phân được mã hoá base64. Xem hàm băm của khoá tài nguyên. |
Ví dụ:
Yêu cầu
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'}"
}
Phản hồi
{
"resource_key_hash": "qClT153ghqBOLPpdMsc4S4n6okPrRaLPBYT0zRcn+go="
}