Metode ini membantu Anda bermigrasi dari Key Access Control List Service (KACLS1) lama ke KACLS (KACLS2) yang lebih baru. Dibutuhkan Kunci Enkripsi Data (DEK)
yang digabungkan dengan wrap
API KACLS1, dan menampilkan
DEK yang digabungkan dengan wrap
API KACLS2.
Permintaan HTTP
POST https://KACLS_URL/rewrap
Ganti KACLS_URL
dengan URL Key Access Control List
Service (KACLS).
Parameter jalur
Tidak ada.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON | |
---|---|
{ "authorization": string, "original_kacls_url": string, "reason": string, "wrapped_key": string } |
Kolom | |
---|---|
authorization |
JWT yang menyatakan bahwa pengguna diizinkan membuka kunci untuk |
original_kacls_url |
URL KACLS wrapped_key saat ini. |
reason |
String JSON passthrough yang memberikan konteks tambahan tentang operasi. JSON yang diberikan harus dibersihkan sebelum ditampilkan. Ukuran maks: 1 KB. |
wrapped_key |
Objek biner base64 yang ditampilkan oleh |
Isi respons
Jika berhasil, metode ini menampilkan objek biner buram yang akan disimpan oleh Google Workspace bersama objek yang dienkripsi dan dikirim apa adanya dalam operasi pembukaan kunci berikutnya. Metode ini juga akan menampilkan resource_key_hash berenkode base64.
Jika operasi gagal, balasan error terstruktur akan ditampilkan.
Objek biner harus berisi satu-satunya salinan DEK terenkripsi. Data khusus implementasi dapat disimpan di dalamnya.
Jangan simpan DEK di sistem KACLS, tetapi enkripsi dan tampilkan dalam
objek wrapped_key
. Hal ini mencegah perbedaan masa aktif antara dokumen dan kuncinya. Misalnya, untuk memastikan bahwa data pengguna sepenuhnya dihapus saat mereka memintanya, atau untuk memastikan bahwa versi sebelumnya yang dipulihkan dari cadangan akan dapat didekripsi.
Google tidak akan mengirimkan permintaan penghapusan ke KACLS saat objek dihapus.
Representasi JSON | |
---|---|
{ "resource_key_hash": string, "wrapped_key": string } |
Kolom | |
---|---|
resource_key_hash |
objek biner dengan enkode base64. Lihat hash kunci resource. |
wrapped_key |
Objek biner berenkode base64. Ukuran maks: 1 KB. |
Contoh
Contoh ini memberikan contoh permintaan dan respons untuk metode rewrap
.
Permintaan
POST https://mykacls.example.com/v1/rewrap
{
"wrapped_key": "7qTh6Mp+svVwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg==",
"authorization": "eyJhbGciOi...",
"original_kacls_url": "https://<kacl1_base_url>",
"reason": "{client:'drive' op:'read'}"
}
Respons
{
"wrapped_key": "3qTh6Mp+svPwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg==",
"resource_key_hash": "SXOyPekBAUI95zuZSuJzsBlK4nO5SuJK4nNCPem5SuI="
}