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

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

Yêu cầu HTTP

POST https://KACLS_URL/privilegedunwrap

Thay thế KACLS_URL bằng Dịch vụ danh sách kiểm soát ra vào chìa khoá (KACLS) URL.

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 
{
  "authentication": string,
  "reason": string,
  "resource_name": string,
  "wrapped_key": string
}
Trường
authentication

string

JWT do IdP (nhà cung cấp danh tính) cấp để xác nhận người dùng là ai. Xem phần mã thông báo xác thực.
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.
resource_name

string (UTF-8)

Giá trị nhận dạng của đối tượng được DEK mã hoá. Giá trị này phải khớp với resource_name dùng để gói 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, trả lời lỗi có cấu trúc sẽ được trả về.

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