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. Google Cloud Este projeto é denominado o seu projeto principal. Recomendamos que o seu projeto principal não contenha outros recursos.Google Cloud 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 Google Cloud 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 Google Cloud console, activate Cloud Shell.
-
No seu ambiente, execute o comando
gcloud kms keyrings create
:gcloud kms keyrings create KEY_RING \ --location LOCATION
Substitua 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 Google 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.
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.