Questa pagina descrive come utilizzare le chiavi di crittografia gestite dal cliente (CMEK) create manualmente per Spanner.
Per scoprire di più su CMEK, consulta la panoramica delle chiavi di crittografia gestite dal cliente (CMEK).
Crea un database abilitato per CMEK
Crea una chiave in Cloud Key Management Service (Cloud KMS). In Spanner puoi utilizzare i seguenti tipi di chiavi con diversi livelli di protezione:
La chiave deve trovarsi nella stessa località dell'istanza Spanner. Ad esempio, se la configurazione dell'istanza Spanner si trova in
us-west1, anche la località delle chiavi automatizzate di Cloud KMS deve essereus-west1.Non tutte le configurazioni di istanze multiregionali di Spanner hanno una località di chiavi automatizzate Cloud KMS corrispondente. Per i database Spanner in configurazioni di istanze personalizzate, a due regioni o multiregionali, puoi utilizzare più chiavi Cloud KMS regionali (a regione singola) per proteggere il database. Ad esempio:
- Se il tuo database Spanner si trova nella configurazione di istanza multiregionale
nam14, puoi creare chiavi Cloud KMS inus-east4,northamerica-northeast1eus-east1. - Se il tuo database si trova in una configurazione di istanza personalizzata che utilizza
nam3come configurazione di istanza di base con una replica di sola lettura aggiuntiva inus-central2, puoi creare chiavi Cloud KMS inus-east4,us-east1,us-central1eus-central2.
(Facoltativo) Per visualizzare un elenco delle località delle repliche nella configurazione dell'istanza Spanner, utilizza il comando
gcloud spanner instances get-locations:gcloud spanner instances get-locations <var>INSTANCE_ID</var>Per maggiori informazioni, consulta le seguenti risorse:
- Se il tuo database Spanner si trova nella configurazione di istanza multiregionale
Concedi a Spanner l'accesso alla chiave.
In Cloud Shell, crea e visualizza l'agente di servizio o visualizzalo se l'account esiste già:
gcloud beta services identity create --service=spanner.googleapis.com \ --project=PROJECT_IDSe ti viene chiesto di installare il componente gcloud Beta Commands, digita
Y. Dopo l'installazione, il comando viene riavviato automaticamente.Il comando
gcloud services identitycrea o recupera l'agente di servizio che Spanner può utilizzare per accedere alla chiave Cloud KMS per tuo conto.L'ID del account di servizio ha il formato di un indirizzo email:
Service identity created: service-xxx@gcp-sa-spanner.Concedi il ruolo Cloud KMS CryptoKey Encrypter/Decrypter (
cloudkms.cryptoKeyEncrypterDecrypter) al account di servizio per ogni regione (--location) nella configurazione dell'istanza Spanner. Per farlo, esegui il comandogcloud 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.cryptoKeyEncrypterDecrypterEcco un esempio di output:
Updated IAM policy for key [KMS_KEY]Se utilizzi più chiavi Cloud KMS per proteggere il tuo database, esegui il comando
gcloud kms keys add-iam-policybindingper tutte le tue chiavi.Questo ruolo garantisce che il account di servizio disponga dell'autorizzazione per criptare e decriptare con la chiave Cloud KMS. Per saperne di più, consulta Ruoli e autorizzazioni di Cloud KMS.
Crea il database e specifica la chiave Cloud KMS.
Console
Utilizza la console per creare database nelle configurazioni di istanze regionali.
Nella console Google Cloud , vai alla pagina Istanze.
Fai clic sull'istanza in cui vuoi creare un database.
Fai clic su Crea database e compila i campi obbligatori.
Fai clic su Mostra opzioni di crittografia.
Seleziona Chiave Cloud KMS.
Seleziona una chiave dall'elenco a discesa.
L'elenco delle chiavi è limitato al progetto Google Cloud corrente. Per utilizzare una chiave di un progetto Google Cloud diverso, crea il database utilizzando gcloud CLI anziché la consoleGoogle Cloud .
Una volta creato il database, puoi verificare che sia abilitato per CMEK visualizzando la pagina Panoramica del database.

