Dans Cloud KMS, le matériel de clé cryptographique que vous utilisez pour chiffrer, déchiffrer, signer et valider les données est stocké dans une version de clé. Une clé comporte zéro ou plusieurs versions de clé. Lorsque vous effectuez une rotation de clé, vous créez une nouvelle version de clé.
Cet article explique comment programmer la destruction définitive d'une version de clé. La destruction d'une version de clé entraîne la suppression du matériel de la clé. Toutefois, les autres détails tels que le nom et le numéro de version de la clé ne sont pas supprimés. Une fois qu'une clé est détruite, les données chiffrées avec cette clé ne sont plus accessibles.
Par défaut, lorsque vous envoyez une requête pour détruire une version de clé, la destruction est effectuée au bout de 24 heures. Vous pouvez annuler la requête de destruction en restaurant la version de clé.
La clé reste à l'état Destruction programmée pendant 24 heures. Vous pouvez modifier cette durée par défaut au moment de la création de la clé.
Vous pouvez également gérer l'accès à la clé à l'aide d'Identity and Access Management (IAM). Les opérations IAM sont cohérentes en quelques secondes. Pour en savoir plus, consultez la page Utiliser Cloud IAM.
Vous pouvez également désactiver temporairement une version de clé.
Dans la suite de cette section, la destruction d'une clé est appelée "détruire la clé", même si sa destruction n'est pas immédiate.
Détruire une version de clé
Vous pouvez détruire une version de clé activée ou désactivée.
Console
Accédez à la page Gestion des clés dans la console.
Cliquez sur le nom du trousseau de clés contenant la clé dont vous souhaitez programmer la destruction de la version.
Cliquez sur la clé dont vous souhaitez programmer la destruction de la version.
Cochez l'option située à côté de la version de clé dont vous souhaitez programmer la destruction.
Cliquez sur Détruire dans l'en-tête.
Dans l'invite de confirmation, saisissez le nom de la clé, puis cliquez sur Programmer la destruction.
gcloud
Pour utiliser Cloud KMS dans la ligne de commande, commencez par installer ou mettre à niveau vers la dernière version de Google Cloud CLI.
gcloud kms keys versions destroy key-version \ --key key \ --keyring key-ring \ --location location
Remplacez key-version par la version de la clé à détruire. Remplacez key par le nom de la clé. Remplacez key-ring par le nom du trousseau de clés où se trouve la clé. Remplacez location par l'emplacement Cloud KMS du trousseau de clés.
Pour en savoir plus sur toutes les options et valeurs possibles, exécutez la commande avec l'option --help
.
C#
Pour exécuter ce code, commencez par configurer un environnement de développement C#, puis installez le SDK Cloud KMS pour C#.
Accéder
Pour exécuter ce code, commencez par configurer un environnement de développement Go, puis installez le SDK Cloud KMS pour Go.
Java
Pour exécuter ce code, commencez par configurer un environnement de développement Java et installez le SDK Cloud KMS pour Java.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js, puis installez le SDK Cloud KMS pour Node.js.
PHP
Pour exécuter ce code, commencez par en apprendre plus sur l'utilisation de PHP sur Google Cloud, puis installez le SDK Cloud KMS pour PHP.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python, puis installez le SDK Cloud KMS pour Python.
Ruby
Pour exécuter ce code, commencez par configurer un environnement de développement Ruby, puis installez le SDK Cloud KMS pour Ruby.
API
Ces exemples utilisent curl comme client HTTP pour démontrer l'utilisation de l'API. Pour en savoir plus sur le contrôle des accès, consultez la page Accéder à l'API Cloud KMS.
Détruisez une version de clé en appelant la méthode setIamPolicys.destroy.
curl "https://cloudkms.googleapis.com/v1/projects/project-id/locations/location-id/keyRings/key-ring-id/cryptoKeys/crypto-key-id/cryptoKeyVersions/version-id:destroy" \ --request "POST" \ --header "authorization: Bearer token"
Lorsque vous envoyez la requête de destruction, l'état de la version de clé devient Destruction programmée. Une fois la durée de destruction configurée de la clé écoulée, l'état de la version devient Détruit, ce qui signifie que la suppression logique du matériel de clé des systèmes actifs a démarré et que le client ne peut pas récupérer le matériel de clé. Le matériel de clé peut être conservé dans les systèmes Google pendant 45 jours au maximum à compter de la date de destruction prévue.
Pour recevoir une alerte lorsque la destruction d'une version de clé est programmée, consultez la page Utiliser Cloud Monitoring avec Cloud KMS.
Les versions de clé détruites ne sont pas des ressources facturées.
Restaurer une version de clé
Durant la période où l'état d'une version de clé est Destruction programmée, vous pouvez restaurer la version de clé en envoyant une requête de restauration.
Console
Accédez à la page Gestion des clés dans la console.
Cliquez sur le nom du trousseau de clés contenant la clé dont vous souhaitez restaurer la version.
Cliquez sur la clé dont vous souhaitez restaurer la version.
Cochez l'option située à côté de la version de clé que vous souhaitez restaurer.
Cliquez sur Restaurer dans l'en-tête.
Dans l'invite de confirmation, cliquez sur Restaurer.
gcloud
Pour utiliser Cloud KMS dans la ligne de commande, commencez par installer ou mettre à niveau vers la dernière version de Google Cloud CLI.
gcloud kms keys versions restore key-version \ --key key \ --keyring key-ring \ --location location
Remplacez key-version par la version de la clé à restaurer. Remplacez key par le nom de la clé. Remplacez key-ring par le nom du trousseau de clés où se trouve la clé. Remplacez location par l'emplacement Cloud KMS du trousseau de clés.
Pour en savoir plus sur toutes les options et valeurs possibles, exécutez la commande avec l'option --help
.
C#
Pour exécuter ce code, commencez par configurer un environnement de développement C#, puis installez le SDK Cloud KMS pour C#.
Accéder
Pour exécuter ce code, commencez par configurer un environnement de développement Go, puis installez le SDK Cloud KMS pour Go.
Java
Pour exécuter ce code, commencez par configurer un environnement de développement Java et installez le SDK Cloud KMS pour Java.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js, puis installez le SDK Cloud KMS pour Node.js.
PHP
Pour exécuter ce code, commencez par en apprendre plus sur l'utilisation de PHP sur Google Cloud, puis installez le SDK Cloud KMS pour PHP.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python, puis installez le SDK Cloud KMS pour Python.
Ruby
Pour exécuter ce code, commencez par configurer un environnement de développement Ruby, puis installez le SDK Cloud KMS pour Ruby.
API
Ces exemples utilisent curl comme client HTTP pour démontrer l'utilisation de l'API. Pour en savoir plus sur le contrôle des accès, consultez la page Accéder à l'API Cloud KMS.
Restaurez une version de clé en appelant la méthode setIamPolicys.restore.
curl "https://cloudkms.googleapis.com/v1/projects/project-id/locations/location-id/keyRings/key-ring-id/cryptoKeys/crypto-key-id/cryptoKeyVersions/version-id:restore" \ --request "POST" \ --header "authorization: Bearer token"
Une fois la requête de restauration terminée, l'état de la version de clé devient Désactivée. Vous devez activer la clé avant de pouvoir l'utiliser.
Autorisations IAM requises
Pour détruire une version de clé, l'appelant doit disposer de l'autorisation IAM cloudkms.cryptoKeyVersions.destroy
sur la clé, le trousseau, ou sur le projet, le dossier ou l'organisation.
Pour restaurer une version de clé, l'appelant doit disposer de l'autorisation cloudkms.cryptoKeyVersions.restore
.
Ces deux autorisations sont accordées au rôle d'administrateur Cloud KMS (roles/cloudkms.admin
).
Calendrier de suppression
Cloud KMS s'engage à supprimer le matériel de clé client de toute l'infrastructure Google dans les 45 jours suivant la date de destruction prévue. Cela inclut la suppression des données des systèmes actifs et des sauvegardes de centres de données. Les autres données client sont soumises au délai standard de suppression de Google Cloud de 180 jours.