Algumas ou todas as informações nesta página podem não se aplicar ao Cloud de Confiance by S3NS. Consulte o artigo Diferenças em relação ao Google Cloud para mais detalhes.

Esta página foi traduzida pela API Cloud Translation.

Adicione chaves SSH a VMs

Este documento descreve como adicionar chaves SSH a instâncias de máquinas virtuais (VMs).

Antes de começar

Se ainda não o fez, crie um par de chaves SSH.
Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Cloud de Confiance by S3NS serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se 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 Cloud de Confiance console to access Cloud de Confiance by S3NS services and APIs, you don't need to set up authentication.
gcloud
1. Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada. Depois de iniciar sessão, inicialize a CLI gcloud executando o seguinte comando:
  gcloud init
  Nota: se instalou a CLI gcloud anteriormente, certifique-se de que tem a versão mais recente executando gcloud components update.
2. Set a default region and zone.
Terraform

Para usar os exemplos do Terraform nesta página num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as credenciais predefinidas da aplicação com as suas credenciais de utilizador.
Para mais informações, consulte Set up authentication for a local development environment.
REST

Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.
Para mais informações, consulte o artigo Autenticar para usar REST na Cloud de Confiance documentação de autenticação.

Adicione chaves SSH a VMs que usam chaves SSH baseadas em metadados

As VMs armazenam chaves SSH nos metadados do projeto e da instância do Compute Engine. Se o início de sessão do SO estiver ativado para uma VM, o agente convidado da VM ignora as chaves armazenadas nos metadados.

Pode usar chaves SSH armazenadas nos metadados do projeto para aceder a todas as VMs num projeto. Pode usar chaves SSH armazenadas nos metadados da instância para aceder a VMs individuais.

O Compute Engine não remove automaticamente as chaves SSH expiradas dos metadados no momento da expiração, mas não é possível usar as chaves expiradas para estabelecer novas ligações a VMs. Se quiser remover chaves expiradas dos metadados, consulte o artigo Remova chaves SSH de VMs que usam chaves baseadas em metadados.

Pode adicionar uma chave SSH pública aos metadados do projeto ou da instância de VM através da Cloud de Confiance consola, da CLI gcloud ou da REST. Não é possível definir valores de metadados zonais para chaves SSH.

Adicione chaves SSH aos metadados do projeto

Pode adicionar uma chave pública de SSH aos metadados do projeto para aceder a todas as VMs num projeto, exceto às VMs que bloqueiam chaves de SSH ao nível do projeto. Para mais informações sobre como bloquear chaves SSH ao nível do projeto, consulte o artigo Bloqueie chaves SSH de VMs que usam chaves SSH baseadas em metadados.

Autorizações necessárias para esta tarefa

Para realizar esta tarefa, tem de ter as seguintes autorizações:

compute.projects.setCommonInstanceMetadata no projeto.
iam.serviceAccounts.actAs no projeto. Para mais informações sobre as autorizações da conta de serviço, consulte Funções para autenticação da conta de serviço.

Consola

Para adicionar uma chave pública de SSH aos metadados do projeto através da Cloud de Confiance consola, faça o seguinte:

Na Cloud de Confiance consola, aceda à página Metadados.

Aceda aos metadados
Clique no separador Chaves SSH.
Clique em Edit.
Clique em Adicionar item.
No campo Chave SSH apresentado, adicione a sua chave SSH pública. A chave tem de estar num dos seguintes formatos:
- Formato de uma chave sem hora de validade:
```
KEY_VALUE USERNAME
```
- Formato de uma chave com um período de validade:
```
KEY_VALUE google-ssh {"userName":"USERNAME","expireOn":"EXPIRE_TIME"}
```
Substitua o seguinte:
- KEY_VALUE: o valor da chave SSH pública
- USERNAME: o seu nome de utilizador. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.
  Para VMs Linux, o USERNAME não pode ser root, a menos que configure a VM para permitir o início de sessão de raiz. Para mais informações, consulte o artigo Estabeleça ligação a VMs do Linux como utilizador root.
  
  Para VMs do Windows que usam o Active Directory (AD), o nome de utilizador tem de ter o domínio do AD no início, no formato DOMAIN\. Por exemplo, o utilizador cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.
- EXPIRE_TIME: a hora em que a chave expira, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000
Clique em Guardar.

gcloud

In the Cloud de Confiance console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Cloud de Confiance console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

Se existirem chaves SSH nos metadados do projeto, tem de as adicionar novamente aos metadados do projeto sempre que adicionar uma nova chave SSH através da CLI gcloud. Se não voltar a adicionar as chaves existentes, a adição de uma nova chave apaga as chaves existentes.