gcloud
Per creare un database abilitato per CMEK in una configurazione di istanza regionale, personalizzata o multiregionale, esegui il comando 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 ... ]Per verificare che un database sia abilitato per CMEK, esegui il comando gcloud spanner databases describe:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDI database abilitati per CMEK includono un campo per encryptionConfig, come mostrato nell'output di esempio seguente:
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
Librerie client
C#
Per creare un database abilitato per CMEK in una configurazione di istanza regionale:
Per creare un database abilitato per CMEK in una configurazione di istanza multiregionale:
C++
Per creare un database abilitato per CMEK in una configurazione di istanza regionale:
Per creare un database abilitato per CMEK in una configurazione di istanza multiregionale:
Vai
Per creare un database abilitato per CMEK in una configurazione di istanza regionale:
Per creare un database abilitato per CMEK in una configurazione di istanza multiregionale:
Java
Per creare un database abilitato per CMEK in una configurazione di istanza regionale:
Per creare un database abilitato per CMEK in una configurazione di istanza multiregionale:
Node.js
Per creare un database abilitato per CMEK in una configurazione di istanza regionale:
Per creare un database abilitato per CMEK in una configurazione di istanza multiregionale:
PHP
Per creare un database abilitato per CMEK in una configurazione di istanza regionale:
Per creare un database abilitato per CMEK in una configurazione di istanza multiregionale:
Python
Per creare un database abilitato per CMEK in una configurazione di istanza regionale:
Per creare un database abilitato per CMEK in una configurazione di istanza multiregionale:
Ruby
Per creare un database abilitato per CMEK in una configurazione di istanza regionale:
Per creare un database abilitato per CMEK in una configurazione di istanza multiregionale:
Modifica la configurazione della crittografia del database
Puoi modificare la configurazione di crittografia di un database Spanner esistente in loco senza tempi di inattività utilizzando gcloud CLI, l'API REST o l'API RPC. Puoi apportare le seguenti modifiche alla configurazione della crittografia su un database esistente:
- Attiva CMEK su un database che utilizza Google-owned and Google-managed encryption key.
- Modificare le chiavi Cloud KMS su un database abilitato per CMEK, tra cui passare da una chiave multiregionale a più chiavi regionali o sostituire una o più chiavi regionali. La sostituzione di una chiave regionale comporta la nuova crittografia di tutti i dati del database, non solo di quelli presenti in quella regione.
- Rimuovi CMEK e ripristina un database in Google-owned and Google-managed encryption key.
Durante la nuova crittografia in background, un numero ridotto di transazioni potrebbe non riuscire con un errore ABORTED ripetibile. Le librerie client di Spanner riprovano automaticamente queste transazioni. Se utilizzi direttamente l'API REST o RPC, riprova queste transazioni nella tua applicazione.
Il passaggio da una singola chiave multiregionale a più chiavi regionali modifica il comportamento della revoca delle chiavi. La disattivazione di una singola chiave o di tutte le chiavi regionali contemporaneamente rende in genere il database inaccessibile entro un'ora. Se disattivi solo un sottoinsieme di chiavi regionali, potrebbero essere necessarie fino a 24 ore prima che il database diventi inaccessibile. Per saperne di più, consulta Disabilita la chiave.
Abilita CMEK o modifica le chiavi Cloud KMS
Per abilitare CMEK su un database esistente o modificare le chiavi Cloud KMS su un database abilitato per CMEK, completa i seguenti passaggi:
Crea la chiave o le chiavi Cloud KMS di destinazione nelle località richieste e concedi il ruolo Cloud KMS CryptoKey Encrypter/Decrypter (
roles/cloudkms.cryptoKeyEncrypterDecrypter) su ogni chiave di destinazione all'agente di servizio Spanner del tuo progetto, come descritto nei passaggi 1 e 2 di Crea un database abilitato per CMEK.Aggiorna la configurazione di crittografia del database:
gcloud
Esegui il comando
gcloud spanner databases updatee specifica i nomi completi delle risorse delle chiavi Cloud KMS di destinazione utilizzando il flag--kms-keys.Per una chiave a regione singola o multiregionale:
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"Per più chiavi regionali in una configurazione di istanza personalizzata, a due regioni o multiregionale, specifica un elenco separato da virgole contenente l'insieme completo dei nomi delle risorse delle chiavi Cloud KMS richieste per tutte le regioni nella configurazione dell'istanza, anche se stai sostituendo solo un sottoinsieme delle chiavi:
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
Chiama il metodo
projects.instances.databases.patchconupdateMask=encryption_confige specifica ilencryptionConfigdi destinazione.Per una chiave a regione singola o multiregionale:
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" ] } }Per più chiavi regionali in una configurazione di istanza personalizzata, a due regioni o multiregionale, specifica un array contenente l'insieme completo dei nomi delle risorse delle chiavi Cloud KMS richieste per tutte le regioni nella configurazione dell'istanza, anche se stai sostituendo solo un sottoinsieme delle chiavi:
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" ] } }Attendi il completamento della nuova crittografia in background prima di modificare nuovamente la configurazione della crittografia del database o prima di disattivare, revocare o eliminare le chiavi Cloud KMS precedenti. Conserva le chiavi anche se potresti averne bisogno per il ripristino dai backup. Per determinare se la nuova crittografia in background è terminata, consulta Verifica il completamento della nuova crittografia in background.
Ripristina un database a Google-owned and Google-managed encryption key
Per rimuovere CMEK da un database esistente e ripristinare Google-owned and Google-managed encryption key, completa i seguenti passaggi:
Aggiorna la configurazione di crittografia del database per cancellare le relative chiavi Cloud KMS:
gcloud
Esegui il comando
gcloud spanner databases updatecon il flag--clear-kms-keys:gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --clear-kms-keysREST
Chiama il metodo
projects.instances.databases.patchconupdateMask=encryption_confige unencryptionConfigvuoto:PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": {} }Attendi il completamento della nuova crittografia in background prima di modificare nuovamente la configurazione della crittografia del database o prima di disattivare, revocare o eliminare le chiavi Cloud KMS precedenti. Conserva le chiavi anche se potresti averne bisogno per il ripristino dai backup. Per determinare se la nuova crittografia in background è terminata, consulta Verifica il completamento della nuova crittografia in background.
Verifica il completamento della nuova crittografia in background
L'operazione di aggiornamento del database viene completata quando viene salvata la nuova encryptionConfig, mentre Spanner cripta nuovamente i dati del database esistenti in modo asincrono in background. La nuova crittografia in background può richiedere diverse ore. La modifica o la rimozione delle chiavi richiede più tempo rispetto all'aggiunta di CMEK e i database più grandi possono richiedere più tempo.
Per controllare lo stato della nuova crittografia in background, esegui il comando gcloud spanner databases describe:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--format="yaml(encryptionConfig,encryptionInfo)"Utilizza l'output encryptionInfo per determinare se la nuova crittografia in background è completa:
- Modifica delle chiavi Cloud KMS: mentre è in corso la nuova crittografia in background,
encryptionInfoelenca sia le versioni precedenti sia quelle aggiornate delle chiavi Cloud KMS. La nuova crittografia è completa quandoencryptionInfoelenca solo le versioni delle chiavi che appartengono alle chiavi di destinazione inencryptionConfig. Per i database con più chiavi regionali, le versioni precedenti delle chiavi lascianoencryptionInfouna regione alla volta, quindi attendi finché nessuna voce fa riferimento a una versione precedente della chiave. - Ripristino di Google-owned and Google-managed encryption key: mentre è in corso la nuova crittografia in background,
encryptionInfocontinua a elencare le versioni precedenti della chiave Cloud KMS. La nuova crittografia è completa quandoencryptionInfonon elenca più vociCUSTOMER_MANAGED_ENCRYPTION. - Abilitazione di CMEK su un database che utilizzava Google-owned and Google-managed encryption key:
encryptionInfopotrebbe essere vuoto per alcuni minuti dopo la modifica. Quindi, elenca le nuove versioni delle chiavi Cloud KMS dopo che sono state utilizzate, il che potrebbe apparire prima che tutti i dati preesistenti protetti daGoogle-owned and Google-managed encryption key abbiano terminato la nuova crittografia in background.encryptionInfonon indica quando termina la nuova crittografia dei dati preesistenti.
Visualizza le versioni delle chiavi in uso
Il campo encryption_info del database mostra informazioni sulle versioni delle chiavi.
Quando una versione della chiave viene ruotata in Cloud KMS, encryption_info viene aggiornato una volta che la nuova versione è in uso. Quando modifichi la configurazione della crittografia del database, encryption_info elenca le versioni della chiave ancora in uso, che possono includere le versioni della chiave precedenti, fino al completamento della nuova crittografia in background. Per saperne di più, consulta Verifica il completamento della nuova crittografia in background.
Console
Nella console Google Cloud , vai alla pagina Istanze.
Fai clic sull'istanza contenente il database che vuoi visualizzare.
Fai clic sul database.
Le informazioni sulla crittografia vengono visualizzate nella pagina Dettagli database.

