Cette page explique comment utiliser des clés de chiffrement gérées par le client (CMEK) créées manuellement pour Spanner.
Pour en savoir plus sur les CMEK, consultez la présentation des clés de chiffrement gérées par le client (CMEK).
Créer une base de données compatible avec les CMEK
Créez une clé dans Cloud Key Management Service (Cloud KMS). Vous pouvez utiliser les types de clés suivants, qui ont différents niveaux de protection dans Spanner :
La clé doit se trouver au même emplacement que votre instance Spanner. Par exemple, si la configuration de votre instance Spanner se trouve dans
us-west1, l'emplacement de votre trousseau de clés Cloud KMS doit également êtreus-west1.Toutes les configurations d'instances multirégionales Spanner n'ont pas d'emplacement de trousseau de clés Cloud KMS correspondant. Pour les bases de données Spanner dans des configurations d'instances personnalisées, birégionales ou multirégionales, vous pouvez utiliser plusieurs clés Cloud KMS régionales (monorégionales) pour protéger votre base de données. Exemple :
- Si votre base de données Spanner se trouve dans la configuration d'instance multirégionale
nam14, vous pouvez créer des clés Cloud KMS dansus-east4,northamerica-northeast1etus-east1. - Si votre base de données se trouve dans une configuration d'instance personnalisée qui utilise
nam3comme configuration d'instance de base avec une instance répliquée en lecture seule supplémentaire dansus-central2, vous pouvez créer des clés Cloud KMS dansus-east4,us-east1,us-central1etus-central2.
Facultatif : Pour afficher la liste des emplacements des instances répliquées dans la configuration de votre instance Spanner, utilisez la commande
gcloud spanner instances get-locations:gcloud spanner instances get-locations <var>INSTANCE_ID</var>Pour en savoir plus, consultez les ressources suivantes :
- Si votre base de données Spanner se trouve dans la configuration d'instance multirégionale
Accordez à Spanner l'accès à la clé.
Dans Cloud Shell, créez et affichez l'agent de service, ou affichez-le si le compte existe déjà :
gcloud beta services identity create --service=spanner.googleapis.com \ --project=PROJECT_IDSi vous êtes invité à installer le composant gcloud Beta Commands, saisissez
Y. Après l'installation, la commande est automatiquement redémarrée.La commande
gcloud services identitycrée ou obtient l'agent de service que Spanner peut utiliser pour accéder à la clé Cloud KMS en votre nom.L'ID de compte de service se présente sous la forme d'une adresse e-mail :
Service identity created: service-xxx@gcp-sa-spanner.Attribuez le rôle Chiffreur/Déchiffreur de CryptoKeys Cloud KMS (
cloudkms.cryptoKeyEncrypterDecrypter) au compte de service pour chaque région (--location) de la configuration de votre instance Spanner. Pour ce faire, exécutez la commandegcloud kms keys add-iam-policybinding:gcloud kms keys add-iam-policy-binding KMS_KEY \ --location KMS_KEY_LOCATION \ --keyring KMS_KEY_RING \ --project=PROJECT_ID \ --member serviceAccount:service-xxx@gcp-sa-spanner. \ --role roles/cloudkms.cryptoKeyEncrypterDecrypterVoici un exemple de résultat :
Updated IAM policy for key [KMS_KEY]Si vous utilisez plusieurs clés Cloud KMS pour protéger votre base de données, exécutez la commande
gcloud kms keys add-iam-policybindingpour toutes vos clés.Ce rôle garantit que le compte de service est autorisé à chiffrer et à déchiffrer des données avec la clé Cloud KMS. Pour en savoir plus, consultez Autorisations et rôles Cloud KMS.
Créez la base de données et spécifiez votre clé Cloud KMS.
Console
Utilisez la console pour créer des bases de données dans des configurations d'instances régionales.
Dans la console Google Cloud , accédez à la page Instances.
Cliquez sur l'instance dans laquelle vous souhaitez créer une base de données.
Cliquez sur Créer une base de données et remplissez les champs obligatoires.
Cliquez sur Afficher les options de chiffrement.
Sélectionnez Clé Cloud KMS.
Sélectionnez une clé dans la liste déroulante.
La liste des clés est limitée au projet Google Cloud actuel. Pour utiliser une clé d'un autre projet Google Cloud , créez la base de données à l'aide de gcloud CLI au lieu de la consoleGoogle Cloud .
Une fois la base de données créée, vous pouvez vérifier qu'elle est compatible avec les CMEK en consultant la page Présentation de la base de données.

