Este documento descreve como impedir que os usuários acessem instâncias de máquinas virtuais (VMs) removendo e bloqueando chaves SSH das VMs.
Antes de começar
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
Se você não souber qual chave deseja remover, execute o comando
gcloud compute os-login describe-profile
para visualizar todas as chaves associadas à sua conta:gcloud compute os-login describe-profile
Copie o valor
fingerprint
da chave que você deseja excluir.Remova a chave da sua conta usando o comando
gcloud compute os-login ssh-keys remove
:gcloud compute os-login ssh-keys remove --key=KEY
Substitua
KEY
pela chave SSH pública que você deseja remover ou pela impressão digital de login do sistema operacional da chave que você deseja remover.Se você não sabe qual chave deseja remover, use o método
users.getLoginProfile
para visualizar todas as chaves associadas à sua conta:GET https://oslogin.googleapis.com/v1/users/ACCOUNT_EMAIL/loginProfile
Substitua
ACCOUNT_EMAIL
pelo endereço de e-mail associado à sua conta.Copie o valor
fingerprint
da chave que você deseja excluir.Remova a chave da sua conta usando o método
users.sshPublicKeys.delete
:DELETE https://oslogin.googleapis.com/v1/users/ACCOUNT_EMAIL/sshPublicKeys/FINGERPRINT
Substitua o seguinte:
-
ACCOUNT_EMAIL
: o endereço de e-mail associado à sua conta -
FINGERPRINT
: a impressão digital SHA-256 da chave a ser removida
-
No console do Google Cloud, acesse a página Metadados .
Clique na guia Chaves SSH .
Clique em
Editar na parte superior da página.Navegue até a chave SSH que deseja remover e clique no botão
ao lado da chave SSH.Repita esta etapa para cada chave SSH que você deseja remover.
Clique em Salvar .
Execute o comando
gcloud compute project-info describe
para obter os metadados do projeto:gcloud compute project-info describe
A saída é semelhante à seguinte:
... metadata: ...
- key: ssh-keys
value: |- cloudysanfrancisco:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAu5kKQCPF baklavainthebalkans:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDQDx3FNVC8 google-ssh {"userName":"baklavainthebalkans","expireOn":"2021-06-14T16:59:03+0000"} ...Copie o valor dos metadados
ssh-keys
.Crie e abra um novo arquivo de texto em sua estação de trabalho.
No arquivo, cole a lista de chaves SSH que você acabou de copiar e exclua as chaves que deseja remover dos metadados do projeto.
Salve e feche o arquivo.
Execute o comando
gcloud compute project-info add-metadata
para definir o valor dessh-keys
para todo o projeto:gcloud compute project-info add-metadata --metadata-from-file=ssh-keys=KEY_FILE
Substitua
KEY_FILE
por um dos seguintes:- o caminho para o arquivo que você criou na etapa anterior, se o projeto tivesse chaves SSH existentes
- o caminho para seu novo arquivo de chave SSH pública, se o projeto não tiver chaves SSH existentes
Use o método
projects.get
para obter os valores defingerprint
essh-keys
dos metadados.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID
Substitua
PROJECT_ID
pelo ID do seu projeto.A resposta é semelhante à seguinte:
... "fingerprint": "utgYE_XWtE8=", "items": [ { "key": "ssh-keys", "value": "cloudysanfrancisco:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAu5kKQCPF\nbaklavainthebalkans:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDQDx3FNVC8 google-ssh {"userName":"baklavainthebalkans","expireOn":"2021-06-14T16:59:03+0000"}" } ] ...
Copie a lista de valores de chave SSH e exclua as chaves que deseja remover.
Use o
projects.setCommonInstanceMetadata
para remover as chaves SSH.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/setCommonInstanceMetadata { "items": [ { "key": "ssh-keys", "value": "EXISTING_SSH_KEYS" } ] "fingerprint": "FINGERPRINT" }
Substitua o seguinte:
-
PROJECT_ID
: o ID do seu projeto -
EXISTING_SSH_KEYS
: a lista das chaves SSH que você deseja manter -
FINGERPRINT
: o valor dafingerprint
da resposta da solicitaçãoprojects.get
-
No console do Google Cloud, acesse a página de instâncias de VM .
Clique no nome da VM cuja chave você deseja remover.
Clique em Editar .
Na seção Chaves SSH , clique em Mostrar e editar . A seção se expande para mostrar todas as chaves SSH públicas em nível de instância.
Clique no botão
ao lado da chave SSH que você deseja remover.Repita esta etapa para cada chave SSH que você deseja remover.
Clique em Salvar .
Execute o comando
gcloud compute instances describe
para obter os metadados da VM:gcloud compute instances describe VM_NAME
Substitua VM_NAME pelo nome da VM para a qual você precisa adicionar ou remover chaves SSH públicas.
A saída é semelhante à seguinte:
... metadata: ...
- key: ssh-keys
value: |- cloudysanfrancisco:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAu5kKQCPF baklavainthebalkans:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDQDx3FNVC8 google-ssh {"userName":"baklavainthebalkans","expireOn":"2021-06-14T16:59:03+0000"} ...Copie o valor dos metadados
ssh-keys
.Crie e abra um novo arquivo de texto na sua estação de trabalho local.
No arquivo, cole a lista de chaves SSH que você acabou de copiar e remova as chaves que deseja excluir.
Salve e feche o arquivo.
Execute o comando
gcloud compute project-info add-metadata
para definir o valor dessh-keys
para todo o projeto:gcloud compute instances add-metadata VM_NAME --metadata-from-file ssh-keys=KEY_FILE
Substitua o seguinte:
-
VM_NAME
: a VM cuja chave SSH você deseja remover -
KEY_FILE
: o caminho para o arquivo que contém a lista de todas as chaves SSH do projeto
-
Use o método
instances.get
para obter os valores defingerprint
essh-keys
dos metadados.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
Substitua o seguinte:
-
PROJECT_ID
: o ID do seu projeto -
ZONE
: a zona da VM para a qual você está adicionando uma chave SSH -
VM_NAME
: a VM para a qual você está adicionando uma chave SSH
A resposta é semelhante à seguinte:
... "fingerprint": "utgYE_XWtE8=", "items": [ { "key": "ssh-keys", "value": "cloudysanfrancisco:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAu5kKQCPF\nbaklavainthebalkans:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDQDx3FNVC8 google-ssh {"userName":"baklavainthebalkans","expireOn":"2021-06-14T16:59:03+0000"}" } ] ...
-
Copie a lista de valores de chave SSH e exclua as chaves que deseja remover.
Use
instances.setMetadata
para remover as chaves SSH.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMetadata { "items": [ { "key": "ssh-keys", "value": "EXISTING_SSH_KEYS } ] "fingerprint": "FINGERPRINT" }
Substitua o seguinte:
-
PROJECT_ID
: o ID do seu projeto -
EXISTING_SSH_KEYS
: o valor da chavessh-keys
da resposta da solicitaçãoprojects.get
-
FINGERPRINT
: o valor dafingerprint
da resposta da solicitaçãoinstances.get
-
No console do Google Cloud, acesse a página Criar uma instância .
Para bloquear chaves SSH do projeto, faça o seguinte:
No menu de navegação, clique em Segurança .
Expanda a seção Gerenciar acesso .
Para desabilitar o login do sistema operacional, desmarque a caixa de seleção Controlar o acesso à VM por meio de permissões do IAM .
Marque a caixa de seleção Bloquear chaves SSH em todo o projeto .
Opcional: Especifique outras opções de configuração. Para obter mais informações, consulte Opções de configuração durante a criação da instância .
Para criar e iniciar a instância, clique em Criar .
-
PROJECT_ID
: o ID do projeto -
ZONE
: a zona da VM No console do Google Cloud, acesse a página de instâncias de VM .
Clique no nome da VM para a qual você deseja bloquear as chaves SSH do projeto.
Clique em Editar .
Em Chaves SSH , marque a caixa de seleção Bloquear chaves SSH em todo o projeto .
Quando terminar de editar a configuração de conexão para chaves SSH, clique em Salvar .
Use o método
instances.get
para obter afingerprint
dos metadados.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
Substitua o seguinte:
-
PROJECT_ID
: o ID do seu projeto -
ZONE
: a zona da VM para a qual você está adicionando uma chave SSH -
VM_NAME
: a VM para a qual você está adicionando uma chave SSH
A resposta é semelhante à seguinte:
... "fingerprint": "utgYE_XWtE8=" ...
-
Use o método
instances.setMetadata
para definirblock-project-ssh-keys
comoTRUE
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMetadata { "items": [ { "key": "block-project-ssh-keys", "value": TRUE } ] "fingerprint": "FINGERPRINT" }
Substitua o seguinte:
-
PROJECT_ID
é o ID do seu projeto -
ZONE
é a zona onde sua instância está localizada -
INSTANCE_NAME
é a instância em que você deseja bloquear as chaves de todo o projeto. -
FINGERPRINT
: o valor dafingerprint
da resposta da solicitaçãoinstances.get
.
-
- Saiba mais sobre os benefícios de usar o Login do SO para gerenciamento de acesso.
- Conecte-se a VMs usando ferramentas do Google para não precisar gerenciar suas próprias chaves SSH.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Remover chaves SSH
Você pode remover chaves SSH de VMs que usam login do sistema operacional e de VMs que usam chaves SSH baseadas em metadados .Remover chaves SSH de VMs que usam login do sistema operacional
As VMs que usam o Login do SO aceitam chaves SSH associadas à sua conta do Google. Você pode remover uma chave SSH pública da sua conta de usuário usando a CLI do Google Cloud ou a API OS Login. Se você for administrador da sua organização, poderá remover chaves SSH de contas de usuário usando a API Directory . O Compute Engine remove automaticamente as chaves expiradas da sua Conta do Google.
gcloud
Para remover uma chave SSH pública da sua conta, faça o seguinte:
DESCANSAR
Para remover uma chave SSH pública da sua conta, faça o seguinte:
Remover chaves SSH de VMs que usam chaves baseadas em metadados
É possível remover uma chave SSH pública dos metadados do projeto ou da instância usando o console do Google Cloud, a CLI gcloud ou a API Compute Engine.
Depois que você remover a última chave dos metadados de um usuário específico ou a última chave nos metadados de um usuário específico expirar, o Compute Engine excluirá o arquivo
Cuidado: Se você gerenciar chaves SSH em metadados, poderá interromper a capacidade dos membros do seu projeto de se conectarem às VMs. Além disso, você corre o risco de conceder aos usuários, incluindo usuários fora do seu projeto, acesso não intencional às VMs. Para obter mais informações, consulte riscos do gerenciamento manual de chaves .~/.ssh/authorized_keys
do usuário na VM.Remover uma chave pública dos metadados do projeto
Remova uma chave SSH pública dos metadados do projeto para remover o acesso a todas as VMs de um projeto.
Ao remover uma chave dos metadados usando a CLI gcloud e a API Compute Engine, você deve recuperar a lista de chaves existentes, editar a lista de chaves para remover as chaves indesejadas e substituir as chaves antigas pela lista de chaves que deseja manter, conforme explicado na seção a seguir.
Console
Para remover uma chave SSH pública dos metadados do projeto usando o console do Google Cloud, faça o seguinte:
gcloud
Para remover uma chave SSH pública dos metadados do projeto usando a CLI gcloud, faça o seguinte:
DESCANSAR
Para remover uma chave SSH pública dos metadados do projeto usando a API Compute Engine, faça o seguinte:
Remover uma chave SSH pública dos metadados da instância
Remova uma chave SSH pública dos metadados da instância para remover o acesso a uma única VM.
Ao remover uma chave dos metadados usando a CLI gcloud e a API Compute Engine, você deve recuperar a lista de chaves existentes, editar a lista de chaves para remover as chaves indesejadas e substituir as chaves antigas pela lista de chaves que deseja manter, conforme explicado na seção a seguir.
Console
Para remover uma chave SSH pública dos metadados da instância usando o console do Google Cloud, faça o seguinte:
gcloud
Para remover uma chave SSH pública dos metadados da instância usando a CLI gcloud, faça o seguinte:
DESCANSAR
Para remover uma chave SSH pública dos metadados da instância usando a API Compute Engine, faça o seguinte:
Bloquear chaves SSH do projeto de VMs que usam chaves SSH baseadas em metadados
Você pode impedir que as VMs aceitem chaves SSH armazenadas nos metadados do projeto bloqueando as chaves SSH do projeto das VMs. Você pode bloquear chaves SSH do projeto de VMs ao criar uma VM ou depois de criar uma VM .
Bloquear chaves SSH do projeto de uma VM durante a criação da VM
É possível bloquear chaves SSH do projeto de VMs durante a criação da VM usando o console do Google Cloud, a CLI gcloud ou a API Compute Engine.
Console
Para criar uma instância e impedir que ela aceite chaves SSH armazenadas nos metadados do projeto usando o console do Google Cloud, faça o seguinte:
gcloud
Para criar uma VM e impedir que ela aceite chaves SSH armazenadas nos metadados do projeto usando a CLI gcloud, use o comando
gcloud compute instances create
:gcloud compute instances create VM_NAME \ --metadata block-project-ssh-keys=TRUE
Substitua
VM_NAME
pelo nome da nova VM.DESCANSAR
Para criar uma VM e impedir que ela aceite chaves SSH armazenadas nos metadados do projeto usando o Compute Engine, crie uma solicitação
POST
para o métodoinstances.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
Substitua o seguinte:
No corpo da solicitação, forneça nomes de usuário e chaves SSH públicas na propriedade
items
:... { "items": [ { "key": "block-project-ssh-keys", "value": TRUE } ] } ...
Bloquear chaves SSH do projeto de uma VM após a criação da VM
É possível bloquear chaves SSH do projeto de VMs após a criação da VM usando o console do Google Cloud, a CLI gcloud ou a API Compute Engine.
Console
Para impedir que as VMs aceitem conexões de chaves SSH armazenadas nos metadados do projeto usando o console do Google Cloud, faça o seguinte:
gcloud
Para impedir que as VMs aceitem conexões de chaves SSH armazenadas nos metadados do projeto usando a CLI gcloud, faça o seguinte:
Execute o comando
gcloud compute instances add-metadata
:gcloud compute instances add-metadata VM_NAME --metadata block-project-ssh-keys=TRUE
Substitua
VM_NAME
pelo nome da VM para a qual você deseja bloquear chaves SSH públicas em todo o projeto.DESCANSAR
Para impedir que as VMs aceitem conexões de chaves SSH armazenadas nos metadados do projeto usando a API Compute Engine, faça o seguinte:
O que vem a seguir?
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-21 UTC.
-