Esta página mostra-lhe como criar um conjunto de chaves no Cloud KMS. Um conjunto de chaves é o recurso raiz para chaves e versões de chaves do Cloud KMS. Cada porta-chaves existe numa determinada localização. Para mais informações sobre os recursos do Cloud KMS, consulte o artigo Recursos do Cloud KMS.
Antes de começar
Antes de concluir as tarefas nesta página, precisa do seguinte:
- Um recurso de projeto para conter os seus recursos do Cloud KMS. Cloud de Confiance Este projeto é denominado o seu projeto principal. Recomendamos que o seu projeto principal não contenha outros recursos.Cloud de Confiance Ative a API Cloud KMS no projeto da chave.
- O nome da localização onde quer criar o seu porta-chaves. Escolha uma localização perto dos seus outros recursos e que suporte o nível de proteção escolhido. Para ver as localizações disponíveis e os níveis de proteção que suportam, consulte o artigo Localizações do Cloud KMS.
Funções necessárias
Para obter as autorizações de que
precisa para criar conjuntos de chaves,
peça ao seu administrador que lhe conceda a função
administrador do Cloud KMS (roles/cloudkms.admin)
da IAM no projeto ou num recurso principal.
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 as autorizações necessárias para criar conjuntos de chaves. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
As seguintes autorizações são necessárias para criar conjuntos de chaves:
-
cloudkms.keyRings.create -
cloudkms.keyRings.get -
cloudkms.keyRings.list -
cloudkms.locations.get -
cloudkms.locations.list -
resourcemanager.projects.get
Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.
Crie um conjunto de chaves
Siga estes passos para criar um porta-chaves para a sua nova chave. Se quiser usar um conjunto de chaves existente, pode criar uma chave.
Consola
Aceda à página Gestão de chaves na Cloud de Confiance consola.
Clique em Criar conjunto de chaves.
Em Nome do conjunto de chaves, introduza um nome para o conjunto de chaves.
Para Localização do porta-chaves, selecione uma localização, como
"us-east1".Clique em Criar.
gcloud
-
In the Cloud de Confiance console, activate Cloud Shell.
-
No seu ambiente, execute o comando
gcloud kms keyrings create:gcloud kms keyrings create KEY_RING \ --location LOCATIONSubstitua o seguinte:
KEY_RING: o nome do conjunto de chaves que contém a chave.LOCATION: a 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. PROJECT_ID: o ID do projeto que contém o conjunto de chaves.KEY_RING: o nome do conjunto de chaves que contém a chave.LOCATION: a localização do Cloud KMS do conjunto de chaves.
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 Cloud de Confiance 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.
API
Estes exemplos usam o curl como cliente HTTP para demonstrar a utilização da API. Para mais informações sobre o controlo de acesso, consulte o artigo Aceder à API Cloud KMS.
curl "https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings?key_ring_id=KEY_RING" \
--request "POST" \
--header "authorization: Bearer TOKEN"
Substitua o seguinte:
Consulte a KeyRing.create documentação da API
para mais informações.
O que se segue?
- Saiba como criar uma chave.
- Saiba como importar chaves.
- Saiba como criar chaves externas.