Phương thức: thông báo

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

string

Một JWT khẳng định rằng người dùng được phép khám phá khoá của resource_name. Xem phần mã thông báo uỷ quyền.

reason

string (UTF-8)

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

string

Đối tượng nhị phân base64 do wrap trả về.

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

string

đố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="
}