Para adicionar uma chave pública de SSH aos metadados do projeto através da CLI gcloud, faça o seguinte:
1. Se o seu projeto já tiver chaves SSH públicas ao nível do projeto, obtenha-as a partir dos metadados e adicione-as a um novo ficheiro:
  1. Execute o comando gcloud compute project-info describe para obter as chaves SSH do projeto:
```
gcloud compute project-info describe \
 --format="value(commonInstanceMetadata[items][ssh-keys])"
```
    O resultado é semelhante ao seguinte:
```
username:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ... username:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ...
```
  2. Copie o valor de metadados ssh-keys.
  3. Crie e abra um novo ficheiro de texto na sua estação de trabalho.
  4. No ficheiro, cole a lista de chaves que acabou de copiar.
  5. Adicione a nova chave no final da lista, num dos seguintes formatos:
    - Formato de uma chave sem hora de validade:
      USERNAME:KEY_VALUE
    - Formato de uma chave com um período de validade:
      USERNAME:KEY_VALUE google-ssh {"userName":"USERNAME","expireOn":"EXPIRE_TIME"}
    Substitua o seguinte:
    - KEY_VALUE: o valor da chave SSH pública
    - USERNAME: o seu nome de utilizador. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.
      Para VMs Linux, o USERNAME não pode ser root, a menos que configure a VM para permitir o início de sessão de raiz. Para mais informações, consulte o artigo Estabelecer ligação a instâncias como utilizador root.
      
      Para VMs do Windows que usam o Active Directory (AD), o nome de utilizador tem de ter o domínio do AD no início, no formato DOMAIN\. Por exemplo, o utilizador cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.
    - EXPIRE_TIME: a hora em que a chave expira, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000
  6. Guarde e feche o ficheiro.
2. Execute o comando gcloud compute project-info add-metadata para definir o valor ssh-keys ao nível do projeto:
```
gcloud compute project-info add-metadata --metadata-from-file=ssh-keys=KEY_FILE
```
  Substitua KEY_FILE por uma das seguintes opções:
  - O caminho para o ficheiro que criou no passo anterior, se o projeto tiver chaves SSH existentes
  - O caminho para o novo ficheiro de chave SSH pública, se o projeto não tiver chaves SSH existentes

Terraform

Para adicionar uma chave pública de SSH aos metadados do seu projeto, use o recurso google_compute_project_metadata.

resource "google_compute_project_metadata" "default" {
  metadata = {
    ssh-keys = <<EOF
      dev:ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAILg6UtHDNyMNAh0GjaytsJdrUxjtLy3APXqZfNZhvCeT dev
      test:ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAILg6UtHDNyMNAh0GjaytsJdrUxjtLy3APXqZfNZhvCeT test
    EOF
  }
}

REST

Se existirem chaves SSH nos metadados do projeto, tem de as adicionar novamente aos metadados do projeto sempre que adicionar uma nova chave SSH através da API Compute Engine. Se não voltar a adicionar as chaves existentes, a adição de uma nova chave apaga as chaves existentes.

Para adicionar uma chave pública de SSH aos metadados do projeto através da API Compute Engine, faça o seguinte:

Obtenha os valores fingerprint e ssh-keys dos metadados através do método projects.get

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"}"
}
]
...

Adicione o novo valor ssh-keys através do método projects.setCommonInstanceMetadata.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/setCommonInstanceMetadata