gcloud
Pour créer une base de données compatible avec CMEK dans une configuration d'instance régionale, personnalisée ou multirégionale, exécutez la commande gcloud spanner databases create :
gcloud spanner databases create DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--ddl="CREATE TABLE Users (Id INT64 NOT NULL, FirstName STRING(100) NOT NULL, LastName STRING(100) NOT NULL,) PRIMARY KEY (Id)" \
--kms-project=KMS_PROJECT_ID \
--kms-location=KMS_KEY_LOCATION \
--kms-keyring=KMS_KEYRING \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]Pour vérifier qu'une base de données est compatible avec les CMEK, exécutez la commande gcloud spanner databases describe :
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDLes bases de données compatibles avec les CMEK incluent un champ pour encryptionConfig, comme illustré dans l'exemple de résultat suivant :
encryptionConfig:
kmsKeyNames:projects/my-kms-project/locations/eur5/keyRings/my-kms-key-ring/cryptoKeys/my-kms-key
name: projects/my-spanner-project/instances/my-instance/databases/my-db
state: READY
Bibliothèques clientes
C#
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance régionale :
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance multirégionale :
C++
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance régionale :
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance multirégionale :
Go
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance régionale :
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance multirégionale :
Java
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance régionale :
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance multirégionale :
Node.js
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance régionale :
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance multirégionale :
PHP
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance régionale :
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance multirégionale :
Python
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance régionale :
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance multirégionale :
Ruby
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance régionale :
Pour créer une base de données compatible avec les CMEK dans une configuration d'instance multirégionale :
Modifier la configuration du chiffrement de la base de données
Vous pouvez modifier la configuration de chiffrement d'une base de données Spanner existante sans temps d'arrêt à l'aide de la gcloud CLI, de l'API REST ou de l'API RPC. Vous pouvez apporter les modifications de configuration de chiffrement suivantes à une base de données existante :
- Activez les CMEK sur une base de données qui utilise Google-owned and Google-managed encryption key.
- Modifier les clés Cloud KMS sur une base de données compatible avec les CMEK, y compris basculer entre une clé multirégionale et plusieurs clés régionales, ou remplacer une ou plusieurs clés régionales. Le remplacement d'une clé régionale rechiffre toutes les données de la base de données, et pas seulement celles de cette région.
- Supprimez la CMEK et rétablissez une base de données sur Google-owned and Google-managed encryption key.
Pendant le rechiffrement en arrière-plan, un petit nombre de transactions peut échouer avec une erreur ABORTED pouvant être relancée. Les bibliothèques clientes Spanner relancent automatiquement ces transactions. Si vous utilisez directement l'API REST ou RPC, relancez ces transactions dans votre application.
Le passage d'une clé multirégionale unique à plusieurs clés régionales modifie le comportement de la révocation des clés. La désactivation d'une seule clé ou de toutes les clés régionales à la fois rend généralement la base de données inaccessible en moins d'une heure. Si vous ne désactivez qu'un sous-ensemble de clés régionales, la base de données peut mettre jusqu'à 24 heures à devenir inaccessible. Pour en savoir plus, consultez Désactiver la clé.
Activer CMEK ou modifier les clés Cloud KMS
Pour activer les CMEK sur une base de données existante ou modifier les clés Cloud KMS sur une base de données compatible avec les CMEK, procédez comme suit :
Créez votre ou vos clés Cloud KMS cibles dans les emplacements requis, puis attribuez le rôle Chiffreur/Déchiffreur de CryptoKeys Cloud KMS (
roles/cloudkms.cryptoKeyEncrypterDecrypter) sur chaque clé cible à l'agent de service Spanner de votre projet, comme décrit aux étapes 1 et 2 de la section Créer une base de données compatible avec CMEK.Mettez à jour la configuration de chiffrement de la base de données :
gcloud
Exécutez la commande
gcloud spanner databases updateet spécifiez les noms complets des ressources de vos clés Cloud KMS cibles à l'aide de l'option--kms-keys.Pour une clé régionale ou multirégionale :
gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --kms-keys="projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KMS_KEY"Pour plusieurs clés régionales dans une configuration d'instance personnalisée, birégionale ou multirégionale, spécifiez une liste d'éléments séparés par une virgule contenant l'ensemble complet des noms de ressources de clé Cloud KMS requis pour toutes les régions de votre configuration d'instance, même si vous ne remplacez qu'un sous-ensemble des clés :
gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --kms-keys="projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_1/keyRings/KMS_KEY_RING_1/cryptoKeys/KMS_KEY_1,projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_2/keyRings/KMS_KEY_RING_2/cryptoKeys/KMS_KEY_2,projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_3/keyRings/KMS_KEY_RING_3/cryptoKeys/KMS_KEY_3"REST
Appelez la méthode
projects.instances.databases.patchavecupdateMask=encryption_configet spécifiez votreencryptionConfigcible.Pour une clé régionale ou multirégionale :
PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": { "kmsKeyNames": [ "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KMS_KEY" ] } }Pour plusieurs clés régionales dans une configuration d'instance personnalisée, birégionale ou multirégionale, spécifiez un tableau contenant l'ensemble complet des noms de ressources de clé Cloud KMS requis pour toutes les régions de votre configuration d'instance, même si vous ne remplacez qu'un sous-ensemble des clés :
PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": { "kmsKeyNames": [ "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_1/keyRings/KMS_KEY_RING_1/cryptoKeys/KMS_KEY_1", "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_2/keyRings/KMS_KEY_RING_2/cryptoKeys/KMS_KEY_2", "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_3/keyRings/KMS_KEY_RING_3/cryptoKeys/KMS_KEY_3" ] } }Attendez que le rechiffrement en arrière-plan soit terminé avant de modifier à nouveau la configuration de chiffrement de la base de données, ou avant de désactiver, de révoquer ou de détruire les clés Cloud KMS précédentes. Conservez également les clés si vous en avez besoin pour restaurer des sauvegardes. Pour déterminer si le rechiffrement en arrière-plan est terminé, consultez Vérifier l'achèvement du rechiffrement en arrière-plan.
Rétablir une base de données à Google-owned and Google-managed encryption key
Pour supprimer la CMEK d'une base de données existante et la rétablir surGoogle-owned and Google-managed encryption key, procédez comme suit :
Mettez à jour la configuration de chiffrement de la base de données pour effacer ses clés Cloud KMS :
gcloud
Exécutez la commande
gcloud spanner databases updateavec l'option--clear-kms-keys:gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --clear-kms-keysREST
Appelez la méthode
projects.instances.databases.patchavecupdateMask=encryption_configet unencryptionConfigvide :PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": {} }Attendez que le rechiffrement en arrière-plan soit terminé avant de modifier à nouveau la configuration de chiffrement de la base de données, ou avant de désactiver, de révoquer ou de détruire les clés Cloud KMS précédentes. Conservez également les clés si vous en avez besoin pour restaurer des sauvegardes. Pour déterminer si le rechiffrement en arrière-plan est terminé, consultez Vérifier l'achèvement du rechiffrement en arrière-plan.
Vérifier que le rechiffrement en arrière-plan est terminé
L'opération de mise à jour de la base de données se termine lorsque la nouvelle encryptionConfig est enregistrée, tandis que Spanner rechiffre les données de la base de données existante de manière asynchrone en arrière-plan. Le rechiffrement en arrière-plan peut prendre plusieurs heures. La modification ou la suppression de clés prend plus de temps que l'ajout de CMEK, et les bases de données plus volumineuses peuvent prendre plus de temps.
Pour vérifier l'état du rechiffrement en arrière-plan, exécutez la commande gcloud spanner databases describe :
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--format="yaml(encryptionConfig,encryptionInfo)"Utilisez la sortie encryptionInfo pour déterminer si le rechiffrement en arrière-plan est terminé :
- Modification des clés Cloud KMS : pendant que le rechiffrement en arrière-plan est en cours,
encryptionInfoliste les versions de clé Cloud KMS précédentes et mises à jour. Le rechiffrement est terminé lorsqueencryptionInfone liste que les versions de clé appartenant aux clés cibles dansencryptionConfig. Pour les bases de données comportant plusieurs clés régionales, les versions de clé précédentes quittentencryptionInfoune région à la fois. Attendez donc qu'aucune entrée ne fasse référence à une version de clé précédente. - Retour à Google-owned and Google-managed encryption key : pendant que le rechiffrement en arrière-plan est en cours,
encryptionInfocontinue de lister les versions précédentes de la clé Cloud KMS. Le rechiffrement est terminé lorsqueencryptionInfone liste plus aucune entréeCUSTOMER_MANAGED_ENCRYPTION. - Activation des CMEK sur une base de données qui utilisait Google-owned and Google-managed encryption key :
encryptionInfopeut être vide pendant quelques minutes après la modification. Il répertorie ensuite les nouvelles versions de clés Cloud KMS après leur utilisation, qui peuvent apparaître avant que toutes les données préexistantes protégées parGoogle-owned and Google-managed encryption key n'aient fini d'être rechiffrées en arrière-plan.encryptionInfon'indique pas quand le rechiffrement des données préexistantes se termine.
Afficher les versions de clé utilisées
Le champ encryption_info de la base de données affiche des informations sur les versions de clé.
Lorsqu'une version de clé est alternée dans Cloud KMS, encryption_info est mis à jour une fois que la nouvelle version est utilisée. Lorsque vous modifiez la configuration de chiffrement de la base de données, encryption_info liste les versions de clé toujours utilisées, qui peuvent inclure les versions de clé précédentes, jusqu'à ce que le rechiffrement en arrière-plan soit terminé. Pour en savoir plus, consultez Vérifier la fin du rechiffrement en arrière-plan.
Console
Dans la console Google Cloud , accédez à la page Instances.
Cliquez sur l'instance contenant la base de données que vous souhaitez afficher.
Cliquez sur la base de données.
Les informations de chiffrement s'affichent sur la page Détails de la base de données.

