Conferir chaves por projeto

Nesta página, mostramos como ver keyrings e chaves no seu Google Cloud recurso de projeto.

Antes de começar

Antes de visualizar chaveiros e chaves, conclua as etapas de configuração descritas nesta seção.

Ativar APIs

Para conferir keyrings e chaves usando uma API, ative a API Cloud KMS Inventory.

Ativar a API

Funções exigidas

Para receber as permissões necessárias para visualizar chaves, peça ao administrador para conceder a você o papel do IAM de Leitor do Cloud KMS (roles/cloudkms.viewer) no seu projeto. 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 as permissões necessárias para visualizar chaves. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para visualizar chaves:

  • cloudkms.keyRings.list
  • cloudkms.cryptoKeys.list
  • cloudkms.locations.list
  • resourcemanager.projects.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Ver keyrings

Console

  1. No console Google Cloud , acesse a página Key Rings.

    Acessar Keyrings

  2. Opcional: para filtrar sua lista de chaveiros, insira os termos de pesquisa na caixa Filtrar filter_list e pressione Enter.

  3. Opcional: para classificar a lista pelos valores em uma coluna, clique no cabeçalho dela.

Ao visualizar seus keyrings, você pode selecionar um keyring para conferir detalhes sobre as chaves associadas e os jobs de importação.

Ver chaves

Use o console Google Cloud para ver as chaves criadas no recurso do projeto.

Console

  1. No console Google Cloud , acesse a página Inventário de chaves.

    Acessar o inventário de chaves

  2. Opcional: para filtrar sua lista de chaves, insira os termos de pesquisa na caixa Filtro filter_list e pressione Enter.

  3. Opcional: para classificar a lista pelos valores em uma coluna, clique no cabeçalho dela.

CLI da gcloud

Para usar o Cloud KMS na linha de comando, primeiro instale ou faça upgrade para a versão mais recente da Google Cloud CLI.

gcloud kms inventory list-keys --project PROJECT_ID

Substitua PROJECT_ID pelo nome do projeto em que você quer ver a lista de chaves.

Para informações sobre todas as sinalizações e valores possíveis, execute o comando com a sinalização --help.

API

Estes exemplos usam curl como um cliente HTTP para demonstrar o uso da API. Para mais informações sobre controle de acesso, consulte Como acessar a API Cloud KMS. 

curl "https://kmsinventory.googleapis.com/v1/projects/PROJECT_ID/cryptoKeys"
    --request "GET" \
    --header "x-goog-user-project: CALLING_PROJECT_ID"
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer TOKEN"

Substitua:

  • PROJECT_ID: o ID do projeto que contém o keyring.
  • CALLING_PROJECT_ID: o ID do projeto de que você está chamando a API KMS Inventory.

Ao visualizar as chaves, você pode selecionar uma delas para conferir detalhes, incluindo as versões associadas.

Detalhes importantes

O inventário de chaves apresenta informações detalhadas sobre as chaves criptográficas do seu projeto. As propriedades no inventário principal incluem:

  • Nome da chave: o nome da chave.
  • Status: o status atual da chave com base no state da versão da chave principal. Esse campo se aplica somente a chaves simétricas.
    • Disponível: a versão da chave primária está ativada. A chave está disponível para criptografar e descriptografar dados.
    • Não disponível: a versão da chave primária está desativada ou vazia. A chave não está disponível para uso na criptografia de dados.
    • Disponível no GCP: para chaves gerenciadas externamente, a chave (não necessariamente a chave gerenciada externamente) está disponível para uso.
  • Keyring: nome do keyring principal.
  • Local: onde o material da chave reside.
  • Rotação atual: a data e a hora em que a chave foi girada pela última vez. Este campo mostra quando a versão atual da chave foi criada.
  • Frequência de rotação: a frequência de rotação atual da chave.
  • Próxima rotação: a data da próxima rotação de chaves programada. Uma nova versão da chave será criada automaticamente nessa data.
  • Nível de proteção: o nível de proteção da chave, por exemplo, HSM ou software.
  • Conexão EKM por VPC: para chaves externas acessadas por VPC, o nome da conexão EKM por VPC que a chave usa. Esse campo fica oculto por padrão e está em branco para chaves com níveis de proteção diferentes de External via VPC.
  • Finalidade: o cenário em que a chave pode ser usada.
  • Rótulos: rótulos aplicados à chave.

Limitações

  • A guia Keyring pode mostrar no máximo 1.000 recursos (incluindo keyrings, chaves e versões de chave) por local. Para conferir os keyrings de um projeto e local com mais de 1.000 recursos, use a API keyRings.list.

  • A guia Inventário de chaves pode mostrar no máximo 20.000 recursos (incluindo keyrings, chaves e versões de chave) por projeto. Para conferir as chaves de um projeto com mais de 20.000 recursos, use a API keyRings.cryptoKeys.list.