Risolvere gli errori relativi a CMEK e alle impostazioni predefinite

Questo documento descrive come trovare e mitigare gli errori comuni di configurazione di CMEK e come identificare gli errori che si verificano durante l'impostazione della posizione predefinita della risorsa.

Risolvere i problemi relativi all'impostazione della località della risorsa predefinita

Provi ad aggiornare la posizione di archiviazione predefinita per un'organizzazione o una cartella, ma il comando non riesce con un errore simile al seguente:

ERROR: (gcloud.logging.settings.update) INVALID_ARGUMENT: The KMS key location must match the storage location. Received KMS key location: us-central1, storage location: us-west1
- '@type': type.googleapis.com/google.rpc.DebugInfo
  detail: '[ORIGINAL ERROR] generic::invalid_argument: The KMS key location must match
    the storage location. Received KMS key location: us-central1, storage location:
    us-west1 [google.rpc.error_details_ext] { message: "The KMS key location must
    match the storage location. Received KMS key location: us-central1, storage location:
    us-west1" }'

Per risolvere questo errore, imposta la posizione di archiviazione predefinita per l'organizzazione o la cartella in modo che corrisponda alla posizione della chiave Cloud Key Management Service per l'organizzazione o la cartella.

Risolvere i problemi relativi ai Controlli di servizio VPC e alla condivisione limitata dei domini

Hai configurato CMEK come impostazione predefinita della risorsa per la tua organizzazione o per una cartella oppure hai creato un bucket di log con CMEK abilitato. Poi, configura i Controlli di servizio VPC. Dopo aver configurato i Controlli di servizio VPC, limita l'accesso a Cloud Key Management Service in Controlli di servizio VPC o abilita la condivisione limitata del dominio.

Si verifica almeno uno dei seguenti casi:

• Hai ricevuto una notifica da Cloud Logging relativa a problemi di accesso a CMEK.

• Noti che CMEK non è attivato per i bucket di log _Default e _Required quando crei nuovi progetti Google Cloud nella tua organizzazione o in una cartella.

• Ricevi errori quando leggi dai bucket dei log con CMEK abilitato. Gli errori visualizzati sono simili al seguente:

  ERROR: (gcloud.logging.read) FAILED_PRECONDITION: service account `cmek-PROJECT_IDgcp-sa-logging.iam.gserviceaccount.com` must have both encrypt and decrypt access to the CMEK KMS key `projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY`
  

• Ricevi errori quando crei o aggiorni bucket di log con CMEK abilitato. Gli errori visualizzati sono simili al seguente:

  ERROR: (gcloud.logging.buckets.create) service account `[e-mail]` must have both encrypt and decrypt access to the CMEK KMS key `projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY`
  - '@type': type.googleapis.com/google.rpc.DebugInfo
    detail: '[ORIGINAL ERROR] generic::permission_denied: Request is prohibited by
    organization's policy. vpcServiceControlsUniqueIdentifier: <var>ERRORID</var>;'
  

Per determinare se questi problemi sono dovuti alla configurazione di Controlli di servizio VPC, segui questi passaggi:

1. Identifica le impostazioni di Cloud Logging per la risorsa che contiene la configurazione CMEK. Una risorsa può essere un progetto, una cartella o un'organizzazione. Se hai creato bucket di log conCMEK abilitato, seleziona la risorsa PROGETTO.

   PROGETTO

   gcloud logging settings describe --project=PROJECT_ID
   

   Prima di eseguire il comando, sostituisci PROJECT_ID con l'ID progetto che contiene il bucket dei log.

   FOLDER

   gcloud logging settings describe --folder=FOLDER_ID
   

   Prima di eseguire il comando, sostituisci FOLDER_ID con l'ID della cartella.

   ORGANIZZAZIONE

   gcloud logging settings describe --organization=ORGANIZATION_ID
   

   Prima di eseguire il comando, sostituisci ORGANIZATION_ID con l'ID dell'organizzazione.

   Il comando precedente restituisce informazioni simili alle seguenti:

   kmsServiceAccountId: [e-mail]
   loggingServiceAccountId: [e-mail]
   

   Per le organizzazioni e le cartelle, viene restituito anche il seguente campo:

   kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY
   

   Il valore del campo kmsKeyName include il progetto Google Cloud che memorizza la chiave.

2. Determina se devi eseguire la migrazione degli account di servizio:

   • Se il valore del campo kmsServiceAccountId ha il prefisso service-, non è necessario eseguire la migrazione dell'account di servizio. Per informazioni sugli errori di configurazione CMEK, consulta la sezione Risolvere i problemi relativi a CMEK di questo documento.

   • Se il valore di kmsServiceAccountId ha il prefisso cmek-, vai al passaggio successivo.

3. Verifica di dover eseguire la migrazione degli account di servizio disattivando la condivisione con restrizioni del dominio o rimuovendo Cloud Key Management Service dall'elenco dei servizi con limitazioni di Controlli di servizio VPC.

   Se gli errori vengono risolti, per risolvere gli errori devi eseguire la migrazione delle risorse interessate a un nuovo account di servizio. Per informazioni su questi passaggi, consulta la sezione successiva.

Esegui la migrazione degli account di servizio CMEK

La procedura seguente descrive come modificare l'account di servizio utilizzato da Cloud Logging per accedere alle chiavi di Cloud Key Management Service configurate. La modifica dell'account di servizio risolve un problema noto con i Controlli di servizio VPC e la condivisione limitata dei domini.

1. Identifica loggingServiceAccountId per la tua risorsa. Una risorsa può essere un progetto, una cartella o un'organizzazione. Se hai creato bucket di log conCMEK abilitato, seleziona la risorsa PROGETTO.

   PROGETTO

   gcloud logging settings describe --project=PROJECT_ID
   

   Prima di eseguire il comando, sostituisci PROJECT_ID con l'ID progetto che contiene il bucket dei log.

   FOLDER

   gcloud logging settings describe --folder=FOLDER_ID
   

   Prima di eseguire il comando, sostituisci FOLDER_ID con l'ID della cartella.

   ORGANIZZAZIONE

   gcloud logging settings describe --organization=ORGANIZATION_ID
   

   Prima di eseguire il comando, sostituisci ORGANIZATION_ID con l'ID dell'organizzazione.

   Il comando precedente restituisce informazioni simili alle seguenti:

   kmsServiceAccountId: [e-mail]
   loggingServiceAccountId: [e-mail]
   

   Per le organizzazioni e le cartelle, viene restituito anche il seguente campo:

   kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY
   

   Il valore del campo kmsKeyName include il progetto Google Cloud che memorizza la chiave.

2. Se hai configurato un'impostazione predefinita per le risorse della tua organizzazione o per le cartelle, procedi nel seguente modo:

   1. In KMS_PROJECT_ID, concedi il ruolo Autore crittografia/decrittografia CryptoKey di Cloud Key Management Service all'account di servizio identificato dal campo loggingServiceAccountId.

   2. Esegui il seguente comando curl, che modifica l'account di servizio Cloud Key Management Service utilizzato dalla risorsa.

      PROGETTO

      Non applicabile.

      FOLDER

      curl -X PATCH -H "Authorization: Bearer \"$(gcloud auth print-access-token)\"" -H "Content-Type: application/json; charset=utf-8" -d '{"kmsServiceAccountId": "[e-mail]"}' https://logging.googleapis.com/v2/folders/FOLDER_ID/settings?updateMask=kmsServiceAccountId
      

      Prima di eseguire il comando, segui questi passaggi:

      • Sostituisci FOLDER_ID con l'ID della cartella.
      • Sostituisci SERVICE_ACCT_NAME con loggingServiceAccountId identificato in precedenza.

      ORGANIZZAZIONE

      curl -X PATCH -H "Authorization: Bearer \"$(gcloud auth print-access-token)\"" -H "Content-Type: application/json; charset=utf-8" -d '{"kmsServiceAccountId": "[e-mail]"}' https://logging.googleapis.com/v2/organizations/ORGANIZATION_ID/settings?updateMask=kmsServiceAccountId
      

      Prima di eseguire il comando, segui questi passaggi:

      • Sostituisci ORGANIZATION_ID con l'ID dell'organizzazione.
      • Sostituisci SERVICE_ACCT_NAME con loggingServiceAccountId identificato in precedenza.

      Il risultato del comando precedente è simile al seguente:

      {
        "name": ".../settings",
        "kmsKeyName": "projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY",
        "kmsServiceAccountId": "[e-mail]",
        "storageLocation": "...",
        "loggingServiceAccountId": "[e-mail]"
      }
      

   Nota: il nuovo account di servizio viene utilizzato per le nuove risorse create nell'organizzazione o nella cartella. L'account di servizio per le risorse esistenti non viene modificato.

3. Per ogni progetto o cartella Google Cloud contenente bucket di log esistenti attivati con CMEK, svolgi i seguenti passaggi:

   1. Nel progetto o nella cartella, per ogni bucket dei log abilitato con CMEK, esegui le seguenti operazioni:

      1. Identifica il progetto Google Cloud che memorizza la chiave di Cloud Key Management Service:

         PROGETTO

         gcloud logging buckets describe BUCKET_ID --location=LOCATION --project=PROJECT_ID
         

         Prima di eseguire il comando, segui questi passaggi:

         • Sostituisci PROJECT_ID con l'ID del progetto che contiene il bucket dei log.
         • Sostituisci LOCATION con la posizione del bucket dei log.

         FOLDER

         gcloud logging buckets describe BUCKET_ID --location=LOCATION --folder=FOLDER_ID
         

         Prima di eseguire il comando, segui questi passaggi:

         • Sostituisci FOLDER_ID con l'ID della cartella.
         • Sostituisci LOCATION con la posizione del bucket dei log.

         Il risultato del comando precedente è simile al seguente:

         cmekSettings:
           kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY
           kmsKeyVersionName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY/cryptoKeyVersions/1
           serviceAccountId: [e-mail]
         createTime: '2022-10-31T12:00:00.0000000Z'
         lifecycleState: ACTIVE
         name: projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID
         retentionDays: 30
         createTime: '2022-10-31T13:00:00.0000000Z'
         

      2. Vai al progetto Google Cloud proprietario della chiave Cloud Key Management Service, KMS_PROJECT_ID, e concedi il ruolo Autore crittografia/decrittografia CryptoKey Cloud Key Management Service all'account di servizio identificato dal campo loggingServiceAccountId.

   2. Per il progetto, esegui il seguente comando curl, che modifica l'account di servizio Cloud Key Management Service:

      PROGETTO

      curl -X PATCH -H "Authorization: Bearer \"$(gcloud auth print-access-token)\"" -H "Content-Type: application/json; charset=utf-8" -d '{"kmsServiceAccountId": "[e-mail]"}' https://logging.googleapis.com/v2/projects/PROJECT_ID/settings?updateMask=kmsServiceAccountId
      

      Prima di eseguire il comando, segui questi passaggi:

      • Sostituisci PROJECT_ID con l'ID del progetto che contiene il bucket dei log.
      • Sostituisci SERVICE_ACCT_NAME con loggingServiceAccountId identificato in precedenza.

      FOLDER

      Non è richiesta alcuna azione, poiché hai modificato l'account di servizio Cloud Key Management Service utilizzato dalla cartella in un passaggio precedente.

      Il risultato del comando precedente è simile al seguente:

      {
        "name": ".../settings",
        "kmsServiceAccountId": "[e-mail]",
        "loggingServiceAccountId": "[e-mail]"
      }
      

4. Per ogni bucket dei log con CMEK abilitato:

   1. Ruota la chiave Cloud KMS.

   2. Conferma la migrazione. La risorsa principale per il bucket dei log determina il comando Google Cloud CLI da eseguire. L'elemento principale può essere un progetto, una cartella o un'organizzazione.

      PROGETTO

      gcloud logging buckets describe BUCKET_ID --location=LOCATION --project=PROJECT_ID
      

      Prima di eseguire il comando, segui questi passaggi:

      • Sostituisci PROJECT_ID con l'ID del progetto che contiene il bucket dei log.
      • Sostituisci LOCATION con la posizione del bucket dei log.

      FOLDER

      gcloud logging buckets describe BUCKET_ID --location=LOCATION --folder=FOLDER_ID
      

      Prima di eseguire il comando, segui questi passaggi:

      • Sostituisci FOLDER_ID con l'ID della cartella.
      • Sostituisci LOCATION con la posizione del bucket dei log.

      Per un progetto, il risultato del comando precedente è simile al seguente:

      cmekSettings:
        kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY
        kmsKeyVersionName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY/cryptoKeyVersions/1
        serviceAccountId: [e-mail]
      createTime: '2022-10-31T12:00:00.0000000Z'
      lifecycleState: ACTIVE
      name: projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID
      retentionDays: 30
      createTime: '2022-10-31T13:00:00.0000000Z'
      

      Assicurati che serviceAccountId corrisponda a loggingServiceAccountId identificato in precedenza.

5. Attendi almeno 30 minuti prima di revocare le autorizzazioni nell'account servizio precedente. Se riscontri problemi dopo aver revocato le autorizzazioni nell'account di servizio precedente, ripristinale e contatta l'assistenza Cloud.

Risolvere i problemi relativi a CMEK

Durante la configurazione di CMEK, al progetto Google Cloud contenente la chiave Cloud KMS vengono inviati avvisi relativi ai problemi correlati. Ad esempio, gli aggiornamenti non vanno a buon fine quando KMS_KEY_NAME non è valido, quando l'account di servizio associato non dispone del ruolo obbligatorio Autore crittografia/decrittografia CryptoKey Cloud Key Management Service o quando l'accesso alla chiave è disattivato.

Dopo aver configurato CMEK, si verifica almeno una delle seguenti condizioni:

• Hai ricevuto una notifica da Cloud Logging relativa a problemi di accesso a CMEK.

• Noti che CMEK non è attivato per i bucket di log _Default e _Required quando crei nuovi progetti Google Cloud nella tua organizzazione o in una cartella.

• Ricevi errori quando leggi dai bucket di log con CMEK abilitato o se provi a creare o aggiornare i bucket di log.

La notifica fornisce informazioni sull'errore e contiene i passaggi che puoi svolgere per attenuare il problema:

Errore	Consiglio
Autorizzazione alla chiave di crittografia negata	L'account di servizio Logging associato al tuo progetto Google Cloud non dispone delle autorizzazioni IAM sufficienti per operare sulla chiave Cloud KMS specificata. Segui le istruzioni riportate nell'errore o consulta i seguenti documenti: Se hai attivato i Controlli di servizio VPC, consulta la sezione Risolvere i problemi relativi a Controlli di servizio VPC e alla condivisione limitata dei domini. di questo documento. Assegnare il ruolo di crittografia/decrittografia per i bucket di log Assegnare il ruolo di crittografia/decrittografia per organizzazioni e cartelle
Chiave di crittografia disabilitata	La chiave Cloud KMS specificata è stata disattivata. Segui le istruzioni riportate nell'errore per riattivare la chiave.
Chiave di crittografia eliminata	La chiave Cloud KMS specificata è stata eliminata. Segui le istruzioni o consulta i seguenti documenti: Gestire la chiave Cloud KMS per un bucket di log Gestire la chiave Cloud KMS per una cartella o un'organizzazione

Identifica il progetto che contiene la chiave Cloud KMS

Per identificare l'ID del progetto Google Cloud contenente la chiave di crittografia utilizzata da un bucket, una cartella o un'organizzazione di log:

PROGETTO

gcloud logging settings describe --project=PROJECT_ID

Prima di eseguire il comando, sostituisci PROJECT_ID con l'ID progetto che contiene il bucket dei log.

FOLDER

gcloud logging settings describe --folder=FOLDER_ID

Prima di eseguire il comando, sostituisci FOLDER_ID con l'ID della cartella.

ORGANIZZAZIONE

gcloud logging settings describe --organization=ORGANIZATION_ID

Prima di eseguire il comando, sostituisci ORGANIZATION_ID con l'ID dell'organizzazione.

Il comando precedente restituisce informazioni simili alle seguenti:

kmsServiceAccountId: [e-mail]
loggingServiceAccountId: [e-mail]

Per le organizzazioni e le cartelle, viene restituito anche il seguente campo:

kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY

Il valore del campo kmsKeyName include il progetto Google Cloud che memorizza la chiave.

Verificare l'usabilità della chiave

Per verificare l'usabilità della chiave, esegui il seguente comando per elencare tutte le chiavi:

gcloud kms keys list \
--location=KMS_KEY_LOCATION \
--keyring=KMS_KEY_RING

Questo comando restituisce informazioni su ogni chiave in un formato tabulare. La prima riga dell'output è un elenco di nomi di colonna:

NAME PURPOSE ...

Verifica che la chiave Cloud KMS sia elencata nell'output del comando come ENABLED e che lo scopo della chiave sia la crittografia simmetrica: la colonna PURPOSE deve contenere ENCRYPT_DECRYPT e la colonna PRIMARY_STATE deve contenere ENABLED.

Se necessario, crea una nuova chiave.

Verifica la configurazione delle autorizzazioni

Gli account di servizio associati alle impostazioni CMEK dell'organizzazione devono avere il ruolo Autore crittografia/decrittografia CryptoKey Cloud KMS per la chiave configurata.

Per elencare il criterio IAM della chiave, esegui il seguente comando:

gcloud kms keys get-iam-policy KMS_KEY_NAME

Se necessario, aggiungi alla chiave l'account di servizio contenente il ruolo Autore crittografia/decrittografia CryptoKey Cloud KMS.