gcloud
Vous pouvez obtenir le encryption_info d'une base de données en exécutant la commande gcloud spanner databases describe ou gcloud spanner databases list. Exemple :
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDVoici un exemple de résultat :
name: projects/my-project/instances/test-instance/databases/example-db
encryptionInfo:
- encryptionType: CUSTOMER_MANAGED_ENCRYPTION
kmsKeyVersion: projects/my-kms-project/locations/my-kms-key1-location/keyRings/my-kms-key-ring1/cryptoKeys/my-kms-key1/cryptoKeyVersions/1
- encryptionType: CUSTOMER_MANAGED_ENCRYPTION
kmsKeyVersion: projects/my-kms-project/locations/my-kms-key2-location/keyRings/my-kms-key-ring2/cryptoKeys/my-kms-key2/cryptoKeyVersions/1
Désactiver la clé
Désactivez la ou les versions de clé utilisées en suivant ces instructions pour chaque version de clé.
Attendez que la modification prenne effet. La désactivation d'une clé peut prendre jusqu'à trois heures pour se propager.
Pour vérifier que la base de données n'est plus accessible, exécutez une requête dans la base de données pour laquelle la CMEK est désactivée :
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'Le message d'erreur suivant s'affiche :
KMS key required by the Spanner resource is not accessible.
Activer la clé
Activez les versions de clé utilisées par la base de données en suivant ces instructions pour chaque version de clé.
Attendez que la modification prenne effet. La propagation de l'activation d'une clé peut prendre jusqu'à trois heures.
Pour confirmer que la base de données n'est plus accessible, exécutez une requête dans la base de données compatible avec les CMEK :
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'Si la modification a été prise en compte, la commande s'exécute correctement.
Sauvegarder une base de données
Vous pouvez utiliser les sauvegardes Spanner pour créer des sauvegardes de vos bases de données. Par défaut, les sauvegardes Spanner créées à partir d'une base de données utilisent la même configuration de chiffrement que la base de données elle-même. Vous pouvez éventuellement spécifier une configuration de chiffrement différente pour une sauvegarde.
Si une base de données utilise plusieurs clés Cloud KMS régionales, ses sauvegardes ne listent que les clés des régions qui stockent des données. La clé de la région témoin n'est pas listée, car les instances répliquées témoins ne stockent pas de données de sauvegarde.
Console
Utilisez la console pour créer des sauvegardes dans des configurations d'instances régionales.
Dans la console Google Cloud , accédez à la page Instances.
Cliquez sur le nom de l'instance contenant la base de données que vous souhaitez sauvegarder.
Cliquez sur la base de données.
Dans le volet de navigation, cliquez sur Sauvegarder/Restaurer.
Dans l'onglet Sauvegardes, cliquez sur Créer une sauvegarde.
Saisissez un nom de sauvegarde et sélectionnez une date d'expiration.
Facultatif : Cliquez sur Afficher les options de chiffrement.
a. Si vous souhaitez utiliser une autre configuration de chiffrement pour votre sauvegarde, cliquez sur le curseur à côté de Utiliser le chiffrement existant.
a. Sélectionnez Clé Cloud KMS.
a. Sélectionnez une clé dans la liste déroulante.
La liste des clés est limitée au projet Google Cloud actuel. Pour utiliser une clé d'un autre projet Google Cloud , créez la base de données à l'aide de gcloud CLI au lieu de la console Google Cloud .
Cliquez sur Créer.
Le tableau Sauvegardes affiche les informations de chiffrement pour chaque sauvegarde.

