Method: users.settings.cse.keypairs.disable

Désactive une paire de clés de chiffrement côté client. L'utilisateur authentifié ne peut plus utiliser la paire de clés pour déchiffrer le texte des messages CSE entrants ni signer les e-mails CSE sortants.

Pour rétablir l'accès, utilisez keypairs.enable pour activer la paire de clés.

Passé ce délai, vous pouvez supprimer définitivement la paire de clés à l'aide de la méthode keypairs.obliterate.

Pour les administrateurs qui gèrent les identités et les paires de clés des utilisateurs de leur organisation, les requêtes nécessitent une autorisation avec un compte de service disposant d'une autorité de délégation à l'échelle du domaine pour emprunter l'identité des utilisateurs avec le champ d'application https://www.googleapis.com/auth/gmail.settings.basic.

Pour les utilisateurs qui gèrent leurs propres identités et paires de clés, les demandes nécessitent que le chiffrement par clé matérielle soit activé et configuré.

Requête HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:disable

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
userId

string

Adresse e-mail principale du demandeur. Pour indiquer l'utilisateur authentifié, vous pouvez utiliser la valeur spéciale me.
keyPairId

string

Identifiant de la paire de clés à désactiver.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de CseKeyPair.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://www.googleapis.com/auth/gmail.settings.sharing

Pour plus d'informations, consultez la OAuth 2.0 Overview.