Odszyfrowuje bez sprawdzania uprawnień ACL zaszyfrowanego klucza prywatnego. Służy do odszyfrowywania danych wyeksportowanych (takeout) z Google.
Żądanie HTTP
POST https://KACLS_URL/privilegedprivatekeydecrypt
Zastąp KACLS_URL
adresem URL usługi kluczy do listy kontroli dostępu do kluczy (KACLS).
Parametry ścieżki
Brak.
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON | |
---|---|
{ "authentication": string, "algorithm": string, "encrypted_data_encryption_key": string, "rsa_oaep_label": string, "reason": string, "spki_hash": string, "spki_hash_algorithm": string, "wrapped_private_key": string } |
Pola | |
---|---|
authentication |
Token JWT wydany przez dostawcę tożsamości (IdP) potwierdzający tożsamość użytkownika. Zobacz tokeny uwierzytelniające. |
algorithm |
Algorytm użyty do szyfrowania klucza szyfrującego dane (DEK) w ramach szyfrowania kopertowego. |
encrypted_data_encryption_key |
Zaszyfrowany klucz szyfrowania treści z kodowaniem base64, który jest zaszyfrowany kluczem publicznym powiązanym z kluczem prywatnym. Maksymalny rozmiar: 1 KB. |
rsa_oaep_label |
Etykieta L zakodowana w formacie Base64, jeśli algorytm to RSAES-OAEP. Jeśli algorytm nie jest RSAES-OAEP, to pole jest ignorowane. |
reason |
Przekazany ciąg JSON zawierający dodatkowy kontekst operacji. Przed wyświetleniem należy zdezynfekować przesłany ciąg JSON. Maksymalny rozmiar: 1 KB. |
spki_hash |
Standardowy skrót zakodowany w formacie base64 |
spki_hash_algorithm |
Algorytm użyty do wygenerowania |
wrapped_private_key |
Zapakowany klucz prywatny zakodowany w standardzie base64. Maksymalny rozmiar: 8 KB. |
Treść odpowiedzi
Jeśli operacja się powiedzie, metoda zwróci klucz szyfrowania danych w formacie base64. Ten klucz jest używany po stronie klienta do odszyfrowywania treści wiadomości.
Jeśli operacja się nie powiedzie, zwracana jest strukturyzowana odpowiedź błędu.
Zapis JSON | |
---|---|
{ "data_encryption_key": string } |
Pola | |
---|---|
data_encryption_key |
Klucz szyfrujący dane zakodowany w formacie Base64. |
Przykład
Ten przykład zawiera przykładowe żądanie i odpowiedź dla metody privilegedprivatekeydecrypt
.
Żądanie
POST https://mykacls.example.org/v1/privilegedprivatekeydecrypt
{
"wrapped_private_key": "wHrlNOTI9mU6PBdqiq7EQA...",
"encrypted_data_encryption_key": "dGVzdCB3cmFwcGVkIGRlaw...",
"authentication": "eyJhbGciOi...",
"spki_hash": "LItGzrmjSFD57QdrY1dcLwYmSwBXzhQLAA6zVcen+r0=",
"spki_hash_algorithm": "SHA-256",
"algorithm": "RSA/ECB/PKCS1Padding",
"reason": "admin decrypt"
}
Odpowiedź
{
"data_encryption_key": "akRQtv3nr+jUhcFL6JmKzB+WzUxbkkMyW5kQsqGUAFc"
}