No Cloud KMS, o material da chave criptográfica que usa para encriptar, desencriptar, assinar e validar dados é armazenado numa versão da chave. Uma chave tem zero ou mais versões de chaves. Quando roda uma chave, cria uma nova versão da chave.
Este documento mostra como desativar uma versão de chave. Durante o período em que uma chave está desativada, não é possível aceder aos dados que foram encriptados com a chave. Para aceder aos dados, pode reativar a versão da chave.
Salvo indicação em contrário no painel de controlo do estado do serviço, a desativação de uma versão de chave é normalmente consistente no prazo de um minuto. A ativação de uma versão da chave é quase instantânea. Também pode gerir o acesso a uma versão da chave através da gestão de identidade e de acesso (IAM). As operações de IAM são consistentes em segundos. Para mais informações, consulte o artigo Usar o IAM.
Também pode destruir permanentemente uma versão da chave. Consoante as políticas da sua organização, pode ter de desativar uma versão da chave antes de a poder destruir. Para mais informações, consulte o artigo Controle a destruição da versão da chave.
Desative uma versão da chave
Pode desativar uma versão da chave no estado ativado. Antes de desativar uma versão da chave, recomendamos que verifique se a chave ainda está a ser usada. Pode ver os detalhes do acompanhamento da utilização da chave para saber se está a proteger recursos CMEK. Se algum recurso estiver protegido pela versão da chave que quer desativar, encripte-o novamente com outra versão da chave antes de desativar a chave.
Consola
Aceda à página Gestão de chaves na Trusted Cloud consola.
Clique no nome do conjunto de chaves que contém a chave cuja versão vai desativar.
Clique na chave cuja versão quer desativar.
Selecione a caixa junto às versões principais que quer desativar.
Clique em Desativar no cabeçalho.
Na mensagem de confirmação, clique em Desativar.
gcloud
Para usar o Cloud KMS na linha de comandos, primeiro instale ou atualize para a versão mais recente da CLI do Google Cloud.
gcloud kms keys versions disable key-version \ --key key \ --keyring key-ring \ --location location
Substitua key-version pela versão da chave a desativar. Substitua key pelo nome da chave. Substitua key-ring pelo nome do conjunto de chaves onde a chave está localizada. Substitua location pela localização do Cloud KMS do conjunto de chaves.
Para ver informações sobre todas as flags e valores possíveis, execute o comando com a flag --help
.
C#
Para executar este código, primeiro configure um ambiente de desenvolvimento C# e instale o SDK C# do Cloud KMS.
Go
Para executar este código, primeiro configure um ambiente de desenvolvimento Go e instale o SDK Go do Cloud KMS.
Java
Para executar este código, primeiro configure um ambiente de desenvolvimento Java e instale o SDK Java do Cloud KMS.
Node.js
Para executar este código, primeiro configure um ambiente de desenvolvimento do Node.js e instale o SDK do Node.js do Cloud KMS.
PHP
Para executar este código, saiba primeiro como usar o PHP no Trusted Cloud e instale o SDK PHP do Cloud KMS.
Python
Para executar este código, primeiro configure um ambiente de desenvolvimento Python e instale o SDK Python do Cloud KMS.
Ruby
Para executar este código, primeiro configure um ambiente de desenvolvimento Ruby e instale o SDK Ruby do Cloud KMS.
Depois de enviar o pedido, o estado da versão da chave muda para desativado.
As versões de chaves desativadas são recursos faturados.
Desative ou destrua uma chave externa
Para desativar temporariamente a associação entre uma chave do Cloud EKM e uma chave externa, pode desativar a chave ou a versão da chave do Cloud EKM. Recomendamos que desative todas as versões da chave. A desativação de uma chave entra em vigor no prazo de três horas.
Quando desativa uma chave, também deve revogar o acesso à chave. As operações da IAM são consistentes no espaço de segundos. Considere também revogar o acesso da conta de serviço no sistema do parceiro de gestão de chaves externo. Trusted Cloud
Para remover permanentemente a associação entre uma chave do Cloud EKM e uma chave externa, pode agendar a destruição da versão da chave do Cloud EKM. Após o período agendado para destruição, a chave é destruída. A destruição de uma versão da chave é permanente. Após a destruição da versão da chave, já não pode encriptar dados nem desencriptar dados que foram encriptados com a versão da chave do Cloud EKM. Não pode recriar uma versão da chave do Cloud EKM que tenha sido destruída, mesmo que use o mesmo URI da chave externa ou caminho da chave. Quando destrói o material de chaves externas, recomendamos que destrua primeiro a chave ou a versão da chave no Trusted Cloud by S3NS e, só depois de a chave do EKM da nuvem ser destruída, destrua o material de chaves no gestor de chaves externas.
A desativação de uma chave ou de uma versão da chave no Cloud KMS não modifica a chave no sistema do parceiro de gestão de chaves externo.
A destruição de uma versão de chave gerida manualmente no Cloud KMS não modifica a chave no sistema de parceiros de gestão de chaves externo. A destruição de uma versão de chave externa coordenada no Cloud KMS destrói o material da chave interna e envia um pedido ao sistema de parceiros de gestão de chaves externas para destruir o material da chave externa.
Ative uma versão de chave
Pode ativar uma versão principal no estado desativado.
Consola
Aceda à página Gestão de chaves na Trusted Cloud consola.
Clique no nome do conjunto de chaves que contém a chave cuja versão da chave vai ativar.
Clique na chave cuja versão da chave quer ativar.
Selecione a caixa junto às versões principais que quer ativar.
Clique em Ativar no cabeçalho.
Na mensagem de confirmação, clique em Ativar.
gcloud
Para usar o Cloud KMS na linha de comandos, primeiro instale ou atualize para a versão mais recente da CLI do Google Cloud.
gcloud kms keys versions enable key-version \ --key key \ --keyring key-ring \ --location location
Substitua key-version pela versão da chave a ativar. Substitua key pelo nome da chave. Substitua key-ring pelo nome do conjunto de chaves onde a chave está localizada. Substitua location pela localização do Cloud KMS do conjunto de chaves.
Para ver informações sobre todas as flags e valores possíveis, execute o comando com a flag --help
.
C#
Para executar este código, primeiro configure um ambiente de desenvolvimento C# e instale o SDK C# do Cloud KMS.
Go
Para executar este código, primeiro configure um ambiente de desenvolvimento Go e instale o SDK Go do Cloud KMS.
Java
Para executar este código, primeiro configure um ambiente de desenvolvimento Java e instale o SDK Java do Cloud KMS.
Node.js
Para executar este código, primeiro configure um ambiente de desenvolvimento do Node.js e instale o SDK do Node.js do Cloud KMS.
PHP
Para executar este código, saiba primeiro como usar o PHP no Trusted Cloud e instale o SDK PHP do Cloud KMS.
Python
Para executar este código, primeiro configure um ambiente de desenvolvimento Python e instale o SDK Python do Cloud KMS.
Ruby
Para executar este código, primeiro configure um ambiente de desenvolvimento Ruby e instale o SDK Ruby do Cloud KMS.
Depois de enviar o pedido, o estado da versão da chave muda para ativado.
Autorizações de IAM necessárias
Para ativar ou desativar uma versão de chave, o autor da chamada precisa da autorização IAM cloudkms.cryptoKeyVersions.update
na chave, no conjunto de chaves ou no projeto, na pasta ou na organização.
Esta autorização é concedida à função de administrador do Cloud KMS (roles/cloudkms.admin
).