gcloud
Puoi ottenere il encryption_info di un database eseguendo il comando gcloud spanner databases describe o gcloud spanner databases list. Ad esempio:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDEcco un esempio di output:
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
Disabilita la chiave
Disabilita le versioni della chiave in uso seguendo queste istruzioni per ogni versione della chiave.
Attendi che la modifica diventi effettiva. La disattivazione di una chiave può richiedere fino a tre ore per la propagazione.
Per verificare che il database non sia più accessibile, esegui una query nel database con CMEK disabilitate:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'Viene visualizzato il seguente messaggio di errore:
KMS key required by the Spanner resource is not accessible.
Abilita la chiave
Attiva le versioni della chiave utilizzate dal database seguendo queste istruzioni per ogni versione della chiave.
Attendi che la modifica diventi effettiva. La propagazione dell'attivazione di una chiave può richiedere fino a tre ore.
Per verificare che il database non sia più accessibile, esegui una query nel database abilitato per CMEK:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'Se la modifica è stata applicata, il comando viene eseguito correttamente.
Esegui il backup di un database
Puoi utilizzare i backup di Spanner per creare backup dei tuoi database. Per impostazione predefinita, i backup di Spanner creati da un database utilizzano la stessa configurazione di crittografia del database stesso. Se vuoi, puoi specificare una configurazione di crittografia diversa per un backup.
Se un database utilizza più chiavi Cloud KMS regionali, i relativi backup elencano solo le chiavi per le regioni che archiviano i dati. La chiave della regione di controllo non è elencata perché le repliche di controllo non archiviano i dati di backup.
Console
Utilizza la console per creare backup nelle configurazioni di istanze regionali.
Nella console Google Cloud , vai alla pagina Istanze.
Fai clic sul nome dell'istanza che contiene il database di cui vuoi eseguire il backup.
Fai clic sul database.
Nel riquadro di navigazione, fai clic su Backup/Ripristino.
Nella scheda Backup, fai clic su Crea backup.
Inserisci un nome per il backup e seleziona una data di scadenza.
(Facoltativo) Fai clic su Mostra opzioni di crittografia.
a. Se vuoi utilizzare una configurazione di crittografia diversa per il backup, fai clic sul cursore accanto a Usa crittografia esistente.
a. Seleziona Chiave Cloud KMS.
a. Seleziona una chiave dall'elenco a discesa.
L'elenco delle chiavi è limitato al progetto Google Cloud corrente. Per utilizzare una chiave di un progetto Google Cloud diverso, crea il database utilizzando gcloud CLI anziché la console Google Cloud .
Fai clic su Crea.
La tabella Backup mostra le informazioni di crittografia per ogni backup.