gcloud
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance régionale, personnalisée ou multirégionale, exécutez la commande gcloud spanner backups create :
gcloud spanner backups create BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--database=DATABASE \
--retention-period=RETENTION_PERIOD \
--encryption-type=customer_managed_encryption \
--kms-project=KMS_PROJECT_ID \
--kms-location=KMS_KEY_LOCATION \
--kms-keyring=KMS_KEY_RING \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]
--asyncPour vérifier que la sauvegarde créée est chiffrée par CMEK :
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDBibliothèques clientes
C#
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance régionale :
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance multirégionale :
C++
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance régionale :
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance multirégionale :
Go
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance régionale :
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance multirégionale :
Java
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance régionale :
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance multirégionale :
Node.js
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance régionale :
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance multirégionale :
PHP
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance régionale :
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance multirégionale :
Python
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance régionale :
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance multirégionale :
Ruby
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance régionale :
Pour créer une sauvegarde compatible avec CMEK dans une configuration d'instance multirégionale :
Copier une sauvegarde
Vous pouvez copier une sauvegarde de votre base de données Spanner d'une instance vers une autre instance dans une région ou un projet différents. Par défaut, une sauvegarde copiée utilise la même configuration de chiffrement (gérée par Google ou par le client) que la sauvegarde source. Vous pouvez ignorer ce comportement en spécifiant une autre configuration de chiffrement lors de la copie de la sauvegarde. Si vous souhaitez que la sauvegarde copiée soit chiffrée avec une CMEK lors de la copie entre régions, spécifiez les clés Cloud KMS correspondant aux régions de destination.
Console
Utilisez la console pour copier une sauvegarde dans une configuration d'instance régionale.
Dans la console Google Cloud , accédez à la page Instances.
Cliquez sur le nom de l'instance contenant la base de données que vous souhaitez sauvegarder.
Cliquez sur la base de données.
Dans le volet de navigation, cliquez sur Sauvegarder/Restaurer.
Dans le tableau Sauvegardes, sélectionnez Actions pour votre sauvegarde, puis cliquez sur Copier.
Remplissez le formulaire en choisissant une instance de destination, en indiquant un nom et en sélectionnant une date d'expiration pour la copie de sauvegarde.
Facultatif : Si vous souhaitez utiliser une autre configuration de chiffrement pour votre sauvegarde, cliquez sur Afficher les options de chiffrement.
a. Sélectionnez Clé Cloud KMS.
a. Sélectionnez une clé dans la liste déroulante.
La liste des clés est limitée au projet Google Cloud actuel. Pour utiliser une clé d'un autre projet Google Cloud , créez la base de données à l'aide de gcloud CLI au lieu de la console Google Cloud .
Cliquez sur Copier.
gcloud
Pour copier une sauvegarde, avec une nouvelle configuration de chiffrement, vers une autre instance du même projet, exécutez la commande gcloud spanner backups copy suivante :
gcloud spanner backups copy --async \
--source-instance=INSTANCE_ID \
--source-backup=SOURCE_BACKUP_NAME \
--destination-instance=DESTINATION_INSTANCE_ID \
--destination-backup=DESTINATION_BACKUP_NAME \
--expiration-date=EXPIRATION_DATE \
--encryption-type=CUSTOMER_MANAGED_ENCRYPTION \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]Pour copier une sauvegarde, avec une nouvelle configuration de chiffrement, vers une autre instance d'un autre projet, exécutez la commande gcloud spanner backups copy suivante :
gcloud spanner backups copy --async \
--source-backup=SOURCE_BACKUP_NAME \
--destination-backup=DESTINATION_BACKUP_NAME \
--encryption-type=CUSTOMER_MANAGED_ENCRYPTION \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]Pour vérifier que la sauvegarde copiée est chiffrée par CMEK :
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDBibliothèques clientes
C#
Pour copier une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
C++
Pour copier une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Go
Pour copier une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Java
Pour copier une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Node.js
Pour copier une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
PHP
Pour copier une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Python
Pour copier une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Ruby
Pour copier une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Restaurer à partir d'une sauvegarde
Vous pouvez restaurer une sauvegarde d'une base de données Spanner dans une nouvelle base de données. Par défaut, les bases de données restaurées à partir d'une sauvegarde utilisent la même configuration de chiffrement que la sauvegarde elle-même, mais vous pouvez remplacer ce comportement en spécifiant une configuration de chiffrement différente pour la base de données restaurée. Si la sauvegarde est protégée par une CMEK, la version de la clé utilisée pour créer la sauvegarde doit être disponible pour pouvoir être déchiffrée.
Console
Utilisez la console pour restaurer une sauvegarde dans une configuration d'instance régionale.
Dans la console Google Cloud , accédez à la page Instances.
Cliquez sur l'instance contenant la base de données que vous souhaitez restaurer.
Cliquez sur la base de données.
Dans le volet de navigation, cliquez sur Sauvegarder/Restaurer.
Dans le tableau Sauvegardes, sélectionnez Actions pour votre sauvegarde, puis cliquez sur Restaurer.
Sélectionnez l'instance à restaurer et nommez la base de données restaurée.
Facultatif : Si vous souhaitez utiliser une configuration de chiffrement différente avec votre base de données restaurée, cliquez sur le curseur à côté de Utiliser le chiffrement existant.
a. Sélectionnez Clé Cloud KMS.
a. Sélectionnez une clé dans la liste déroulante.
La liste des clés est limitée au projet Google Cloud actuel. Pour utiliser une clé d'un autre projet Google Cloud , créez la base de données à l'aide de gcloud CLI au lieu de la console Google Cloud .
Cliquez sur Restaurer.
gcloud
Pour restaurer une sauvegarde avec une nouvelle configuration de chiffrement, exécutez la commande gcloud spanner databases restore suivante :
gcloud spanner databases restore --async \
--project=SPANNER_PROJECT_ID \
--destination-instance=DESTINATION_INSTANCE_ID \
--destination-database=DESTINATION_DATABASE_ID \
--source-instance=SOURCE_INSTANCE_ID \
--source-backup=SOURCE_BACKUP_NAMEPour vérifier que la base de données restaurée est chiffrée avec CMEK :
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDPour en savoir plus, consultez Restaurer à partir d'une sauvegarde.
Bibliothèques clientes
C#
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance régionale :
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
C++
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance régionale :
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Go
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance régionale :
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Java
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance régionale :
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Node.js
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance régionale :
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
PHP
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance régionale :
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Python
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance régionale :
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Ruby
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance régionale :
Pour restaurer une sauvegarde protégée par CMEK dans une configuration d'instance multirégionale :
Afficher les journaux d'audit de la clé Cloud KMS
Assurez-vous de l'activation de la journalisation pour l'API Cloud KMS dans votre projet.
Dans la console Google Cloud , accédez à l'explorateur de journaux.
Limitez les entrées de journal à votre clé Cloud KMS en ajoutant les lignes suivantes au générateur de requêtes :
resource.type="cloudkms_cryptokey" resource.labels.location="KMS_KEY_LOCATION" resource.labels.key_ring_id="KMS_KEY_RING_ID" resource.labels.crypto_key_id="KMS_KEY_ID"En situation normale, les actions de chiffrement et de déchiffrement sont consignées avec le niveau de gravité
INFO. Ces entrées sont consignées, car les zones de votre instance Spanner interrogent la clé Cloud KMS toutes les cinq minutes environ.Si Spanner ne parvient pas à accéder à la clé, les opérations sont consignées en tant que
ERROR.