Aggiorna riferimento chiave esterna

Questa pagina mostra come aggiornare il riferimento alla chiave esterna per una chiave Cloud EKM senza ruotare la chiave. Il nuovo riferimento alla chiave deve rimandare allo stesso materiale della chiave del riferimento alla chiave corrente. Se il materiale della chiave è stato ruotato nel sistema di gestione delle chiavi esterne del partner, devi ruotare la chiave.

Segui le istruzioni riportate in questa pagina se il sistema di gestione delle chiavi esterne del partner ha modificato il riferimento alla chiave per una chiave esistente. Ad esempio, il riferimento alla chiave può cambiare a seguito di una modifica al nome host del partner di gestione delle chiavi esterne o di una modifica alla struttura del riferimento alla chiave.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per aggiornare un riferimento alla chiave esterna, chiedi all'amministratore di concederti il ruolo IAM Cloud KMS Admin (roles/cloudkms.admin) sulla chiave. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l' cloudkms.cryptoKeyVersions.update autorizzazione, necessaria per aggiornare un riferimento alla chiave esterna.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Aggiorna l'URI per una versione della chiave senza rotazione

Per aggiornare il riferimento alla chiave per una chiave Cloud EKM che utilizzi su internet, completa i seguenti passaggi:

Console

  1. Nella Google Cloud console, vai alla Gestione chiavi pagina.

    Vai a Gestione chiavi

  2. Seleziona le chiavi automatizzate, quindi seleziona la chiave e la versione.

  3. Fai clic su Altro, quindi su Visualizza URI chiave.

  4. Fai clic su Aggiorna URI chiave.

  5. Inserisci il nuovo URI della chiave, quindi fai clic su Salva.

gcloud

Per aggiornare l'URI della versione della chiave, utilizza il comando gcloud kms versions update:

gcloud kms keys versions update KEY_VERSION \
  --key KEY_NAME \
  --keyring KEY_RING \
  --location LOCATION \
  --external-key-uri NEW_KEY_URI

Sostituisci quanto segue:

  • KEY_VERSION: il numero della versione della chiave.
  • KEY_NAME: il nome della chiave.
  • KEY_RING: il nome delle chiavi automatizzate che contiene la chiave.
  • LOCATION: la posizione di Cloud KMS delle chiavi automatizzate.
  • NEW_KEY_URI: il nuovo URI per il materiale della chiave esterna esistente.

Aggiorna il percorso della chiave per una versione della chiave senza rotazione

Per aggiornare il riferimento alla chiave per una chiave Cloud EKM che utilizzi su una rete VPC, completa i seguenti passaggi:

Console

  1. Nella Google Cloud console, vai alla Gestione chiavi pagina.

    Vai a Gestione chiavi

  2. Seleziona le chiavi automatizzate, quindi seleziona la chiave e la versione.

  3. Fai clic su Altro quindi su Visualizza percorso chiave.

  4. Fai clic su Aggiorna percorso chiave.

  5. Inserisci il nuovo percorso della chiave, quindi fai clic su Salva.

gcloud

Per aggiornare il percorso della chiave della versione della chiave, utilizza il gcloud kms versions update comando:

gcloud kms keys versions update KEY_VERSION \
  --key KEY_NAME \
  --keyring KEY_RING \
  --location LOCATION \
  --ekm-connection-key-path NEW_KEY_PATH

Sostituisci quanto segue:

  • KEY_VERSION: il numero della versione della chiave.
  • KEY_NAME: il nome della chiave.
  • KEY_RING: il nome delle chiavi automatizzate che contiene la chiave.
  • LOCATION: la posizione di Cloud KMS delle chiavi automatizzate.
  • NEW_KEY_PATH: il nuovo percorso per il materiale della chiave esterna esistente.