Per impostazione predefinita, Cloud Scheduler cripta i contenuti inattivi dei clienti. Cloud Scheduler gestisce la crittografia per conto tuo senza che tu debba fare altro. Questa opzione è denominata Crittografia predefinita di Google.
Se vuoi controllare le tue chiavi di crittografia, puoi utilizzare le chiavi di crittografia gestite dal cliente (CMEK) in Cloud KMS con servizi integrati con CMEK, tra cui Cloud Scheduler. L'utilizzo delle chiavi Cloud KMS ti consente di controllare il livello di protezione, la località, la pianificazione della rotazione, le autorizzazioni di utilizzo e di accesso e i limiti crittografici. Con Cloud KMS puoi inoltre visualizzare gli audit log e controllare i cicli di vita delle chiavi. Invece di Google, sei tu ad avere la proprietà e la gestione delle chiavi di crittografia della chiave (KEK) simmetriche che proteggono i tuoi dati. Puoi controllare e gestire queste chiavi in Cloud KMS.
Dopo aver configurato le risorse con le CMEK, l'esperienza di accesso alle risorse Cloud Scheduler è simile all'utilizzo della crittografia predefinita di Google. Per saperne di più sulle opzioni di crittografia, consulta Chiavi di crittografia gestite dal cliente (CMEK).
Cosa è protetto con CMEK
Puoi specificare una chiave Cloud KMS per progetto Google Cloud e per regione Cloud Scheduler supportata. Questa chiave viene utilizzata per proteggere i seguenti dati nel progetto e nella regione:
- Job con un target di endpoint HTTP o HTTPS: il corpo della richiesta HTTP e le intestazioni del cliente.
- Job con un argomento Pub/Sub come target: il payload e gli attributi del messaggio Pub/Sub.
Prima di iniziare
Prima di utilizzare CMEK in Cloud Scheduler, completa i seguenti passaggi preliminari.
Aggiorna i componenti di
gcloud.gcloud components update
Accedi utilizzando il tuo account.
gcloud auth login
Abilita l'API Cloud KMS per il progetto che archivia le chiavi di crittografia:
gcloud services enable cloudkms.googleapis.com \ --project=KMS_PROJECT_ID
Sostituisci
KMS_PROJECT_IDcon l'ID del progetto in cui sono archiviate le tue chiavi Cloud KMS. Può trattarsi dello stesso progetto dei job Cloud Scheduler o di un progetto separato.Cloud KMS genera Cloud Audit Logs quando le chiavi vengono abilitate, disabilitate o utilizzate dalle risorse Cloud Scheduler per criptare e decriptare i dati.
Assicurati che il logging sia abilitato per l'API Cloud KMS nel tuo progetto e di aver deciso quali autorizzazioni e ruoli specifici per il logging si applicano al tuo caso d'uso. Per saperne di più, consulta Audit logging di Cloud KMS.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per configurare CMEK per Cloud Scheduler, chiedi all'amministratore di concederti i seguenti ruoli IAM:
-
Concedi al service agent l'accesso alla chiave:
Cloud KMS Admin (
roles/cloudkms.admin) sulla chiave, sulle chiavi automatizzate o sul progetto che contiene la chiave Cloud KMS -
Abilita o disabilita CMEK:
Amministratore Cloud Scheduler (
roles/cloudscheduler.admin) sul progetto Cloud Scheduler -
Visualizza la configurazione CMEK o lo stato di attività:
- Cloud Scheduler Viewer (
roles/cloudscheduler.viewer) sul progetto Cloud Scheduler - Cloud Scheduler Admin (
roles/cloudscheduler.admin) sul progetto Cloud Scheduler
- Cloud Scheduler Viewer (
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per configurare CMEK per Cloud Scheduler. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per configurare CMEK per Cloud Scheduler sono necessarie le seguenti autorizzazioni:
-
Concedi al service agent l'accesso alla chiave:
cloudkms.cryptoKeys.setIamPolicysulla chiave, sulle chiavi automatizzate o sul progetto che contiene la chiave Cloud KMS -
Abilita o disabilita CMEK:
cloudscheduler.cmekConfig.updatesul progetto Cloud Scheduler -
Visualizza la configurazione CMEK o lo stato dell'operazione:
-
cloudscheduler.cmekConfig.getsul progetto Cloud Scheduler -
cloudscheduler.operations.getsul progetto Cloud Scheduler
-
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Crea una chiave automatizzata e una chiave Cloud KMS
Puoi creare un nuovo set di chiavi automatizzate o utilizzarne uno esistente. All'interno delle chiavi automatizzate, puoi aggiungere una nuova chiave o utilizzarne una esistente. Ti consigliamo di utilizzare chiavi diverse per applicazioni, servizi o ambienti distinti.
Crea una chiave. La chiave deve utilizzare l'algoritmo crittografico simmetrico.
Concedi al service agent Cloud Scheduler l'accesso alla chiave
Devi concedere all'agente di servizio Cloud Scheduler il ruolo Identity and Access Management (IAM) Cloud KMS CryptoKey Encrypter/Decrypter in modo che possa accedere alla chiave Cloud KMS. Se di recente hai abilitato l'API Cloud Scheduler in un progetto e non hai ancora creato job, potresti dover prima creare l'agente di servizio eseguendo gcloud beta services identity create --service=cloudscheduler.googleapis.com --project=PROJECT_ID.
gcloud kms keys add-iam-policy-binding KEY_NAME \ --keyring=KEY_RING \ --location=LOCATION \ --project=KMS_PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudscheduler.iam.gserviceaccount.com \ --role=roles/cloudkms.cryptoKeyEncrypterDecrypter
Sostituisci quanto segue:
KEY_NAME: il nome della chiave, ad esempiomy-key.KEY_RING: il nome delle chiavi automatizzate, ad esempiomy-keyring.LOCATION: la posizione della chiave, ad esempious-central1.KMS_PROJECT_ID: l'ID del progetto in cui si trova la chiave Cloud KMS.PROJECT_NUMBER: il numero di progetto del tuo progetto Cloud Scheduler Google Cloud . Puoi trovare il numero di progetto nella pagina Benvenuto della console Google Cloud o eseguendo questo comando:export PROJECT=$(gcloud info --format='value(config.project)') gcloud projects describe ${PROJECT} --format="value(projectNumber)"
Se l'agente di servizio ha il ruolo roles/cloudkms.cryptoKeyEncrypterDecrypter, un job nel tuo progetto può criptare e decriptare i dati utilizzando la chiave CMEK. Se revochi questo ruolo o se disattivi o distruggi la chiave CMEK, non sarà possibile accedere ai dati. Consulta Rimuovi Cloud KMS in questo documento.
Abilita CMEK per una regione Cloud Scheduler
Specifica la chiave Cloud KMS da utilizzare per la crittografia dei dati in una regione di Cloud Scheduler utilizzando il comando gcloud scheduler cmek-config update:
gcloud scheduler cmek-config update \ --location=LOCATION \ --kms-key-name=KEY_NAME \ --kms-keyring=KEY_RING \ --kms-project=KMS_PROJECT_ID
Sostituisci quanto segue:
LOCATION: una regione Cloud Scheduler supportata.KEY_NAME: il nome della chiave, ad esempiomy-key.KEY_RING: il nome delle chiavi automatizzate, ad esempiomy-keyring.KMS_PROJECT_ID: l'ID del progetto in cui si trova la chiave Cloud KMS che vuoi utilizzare.
Tieni presente quanto segue:
- L'abilitazione, la modifica o la disabilitazione di una chiave CMEK in Cloud Scheduler viene eseguita in modo asincrono e restituisce un'operazione a lunga esecuzione (
projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID). Puoi verificare se l'aggiornamento è terminato eseguendo il comandogcloud scheduler operations describe. - Cloud Scheduler cripta i job nuovi e aggiornati nel progetto e nella regione protetti con la chiave abilitata. I job esistenti criptati in precedenza con una chiave precedente vengono criptati di nuovo con la nuova chiave.
- I job non protetti esistenti vengono criptati.
- La rotazione di una chiave in Cloud KMS non cripta automaticamente i job esistenti né passa i nuovi job nella regione alla nuova versione della chiave primaria. Per saperne di più, consulta Rotazione delle chiavi CMEK.
- Se disabiliti CMEK per una regione, i job esistenti vengono criptati utilizzando la crittografia predefinita di Google e i job successivi vengono creati senza crittografia CMEK. In questo documento, consulta Disabilita CMEK per una regione di Cloud Scheduler.
Verifica la configurazione di Cloud KMS
Verifica che CMEK sia abilitato recuperando la configurazione CMEK per una regione di Cloud Scheduler utilizzando il comando gcloud scheduler cmek-config describe:
gcloud scheduler cmek-config describe \ --location=LOCATION
L'output è simile al seguente:
kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME name: projects/PROJECT_ID/locations/LOCATION/cmekConfig
Il valore kmsKeyName è l'ID risorsa della chiave Cloud KMS utilizzata per proteggere i job nella regione.
Disattiva CMEK per una regione Cloud Scheduler
Puoi disabilitare CMEK per una regione di Cloud Scheduler in modo che tutti i job creati in quella regione vengano creati senza crittografia CMEK.
gcloud scheduler cmek-config update \ --location=LOCATION \ --clear-kms-key
In questo modo, CMEK viene disattivata per la regione specifica e i job successivi vengono creati senza crittografia CMEK. I job esistenti vengono criptati utilizzando la crittografia predefinita di Google.
Rimuovi Cloud KMS
Se vuoi revocare l'accesso ai dati per i tuoi job, puoi rimuovere Cloud KMS in uno dei seguenti modi:
Disattiva o elimina la versione della chiave di crittografia gestita dal cliente appropriata. Puoi verificare se una versione della chiave è in uso. La disattivazione di una versione della chiave CMEK sospende l'accesso a tutti i dati protetti da quella versione della chiave fino a quando la chiave non viene riattivata. La distruzione di una versione della chiave blocca definitivamente l'accesso e può causare la perdita non recuperabile dei dati. Entrambe le azioni influiscono solo sui job associati alla versione della chiave specifica.
Non puoi visualizzare le risorse protette dalla versione della chiave disattivata o distrutta. Le esecuzioni dei job attivi non vanno a buon fine e viene visualizzato un messaggio di errore corrispondente.
Revoca il ruolo IAM
roles/cloudkms.cryptoKeyEncrypterDecrypterdall'agente di servizio Cloud Scheduler. Ciò influisce su tutti i job nel progetto e nella regioneGoogle Cloud specifici che supportano la crittografia utilizzando CMEK. Non puoi creare nuovi job integrati con CMEK né visualizzare o elencare i job criptati con CMEK (anche se puoi comunque eliminarli). Le esecuzioni di job attive non vanno a buon fine e viene visualizzato un messaggio di errore corrispondente.
Sebbene nessuna di queste operazioni garantisca la revoca immediata dell'accesso, le modifiche IAM generalmente vengono applicate più rapidamente. Per saperne di più, consulta Coerenza delle risorse Cloud KMS e Propagazione della modifica di accesso.
Informazioni sui vincoli delle policy dell'organizzazione CMEK
Cloud Scheduler supporta i seguenti vincoli delle policy dell'organizzazione, che possono aiutarti ad applicare l'utilizzo di CMEK in un'organizzazione:
constraints/gcp.restrictNonCmekServices: utilizza questo vincolo per richiedere l'utilizzo delle CMEK per proteggere tutte le nuove risorse Cloud Scheduler in un'organizzazione, una cartella o un progetto.Se attiva, questa policy dell'organizzazione impedisce la creazione o l'aggiornamento delle risorse, a meno che non attivi prima una chiave Cloud KMS. Inoltre, non puoi disattivare CMEK per una regione di Cloud Scheduler.
constraints/gcp.restrictCmekCryptoKeyProjects: utilizza questo vincolo per assicurarti che le risorse Cloud Scheduler protette da CMEK utilizzino una chiave di un progetto approvato.Ad esempio, puoi specificare una regola simile alla seguente: "Per tutte le risorse Cloud Scheduler in
projects/my-company-data-project, la chiave Cloud KMS utilizzata in questo progetto deve provenire daprojects/my-company-central-keysOprojects/team-specific-keys".
Tieni presente quanto segue:
Dopo aver applicato una policy dell'organizzazione CMEK, puoi comunque accedere ai job esistenti che utilizzano la crittografia predefinita di Google. Tuttavia, non puoi aggiornarli a meno che non configuri prima una chiave Cloud KMS accettabile per la regione di Cloud Scheduler.
I job che hanno come target un'applicazione App Engine non sono soggetti alle policy dell'organizzazione CMEK. Ad esempio, se imposti il vincolo
constraints/gcp.restrictNonCmekServices, puoi comunque creare o aggiornare un job che ha come target un'applicazione App Engine.
Per saperne di più sulla configurazione delle policy dell'organizzazione, consulta Policy dell'organizzazione CMEK.
Risoluzione dei problemi
Potresti riscontrare errori durante l'utilizzo di Cloud KMS con Cloud Scheduler. La tabella seguente descrive i diversi problemi e come risolverli.
| Problema | Descrizione |
|---|---|
Autorizzazione cloudkms.cryptoKeyVersions.useToEncrypt negata |
La chiave Cloud KMS fornita non esiste o l'autorizzazione non è configurata correttamente. Soluzione:
|
| La versione della chiave non è abilitata |
La versione della chiave Cloud KMS fornita è stata disabilitata. Soluzione: riattiva la versione della chiave Cloud KMS. |
| La regione delle chiavi automatizzate non corrisponde alla risorsa da proteggere |
La regione del keyring Cloud KMS fornito è diversa dalla regione Cloud Scheduler protetta. Soluzione: utilizza un keyring Cloud KMS della stessa regione di Cloud Scheduler. Il keyring può trovarsi in un progetto diverso. Per saperne di più, consulta Località di Cloud KMS e Località di Cloud Scheduler. |
| Il progetto non è compatibile con CMEK in Cloud Scheduler |
L'abilitazione di CMEK non riesce e viene visualizzato un errore Soluzione:
|
Audit logging
Cloud KMS genera audit log quando le chiavi vengono abilitate, disabilitate o utilizzate dalle risorse Cloud Scheduler per criptare e decriptare i messaggi. Per saperne di più, consulta Audit logging di Cloud KMS.
Errori di Cloud EKM
Per risolvere i problemi che potresti riscontrare durante l'utilizzo di chiavi gestite esternamente tramite Cloud External Key Manager (Cloud EKM), consulta il riferimento agli errori di Cloud EKM.
Stato della chiave non disponibile
Se per qualche motivo Cloud KMS non è disponibile, Cloud Scheduler potrebbe non essere in grado di recuperare lo stato della chiave da Cloud KMS.
Se Cloud KMS non è disponibile quando è pianificata l'esecuzione di un job, Cloud Scheduler non può decriptare i dati del job o richiamare la destinazione del job.
Per gli errori temporanei di Cloud KMS (come UNAVAILABLE,
RESOURCE_EXHAUSTED o una chiave Cloud EKM non raggiungibile),
Cloud Scheduler riprova la decrittografia internamente con backoff esponenziale
e registra le voci di log CmekRetryFailure in Cloud Logging in
cloudscheduler.googleapis.com/cmek. Per gli errori non ritentabili, ad esempio un errore di autorizzazione o una chiave disabilitata o eliminata, la decrittografia non va a buon fine immediatamente senza richiamare la destinazione.
Quote di Cloud KMS
Quando utilizzi CMEK in Cloud Scheduler, i tuoi progetti possono consumare le quote di richieste di crittografia di Cloud KMS. Ad esempio, Cloud Scheduler può utilizzare queste quote durante l'esecuzione di job, la gestione delle richieste di gestione dei job o l'aggiornamento della configurazione CMEK. Cloud Scheduler riutilizza una chiave intermedia memorizzata nella cache per un massimo di cinque minuti per progetto e regione, in modo che le esecuzioni frequenti dei job non consumino quota. Le operazioni di crittografia e decriptazione che utilizzano chiavi CMEK influiscono sulle quote di Cloud KMS solo se utilizzi chiavi hardware (Cloud HSM) o esterne (Cloud EKM). Per saperne di più, consulta Quote di Cloud KMS.Prezzi
Questa integrazione non comporta costi aggiuntivi oltre alle operazioni con le chiavi Cloud KMS, che vengono fatturate al tuo progetto Google Cloud .
Le risorse di distribuzione sottostanti che utilizzano la tua chiave tramite concessioni di chiavi possono eseguire ulteriori operazioni Cloud KMS. Per stimare l'utilizzo di Cloud KMS per le operazioni dirette di Cloud Scheduler, tieni conto delle seguenti frequenze di operazioni di crittografia per progetto e regione:
- Esecuzioni di job: Cloud Scheduler riutilizza una chiave intermedia memorizzata nella cache per un massimo di cinque minuti per progetto e regione. I progetti con meno di un'esecuzione di job ogni cinque minuti eseguono circa un'operazione di decrittografia Cloud KMS per esecuzione. I progetti con esecuzioni più frequenti eseguono circa un'operazione di decrittografia ogni cinque minuti nella regione.
- Operazioni di gestione dei job: le richieste di creazione, aggiornamento, recupero, elenco, pausa o ripresa dei job con dati protetti utilizzano una chiave intermediaria memorizzata nella cache separata per un massimo di cinque minuti per progetto e regione.
- Aggiornamenti della configurazione CMEK: l'abilitazione o la modifica di una chiave CMEK con
cmek-configesegue operazioni aggiuntive sulla chiave Cloud KMS per convalidarla e criptare nuovamente i job protetti esistenti nella regione. La disattivazione di CMEK decripta i job protetti esistenti riportandoli alla crittografia predefinita di Google.
Per informazioni sui prezzi, consulta Prezzi di Cloud KMS.