Atualizar referência de chave externa

Nesta página, mostramos como atualizar a referência de chave externa para uma chave do Cloud EKM sem girar a chave. A nova referência de chave precisa apontar para o mesmo material de chave que a referência atual. Se o material da chave tiver sido girado no sistema do parceiro de gerenciamento de chaves externas, você deve girar a chave.

Use as instruções desta página se o sistema de gerenciamento de chaves externas do parceiro tiver mudado a referência de chave para uma chave atual. Por exemplo, a referência de chave pode mudar como resultado de uma alteração no nome do host do parceiro de gerenciamento de chaves externas ou de uma mudança na estrutura de referência de chave.

Funções exigidas

Para receber a permissão necessária para atualizar uma referência de chave externa, peça ao administrador para conceder a você oAdministrador do Cloud KMS (roles/cloudkms.admin) papel do IAM na sua chave. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a cloudkms.cryptoKeyVersions.update permissão, que é necessária para atualizar uma referência de chave externa.

Também é possível receber essa permissão com papéis personalizados ou outros papéis predefinidos.

Atualizar o caminho da chave para uma versão de chave sem rotação

Para atualizar a referência de chave de uma chave do Cloud EKM que você usa em uma rede VPC, siga estas etapas:

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