Atualize a referência de chave externa

Esta página mostra como atualizar a referência da chave externa para uma chave do Cloud EKM sem rodar a chave. A nova referência da chave tem de apontar para o mesmo material da chave que a referência da chave atual. Se o material da chave tiver sido rodado no sistema do parceiro de gestão de chaves externo, tem de rodar a chave.

Use as instruções nesta página se o sistema do seu parceiro de gestão de chaves externa tiver alterado a referência da chave para uma chave existente. Por exemplo, a referência da chave pode mudar devido a uma alteração ao nome do anfitrião do parceiro de gestão de chaves externo ou a uma alteração na respetiva estrutura de referência da chave.

Funções necessárias

Para receber a autorização de que precisa para atualizar uma referência de chave externa, peça ao seu administrador para lhe conceder a função de IAM administrador do Cloud KMS (roles/cloudkms.admin) na sua chave. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém a autorização cloudkms.cryptoKeyVersions.update , que é necessária para atualizar uma referência de chave externa.

Também pode obter esta autorização com funções personalizadas ou outras funções predefinidas.

Atualize o caminho da chave para uma versão da chave sem rotação

Para atualizar a referência da chave de uma chave do Cloud EKM que usa numa rede VPC, conclua os seguintes passos:

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