{
"items": [
 {
  "key": "ssh-keys",
  "value": "EXISTING_SSH_KEYS\nNEW_SSH_KEY"
 }
]
"fingerprint": "FINGERPRINT"
}
```
Substitua o seguinte:
- PROJECT_ID: o ID do seu projeto
- EXISTING_SSH_KEYS: o valor da chave ssh-keys da resposta do pedido projects.get
- FINGERPRINT: o valor de fingerprint da resposta do pedido projects.get
- NEW_SSH_KEY: a nova chave SSH, num dos seguintes formatos:
  - Formato de uma chave sem hora de validade:
```
USERNAME:KEY_VALUE
```
  - Formato de uma chave com um período de validade:
```
USERNAME:KEY_VALUE google-ssh {"userName":"USERNAME","expireOn":"EXPIRE_TIME"}
```
  Substitua o seguinte:
  - KEY_VALUE: o valor da chave SSH pública
  - USERNAME: o seu nome de utilizador. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.
    Para VMs Linux, o USERNAME não pode ser root, a menos que configure a VM para permitir o início de sessão de raiz. Para mais informações, consulte o artigo Estabelecer ligação a instâncias como utilizador root.
    
    Para VMs do Windows que usam o Active Directory (AD), o nome de utilizador tem de ter o domínio do AD no início, no formato DOMAIN\. Por exemplo, o utilizador cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.
  - EXPIRE_TIME: a hora em que a chave expira, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000

Adicione chaves SSH aos metadados da instância

Pode adicionar uma chave SSH pública aos metadados da instância quando cria uma VM ou depois de criar uma VM.

Adicione chaves SSH aos metadados da instância durante a criação da VM

Pode adicionar chaves SSH aos metadados da instância durante a criação da VM através da Cloud de Confiance consola, da CLI gcloud ou da API Compute Engine.

Consola

Para criar uma instância e adicionar uma chave pública de SSH aos metadados da instância ao mesmo tempo através da consola Cloud de Confiance , faça o seguinte:

Na Cloud de Confiance consola, aceda à página Criar uma instância.

Aceda a Criar uma instância
Para adicionar uma chave pública de SSH aos metadados da instância, faça o seguinte:
1. No menu de navegação, clique em Segurança.
2. Expanda a secção Gerir acesso.
3. Para desativar o Início de sessão do SO, desmarque a caixa de verificação Controlar o acesso à VM através de autorizações da IAM.
4. Se quiser permitir que as chaves SSH públicas nos metadados do projeto acedam à instância, desmarque a caixa de verificação Bloquear chaves SSH ao nível do projeto.
5. Na secção Adicione chaves SSH geradas manualmente, clique em Adicionar item.
6. Adicione a sua chave pública na caixa de texto. A chave tem de estar num dos seguintes formatos:
  - Formato de uma chave sem hora de validade:
```
KEY_VALUE USERNAME
```
  - Formato de uma chave com um período de validade:
```
KEY_VALUE google-ssh {"userName":"USERNAME","expireOn":"EXPIRE_TIME"}
```
  Substitua o seguinte:
  - KEY_VALUE: o valor da chave SSH pública
  - USERNAME: o seu nome de utilizador. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.
    Para VMs Linux, o USERNAME não pode ser root, a menos que configure a VM para permitir o início de sessão de raiz. Para mais informações, consulte o artigo Estabeleça ligação a VMs do Linux como utilizador root.
    
    Para VMs do Windows que usam o Active Directory (AD), o nome de utilizador tem de ter o domínio do AD no início, no formato DOMAIN\. Por exemplo, o utilizador cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.
  - EXPIRE_TIME: a hora em que a chave expira, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000
Opcional: especifique outras opções de configuração. Para mais informações, consulte o artigo Opções de configuração durante a criação da instância.
Para criar e iniciar a instância, clique em Criar.

gcloud

In the Cloud de Confiance console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Cloud de Confiance console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para criar uma VM e adicionar uma chave pública de SSH aos metadados da instância em simultâneo com a CLI gcloud, use o comando gcloud compute instances create:
```
gcloud compute instances create VM_NAME \
   --metadata=ssh-keys=PUBLIC_KEY
