Phương thức: gói

Trả về Khoá mã hoá dữ liệu (DEK) đã mã hoá và dữ liệu liên quan.

Để biết thêm thông tin, hãy xem phần Mã hoá và giải mã dữ liệu.

Yêu cầu HTTP

POST https://KACLS_URL/wrap

Thay thế KACLS_URL bằng Danh sách kiểm soát quyền truy cập vào khoá Dịch vụ (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,
  "authorization": string,
  "key": string,
  "reason": 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.

authorization

string

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

key

string

DEK được mã hoá base64. Kích thước tối đa: 128 byte.

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.

Nội dung phản hồi

Nếu thành công, phương thức này sẽ trả về một đối tượng nhị phân mờ sẽ được lưu trữ bằng đối tượng đã mã hoá và được gửi nguyên trạng trong thao tác khám phá khoá.

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ề.

Đối tượng nhị phân chỉ được chứa bản sao của DEK được mã hoá, dữ liệu triển khai cụ thể có thể được lưu trữ trong đó.

Không lưu trữ DEK trong hệ thống Dịch vụ danh sách kiểm soát truy cập khoá (KACLS), thay vào đó, hãy mã hoá và trả về mã đó trong đối tượng wrapped_key. Điều này giúp ngăn chặn sự khác biệt trong thời gian tồn tại giữa tài liệu và khoá của tài liệu đó. Ví dụ: để đảm bảo dữ liệu của người dùng bị xoá hoàn toàn khi họ yêu cầu hoặc để đảm bảo các phiên bản trước đó được khôi phục từ bản sao lưu đều có thể giải mã.

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

string

Đối tượng nhị phân được mã hoá base64. Kích thước tối đa: 1 KB.

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 wrap.

Yêu cầu

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

{
   "key":"wHrlNOTI9mU6PBdqiq7EQA==",
   "authorization": "eyJhbGciOi…"
   "authentication": "eyJhbGciOi…"
   "reason": "{client:'drive' op:'update'}"
}

Phản hồi

{
    "wrapped_key": "3qTh6Mp+svPwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg=="
}