Phương thức: đặc quyền

Giải mã dữ liệu được xuất từ Google trong một bối cảnh đặc quyền. Trước đây được gọi là TakeoutUnwrap. Trả về Khoá mã hoá dữ liệu (DEK) được gói bằng wrap mà không cần kiểm tra danh sách kiểm soát truy cập (ACL) của tài liệu hoặc tệp gốc. Để biết ví dụ về trường hợp sử dụng, hãy xem: Google Takeout.

Yêu cầu HTTP

POST https://KACLS_URL/privilegedunwrap

Thay thế KACLS_URL bằng URL của Dịch vụ danh sách kiểm soát quyền truy cập khoá (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 với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "authentication": string,
  "reason": string,
  "resource_name": string,
  "wrapped_key": string
}
Trường
authentication

string

Một JWT do IdP phát hành để xác nhận danh tính của người dùng. Hãy xem mã thông báo xác thực.
reason

string (UTF-8)

Một chuỗi JSON truyền qua cung cấp thêm bối cảnh về thao tác. Bạn nên dọn dẹp JSON đã cung cấp trước khi hiển thị. Kích thước tối đa: 1 KB.
resource_name

string (UTF-8)

Giá trị nhận dạng của đối tượng được mã hoá bằng DEK. Giá trị này phải khớp với resource_name dùng để bao bọc khoá. Kích thước tối đa: 128 byte.
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ề khoá mã hoá tài liệu.

Nếu thao tác không thành công, bạn nên trả về phản hồi lỗi có cấu trúc.

Biểu diễn dưới dạng JSON 
{
  "key": string
}
Trường
key

string

DEK được mã hoá base64.

Ví dụ:

Ví dụ này cung cấp một yêu cầu và phản hồi mẫu cho phương thức privilegedunwrap.

Yêu cầu

POST https://mykacls.example.com/v1/takeout_unwrap

{
   "wrapped_key": "7qTh6Mp+svVwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg==",
   "authentication": "eyJhbGciOi…"
   "reason": "{client:'takeout' op:'read'}"
   "resource_name": "item123"
}

Phản hồi

{
    "key": "0saNxttLMQULfXuTbRFJzi/QJokN1jW16u0yaNvvLdQ="
}