```
Substitua o seguinte:
- VM_NAME: o nome da nova VM
- PUBLIC_KEY: a sua chave SSH pública, num dos seguintes formatos:
  - Formato de uma chave sem hora de validade:
```
USERNAME:KEY_VALUE
```
  - Formato de uma chave com um período de validade:
```
USERNAME:KEY_VALUE google-ssh {"userName":"USERNAME","expireOn":"EXPIRE_TIME"}
```
  Substitua o seguinte:
  - KEY_VALUE: o valor da chave SSH pública
  - USERNAME: o seu nome de utilizador. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.
    Para VMs Linux, o USERNAME não pode ser root, a menos que configure a VM para permitir o início de sessão de raiz. Para mais informações, consulte o artigo Estabelecer ligação a instâncias como utilizador root.
    
    Para VMs do Windows que usam o Active Directory (AD), o nome de utilizador tem de ter o domínio do AD no início, no formato DOMAIN\. Por exemplo, o utilizador cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.
  - EXPIRE_TIME: a hora em que a chave expira, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000
Pode adicionar várias chaves SSH usando a flag --metadata-from-file=ssh-keys=FILE_PATH. No ficheiro, adicione uma lista de nomes de utilizador e chaves SSH públicas num dos formatos anteriores.

Terraform

Para adicionar uma chave pública de SSH aos metadados da instância, use o recurso google_compute_instance.

resource "google_compute_instance" "default" {
  name         = "my-vm"
  machine_type = "n1-standard-1"
  zone         = "us-central1-a"

  boot_disk {
    initialize_params {
      image = "ubuntu-1404-trusty-v20160627"
    }
  }

  # Local SSD disk
  scratch_disk {
    interface = "SCSI"
  }

  network_interface {
    network = "default"
    access_config {}
  }
  metadata = {
    "ssh-keys" = <<EOT
      dev:ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAILg6UtHDNyMNAh0GjaytsJdrUxjtLy3APXqZfNZhvCeT dev
      test:ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAILg6UtHDNyMNAh0GjaytsJdrUxjtLy3APXqZfNZhvCeT test
     EOT
  }
}

REST

Para criar uma VM e adicionar uma chave SSH pública aos metadados da instância ao mesmo tempo através do Compute Engine, crie um pedido POST para o método instances.insert:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

Substitua o seguinte:

PROJECT_ID: o ID do projeto
ZONE: a zona da VM

No corpo do pedido, indique os nomes de utilizador e as chaves SSH públicas na propriedade items:

...
{
 "items": [
    {
     "key": "ssh-keys",
     "value": "PUBLIC_KEY"
    }
   ]
}
...

Substitua PUBLIC_KEY pela sua chave pública num dos seguintes formatos:

Formato de uma chave sem hora de validade:
```
USERNAME:KEY_VALUE
```

Formato de uma chave com um período de validade:

USERNAME:KEY_VALUE google-ssh {"userName":"USERNAME","expireOn":"EXPIRE_TIME"}

Substitua o seguinte:

KEY_VALUE: o valor da chave SSH pública
USERNAME: o seu nome de utilizador. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.
Para VMs Linux, o USERNAME não pode ser root, a menos que configure a VM para permitir o início de sessão de raiz. Para mais informações, consulte o artigo Estabelecer ligação a instâncias como utilizador root.

Para VMs do Windows que usam o Active Directory (AD), o nome de utilizador tem de ter o domínio do AD no início, no formato DOMAIN\. Por exemplo, o utilizador cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.
EXPIRE_TIME: a hora em que a chave expira, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000

Pode adicionar várias chaves SSH adicionando \n entre as chaves.

Adicione chaves SSH aos metadados da instância após a criação da VM

Pode adicionar chaves SSH aos metadados da instância após a criação da VM através da Cloud de Confiance consola, da CLI gcloud ou da API Compute Engine.

Autorizações necessárias para esta tarefa

Para realizar esta tarefa, tem de ter as seguintes autorizações:

compute.instances.setMetadata na VM

Consola

Para adicionar uma chave pública de SSH aos metadados da instância através da Cloud de Confiance consola, faça o seguinte:

Na Cloud de Confiance consola, aceda à página Instâncias de VM.

Aceder a Instâncias de VM
Clique no nome da VM à qual quer adicionar uma chave SSH.
Clique em Edit.
Em Chaves SSH, clique em Adicionar item.
Adicione a sua chave pública na caixa de texto. A chave tem de estar num dos seguintes formatos:
- Formato de uma chave sem hora de validade:
```
KEY_VALUE USERNAME
```
- Formato de uma chave com um período de validade:
```
KEY_VALUE google-ssh {"userName":"USERNAME","expireOn":"EXPIRE_TIME"}
```
Substitua o seguinte:
- KEY_VALUE: o valor da chave SSH pública
- USERNAME: o seu nome de utilizador. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.
  Para VMs Linux, o USERNAME não pode ser root, a menos que configure a VM para permitir o início de sessão de raiz. Para mais informações, consulte o artigo Estabeleça ligação a VMs do Linux como utilizador root.
  
  Para VMs do Windows que usam o Active Directory (AD), o nome de utilizador tem de ter o domínio do AD no início, no formato DOMAIN\. Por exemplo, o utilizador cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.
- EXPIRE_TIME: a hora em que a chave expira, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000
Clique em Guardar.

gcloud

In the Cloud de Confiance console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Cloud de Confiance console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Se existirem chaves SSH nos metadados da instância, tem de as adicionar novamente aos metadados da instância sempre que adicionar uma nova chave SSH através da CLI gcloud. Se não voltar a adicionar as chaves existentes, a adição de uma nova chave apaga as chaves existentes.

Para adicionar uma chave SSH pública aos metadados da instância através da CLI gcloud, faça o seguinte:
1. Se a sua VM já tiver chaves SSH públicas ao nível da instância, obtenha-as a partir dos metadados e adicione-as a um novo ficheiro:
  1. 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 precisa de adicionar ou remover chaves SSH públicas.
    
    O resultado é semelhante ao 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"}
...
```
  2. Copie o valor de metadados ssh-keys.
  3. Crie e abra um novo ficheiro de texto na sua estação de trabalho.
  4. No ficheiro, cole a lista de chaves que acabou de copiar.
  5. Adicione a nova chave no final da lista, num dos seguintes formatos:
  - Formato de uma chave sem hora de validade:
```
USERNAME:KEY_VALUE
```
  - Formato de uma chave com um período de validade:
```
USERNAME:KEY_VALUE google-ssh {"userName":"USERNAME","expireOn":"EXPIRE_TIME"}
```
  Substitua o seguinte:
  - KEY_VALUE: o valor da chave SSH pública
  - USERNAME: o seu nome de utilizador. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.
    Para VMs Linux, o USERNAME não pode ser root, a menos que configure a VM para permitir o início de sessão de raiz. Para mais informações, consulte o artigo Estabelecer ligação a instâncias como utilizador root.
    
    Para VMs do Windows que usam o Active Directory (AD), o nome de utilizador tem de ter o domínio do AD no início, no formato DOMAIN\. Por exemplo, o utilizador cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.
  - EXPIRE_TIME: a hora em que a chave expira, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000
  1. Guarde e feche o ficheiro.
2. Execute o comando gcloud compute instances add-metadata para definir o valor de ssh-keys:
```
gcloud compute instances add-metadata VM_NAME --metadata-from-file ssh-keys=KEY_FILE
```
  Substitua o seguinte:
  - VM_NAME: a VM à qual quer adicionar a chave SSH
  - KEY_FILE com uma das seguintes opções:
  - O caminho para o ficheiro que criou no passo anterior, se a VM tiver chaves SSH existentes
  - O caminho para o novo ficheiro de chave SSH pública, se a VM não tiver chaves SSH existentes

REST

Se existirem chaves SSH nos metadados da instância, tem de adicioná-las novamente aos metadados da instância sempre que adicionar uma nova chave SSH através da API Compute Engine. Se não voltar a adicionar as chaves existentes, a adição de uma nova chave apaga as chaves existentes.

Para adicionar uma chave SSH pública aos metadados da instância através da API Compute Engine, faça o seguinte:

Obtenha os valores fingerprint e ssh-keys dos metadados através do método instances.get.

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 à qual adicionar uma chave SSH
VM_NAME: a VM para a qual está a adicionar 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"}"
}
]
...

Adicione o novo valor ssh-keys através do método instances.setMetadata.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMetadata

{
"items": [
 {
  "key": "ssh-keys",
  "value": "EXISTING_SSH_KEYS\nNEW_SSH_KEY"
 }
]
"fingerprint": "FINGERPRINT"
}
```
Substitua o seguinte:
- PROJECT_ID: o ID do seu projeto
- EXISTING_SSH_KEYS: o valor da chave ssh-keys da resposta do pedido instances.get
- FINGERPRINT: o fingerprint da resposta do pedido projects.get
- NEW_SSH_KEY: a nova chave SSH, num dos seguintes formatos:
  - Formato de uma chave sem hora de validade:
```
USERNAME:KEY_VALUE
```
  - Formato de uma chave com um período de validade:
```
USERNAME:KEY_VALUE google-ssh {"userName":"USERNAME","expireOn":"EXPIRE_TIME"}
```
  Substitua o seguinte:
  - KEY_VALUE: o valor da chave SSH pública
  - USERNAME: o seu nome de utilizador. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.
    Para VMs Linux, o USERNAME não pode ser root, a menos que configure a VM para permitir o início de sessão de raiz. Para mais informações, consulte o artigo Estabelecer ligação a instâncias como utilizador root.
    
    Para VMs do Windows que usam o Active Directory (AD), o nome de utilizador tem de ter o domínio do AD no início, no formato DOMAIN\. Por exemplo, o utilizador cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.
  - EXPIRE_TIME: a hora em que a chave expira, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000

O que se segue?

Saiba como estabelecer ligação a VMs.
Saiba como transferir ficheiros para VMs.
Saiba como as ligações SSH a VMs Linux funcionam no Compute Engine.

Adicione chaves SSH a VMs

Antes de começar

Console

gcloud

Terraform

REST

Adicione chaves SSH a VMs que usam chaves SSH baseadas em metadados

Adicione chaves SSH aos metadados do projeto

Autorizações necessárias para esta tarefa

Consola

gcloud

Terraform

REST

Adicione chaves SSH aos metadados da instância

Adicione chaves SSH aos metadados da instância durante a criação da VM

Consola

gcloud

Terraform

REST

Adicione chaves SSH aos metadados da instância após a criação da VM

Autorizações necessárias para esta tarefa

Consola

gcloud

REST

O que se segue?