gcloud
Per creare un backup abilitato per CMEK in una configurazione di istanza regionale, personalizzata o multiregionale, esegui il comando 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 ... ]
--asyncPer verificare che il backup creato sia criptato con CMEK:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDLibrerie client
C#
Per creare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per creare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
C++
Per creare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per creare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Vai
Per creare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per creare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Java
Per creare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per creare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Node.js
Per creare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per creare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
PHP
Per creare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per creare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Python
Per creare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per creare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Ruby
Per creare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per creare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Copia un backup
Puoi copiare un backup del tuo database Spanner da un'istanza a un'altra in una regione o un progetto diverso. Per impostazione predefinita, un backup copiato utilizza la stessa configurazione di crittografia, gestita da Google o dal cliente, della crittografia del backup di origine. Puoi sostituire questo comportamento specificando una configurazione di crittografia diversa durante la copia del backup. Se vuoi che il backup copiato venga criptato con CMEK durante la copia tra regioni, specifica le chiavi Cloud KMS corrispondenti alle regioni di destinazione.
Console
Utilizza la console per copiare un backup in una configurazione di istanza regionale.
Nella console Google Cloud , vai alla pagina Istanze.
Fai clic sul nome dell'istanza che contiene il database di cui vuoi eseguire il backup.
Fai clic sul database.
Nel riquadro di navigazione, fai clic su Backup/Ripristino.
Nella tabella Backup, seleziona Azioni per il backup e fai clic su Copia.
Compila il modulo scegliendo un'istanza di destinazione, specificando un nome e selezionando una data di scadenza per la copia di backup.
(Facoltativo) Se vuoi utilizzare una configurazione di crittografia diversa per il backup, fai clic su Mostra opzioni di crittografia.
a. Seleziona Chiave Cloud KMS.
a. Seleziona una chiave dall'elenco a discesa.
L'elenco delle chiavi è limitato al progetto Google Cloud corrente. Per utilizzare una chiave di un progetto Google Cloud diverso, crea il database utilizzando gcloud CLI anziché la console Google Cloud .
Fai clic su Copia.
gcloud
Per copiare un backup, con una nuova configurazione di crittografia, in un'altra istanza
dello stesso progetto, esegui questo comando gcloud spanner backups copy:
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 ... ]Per copiare un backup con una nuova configurazione di crittografia in un'istanza diversa in un progetto diverso, esegui il seguente comando gcloud spanner backups copy:
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 ... ]Per verificare che il backup copiato sia criptato con CMEK:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDLibrerie client
C#
Per copiare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
C++
Per copiare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Vai
Per copiare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Java
Per copiare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Node.js
Per copiare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
PHP
Per copiare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Python
Per copiare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Ruby
Per copiare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Ripristina da un backup
Puoi ripristinare un backup di un database Spanner in un nuovo database. Per impostazione predefinita, i database ripristinati da un backup utilizzano la stessa configurazione di crittografia del backup stesso, ma puoi sostituire questo comportamento specificando una configurazione di crittografia diversa per il database ripristinato. Se il backup è protetto da CMEK, la versione della chiave utilizzata per creare il backup deve essere disponibile in modo che possa essere decriptata.
Console
Utilizza la console per ripristinare un backup in una configurazione di istanza regionale.
Nella console Google Cloud , vai alla pagina Istanze.
Fai clic sull'istanza contenente il database che vuoi ripristinare.
Fai clic sul database.
Nel riquadro di navigazione, fai clic su Backup/Ripristino.
Nella tabella Backup, seleziona Azioni per il backup e fai clic su Ripristina.
Seleziona l'istanza da ripristinare e assegna un nome al database ripristinato.
(Facoltativo) Se vuoi utilizzare una configurazione di crittografia diversa con il database ripristinato, fai clic sul cursore accanto a Utilizza crittografia esistente.
a. Seleziona Chiave Cloud KMS.
a. Seleziona una chiave dall'elenco a discesa.
L'elenco delle chiavi è limitato al progetto Google Cloud corrente. Per utilizzare una chiave di un progetto Google Cloud diverso, crea il database utilizzando gcloud CLI anziché la console Google Cloud .
Fai clic su Ripristina.
gcloud
Per ripristinare un backup con una nuova configurazione di crittografia, esegui questo comando gcloud spanner databases restore:
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_NAMEPer verificare che il database ripristinato sia criptato con CMEK:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDPer saperne di più, consulta Ripristina da un backup.
Librerie client
C#
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
C++
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Vai
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Java
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Node.js
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
PHP
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Python
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Ruby
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza regionale:
Per ripristinare un backup abilitato per CMEK in una configurazione di istanza multiregionale:
Visualizza gli audit log per la chiave Cloud KMS
Assicurati che il logging sia abilitato per l'API Cloud KMS nel tuo progetto.
Nella console Google Cloud , vai a Esplora log.
Limita le voci di log alla chiave Cloud KMS aggiungendo le seguenti righe a Query Builder:
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"In condizioni operative normali, le azioni di crittografia e decriptazione vengono registrate con gravità
INFO. Queste voci vengono registrate quando le zone dell'istanza Spanner eseguono il polling della chiave Cloud KMS ogni cinque minuti circa.Se Spanner non riesce ad accedere alla chiave, le operazioni vengono registrate come
ERROR.