Méthode: privatekeydecrypt

Désencapsule une clé privée encapsulée, puis déchiffre la clé de chiffrement de contenu chiffrée avec la clé publique.

Requête HTTP

POST https://BASE_URL/privatekeydecrypt

Remplacez BASE_URL par l'URL de base.

Paramètres du chemin d'accès

Aucune

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "authentication": string,
  "authorization": string,
  "algorithm": string,
  "encrypted_data_encryption_key": string,
  "rsa_oaep_label": string,
  "reason": string,
  "wrapped_private_key": string
}
Champs
authentication

string

Jeton JWT émis par le fournisseur d'identité (IdP) qui vérifie l'identité de l'utilisateur. Voir Jetons d'authentification.
authorization

string

Jeton JWT confirmant que l'utilisateur est autorisé à désencapsuler une clé pour resource_name. Consultez la page Jetons d'autorisation.
algorithm

string

Algorithme utilisé pour chiffrer la clé de chiffrement des données (DEK) dans le chiffrement encapsulé.
encrypted_data_encryption_key

string (UTF-8)

Clé de chiffrement du contenu chiffré encodée en base64, avec la clé publique associée à la clé privée. Taille maximale: 1 Ko.
rsa_oaep_label

string

Étiquette L encodée en base64, si l'algorithme est RSAES-OAEP. Si l'algorithme n'est pas RSAES-OAEP, ce champ est ignoré.
reason

string (UTF-8)

Chaîne JSON passthrough fournissant des informations supplémentaires sur l'opération. Le fichier JSON fourni doit être nettoyé avant d'être affiché. Taille maximale: 1 Ko.
wrapped_private_key

string

Clé privée encapsulée encodée en base64. Taille maximale: 8 Ko.

Le format de la clé privée ou de la clé privée encapsulée dépend de l'implémentation du service de liste de contrôle d'accès aux clés (KACLS). Du côté du client comme de Gmail, cet objet est considéré comme un blob opaque.

Corps de la réponse

Lorsque cette méthode fonctionne, elle renvoie une clé de chiffrement de données base64.

Si l'opération échoue, une réponse d'erreur structurée est renvoyée.

Représentation JSON 
{
  "data_encryption_key": string
}
Champs
data_encryption_key

string

Une clé de chiffrement de données encodée en base64.

Exemple

Cet exemple fournit un exemple de requête et de réponse pour la méthode privatekeydecrypt.

Requête

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"
}

Réponse

{
  "data_encryption_key": "akRQtv3nr+jUhcFL6JmKzB+WzUxbkkMyW5kQsqGUAFc="
}