Giải mã dữ liệu được xuất từ Google trong ngữ cảnh đặc quyền. Trước đây có tên 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 tài liệu gốc hoặc danh sách kiểm soát quyền truy cập vào tệp (ACL). Để biết ví dụ về trường hợp sử dụng, hãy xem bài viết: Google Takeout.
Yêu cầu HTTP
POST https://KACLS_URL/privilegedunwrap
Thay thế KACLS_URL
bằng URL Dịch vụ danh sách kiểm soát quyền truy cập khoá (KACLS).
Tham số đường dẫn
Không nội dung nào.
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 } |
Các trường | |
---|---|
authentication |
JWT do IdP phát hành để xác nhận người dùng là ai. Hãy xem mã thông báo xác thực. |
reason |
Một chuỗi JSON truyền qua cung cấp thêm ngữ cảnh về hoạt động. Tệp JSON bạn 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 |
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 |
wrapped_key |
Đối tượng nhị phân base64 được |
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 thì hàm sẽ trả về phản hồi lỗi có cấu trúc.
Biểu diễn dưới dạng JSON | |
---|---|
{ "key": string } |
Các trường | |
---|---|
key |
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="
}