Membuka kunci pribadi yang digabungkan, lalu mendekripsi kunci enkripsi konten yang dienkripsi ke kunci publik.
Permintaan HTTP
POST https://BASE_URL/privatekeydecrypt
Ganti BASE_URL
dengan URL dasar.
Parameter jalur
Tidak ada.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON | |
---|---|
{ "authentication": string, "authorization": string, "algorithm": string, "encrypted_data_encryption_key": string, "rsa_oaep_label": string, "reason": string, "wrapped_private_key": string } |
Kolom | |
---|---|
authentication |
JWT yang dikeluarkan oleh penyedia identitas (IdP) yang menyatakan siapa pengguna. Lihat token autentikasi. |
authorization |
JWT yang menyatakan bahwa pengguna diizinkan untuk membuka kunci |
algorithm |
Algoritma yang digunakan untuk mengenkripsi Kunci Enkripsi Data (DEK) dalam enkripsi envelope. |
encrypted_data_encryption_key |
Kunci enkripsi konten terenkripsi base64, yang dienkripsi dengan kunci publik yang terkait dengan kunci pribadi. Ukuran maks: 1 KB. |
rsa_oaep_label |
Label L berenkode Base64, jika algoritmanya adalah RSAES-OAEP. Jika algoritma bukan RSAES-OAEP, kolom ini akan diabaikan. |
reason |
String JSON passthrough yang memberikan konteks tambahan tentang operasi. JSON yang disediakan harus dibersihkan sebelum ditampilkan. Ukuran maks: 1 KB. |
wrapped_private_key |
Kunci pribadi yang digabungkan berenkode base64. Ukuran maks: 8 KB. Format kunci pribadi atau kunci pribadi yang digabungkan bergantung pada implementasi Key Access Control List Service (KACLS). Di klien dan di sisi Gmail, file ini diperlakukan sebagai blob buram. |
Isi respons
Jika berhasil, metode ini akan menampilkan kunci enkripsi data base64.
Jika operasi gagal, sebuah balasan error terstruktur akan dikembalikan.
Representasi JSON | |
---|---|
{ "data_encryption_key": string } |
Kolom | |
---|---|
data_encryption_key |
Kunci enkripsi data berenkode base64. |
Contoh
Contoh ini memberikan contoh permintaan dan respons untuk privatekeydecrypt
.
Permintaan
POST https://mykacls.example.org/v1/privatekeydecrypt
{
"wrapped_private_key": "wHrlNOTI9mU6PBdqiq7EQA...",
"encrypted_data_encryption_key": "dGVzdCB3cmFwcGVkIGRlaw...",
"authorization": "eyJhbGciOi...",
"authentication": "eyJhbGciOi...",
"algorithm": "RSA/ECB/PKCS1Padding",
"reason": "decrypt"
}
Tanggapan
{
"data_encryption_key": "akRQtv3nr+jUhcFL6JmKzB+WzUxbkkMyW5kQsqGUAFc="
}