Adicionar chaves SSH a VMs

Console

Para adicionar uma chave SSH pública aos metadados do projeto usando o consoleCloud de Confiance , faça o seguinte:

1. No Cloud de Confiance console, acesse a página Metadados.

   Acessar a página "Metadados"

2. Clique na guia Chaves SSH.

3. Clique em Editar.

4. Clique em Adicionar item.

5. No campo Chave SSH que abrir, adicione sua chave SSH pública. A compactação precisa estar em um dos seguintes formatos:

   • Formato de uma chave sem prazo de validade:

     KEY_VALUE USERNAME

   • Formato de uma chave com prazo de validade:

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

   Substitua:

   • KEY_VALUE: o valor da chave SSH pública
   • USERNAME: seu nome de usuário. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.

     Em VMs do Linux, o USERNAME não pode ser root, a menos que você configure sua VM para permitir login raiz. Para mais informações, consulte Conectar-se a VMs do Linux como usuário raiz.

     Em VMs do Windows que usam o Active Directory (AD), o nome de usuário precisa ser anexado ao domínio do AD no formato DOMAIN\. Por exemplo, o usuário cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.

   • EXPIRE_TIME: o tempo de expiração da chave, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000

6. Clique em Salvar.

gcloud

No console do Cloud de Confiance , ative o Cloud Shell.

Ativar o Cloud Shell

Na parte de baixo do console Cloud de Confiance , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

1. Se houver chaves SSH nos metadados do projeto, será necessário adicioná-las novamente aos metadados do projeto sempre que adicionar uma nova chave SSH usando a CLI gcloud. Se você não adicionar novamente as chaves existentes, adicionar uma nova chave apagará as atuais.

   Para adicionar uma chave SSH pública aos metadados do projeto usando a CLI gcloud, faça o seguinte:

   1. Se o projeto já tiver chaves SSH públicas em todo o projeto, acesse-as dos metadados e adicione-as a um novo arquivo:

      1. Execute o comando gcloud compute project-info describe para receber as chaves SSH do projeto:

         gcloud compute project-info describe \
          --format="value(commonInstanceMetadata[items][ssh-keys])"
         

         O resultado será assim:

         username:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ... username:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ...
         

      2. Copie o valor de metadados ssh-keys.

      3. Crie e abra um novo arquivo de texto na estação de trabalho.

      4. No arquivo, cole a lista de chaves que você acabou de copiar.

      5. Adicione a nova chave no final da lista em um dos seguintes formatos:

         • Formato de uma chave sem prazo de validade:

           USERNAME:KEY_VALUE

         • Formato de uma chave com prazo de validade:

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

         Substitua:

         • KEY_VALUE: o valor da chave SSH pública
         • USERNAME: seu nome de usuário. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.

           Em VMs do Linux, o USERNAME não pode ser root, a menos que você configure sua VM para permitir login raiz. Para mais informações, consulte Como se conectar a instâncias como usuário raiz.

           Em VMs do Windows que usam o Active Directory (AD), o nome de usuário precisa ser anexado ao domínio do AD no formato DOMAIN\. Por exemplo, o usuário cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.

         • EXPIRE_TIME: o tempo de expiração da chave, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000

      6. Salve e feche o arquivo.

   2. Execute o comando gcloud compute project-info add-metadata para definir o valor ssh-keys de todo o projeto:

      gcloud compute project-info add-metadata --metadata-from-file=ssh-keys=KEY_FILE
      

      Substitua KEY_FILE por um dos seguintes:

      • Caminho para o arquivo criado na etapa anterior, se o projeto tiver chaves SSH atuais
      • O caminho para o novo arquivo de chave SSH pública, caso o projeto não tenha chaves SSH atuais

Terraform

Para adicionar uma chave SSH pública aos metadados do 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 houver chaves SSH nos metadados do projeto, você precisará adicioná-las novamente aos metadados sempre que adicionar uma nova chave SSH usando a API Compute Engine. Se você não adicionar novamente as chaves existentes, adicionar uma nova chave apagará as atuais.

Para adicionar uma chave SSH pública aos metadados do projeto usando a API Compute Engine, faça o seguinte:

1. Para receber os valores fingerprint e ssh-keys dos metadados, use o método projects.get

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID
   

   Substitua PROJECT_ID pela ID do seu projeto.

   A resposta é semelhante a:

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

2. Adicione o novo valor de ssh-keys usando o 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:

   • PROJECT_ID: o ID do projeto
   • EXISTING_SSH_KEYS: o valor da chave ssh-keys da resposta da solicitação projects.get;
   • FINGERPRINT: o valor do fingerprint da resposta da solicitação projects.get

   • NEW_SSH_KEY: a nova chave SSH em um dos seguintes formatos:

     • Formato de uma chave sem prazo de validade:

       USERNAME:KEY_VALUE

     • Formato de uma chave com prazo de validade:

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

     Substitua:

     • KEY_VALUE: o valor da chave SSH pública
     • USERNAME: seu nome de usuário. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.

       Em VMs do Linux, o USERNAME não pode ser root, a menos que você configure sua VM para permitir login raiz. Para mais informações, consulte Como se conectar a instâncias como usuário raiz.

       Em VMs do Windows que usam o Active Directory (AD), o nome de usuário precisa ser anexado ao domínio do AD no formato DOMAIN\. Por exemplo, o usuário cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.

     • EXPIRE_TIME: o tempo de expiração da chave, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000

Console

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

1. No console do Cloud de Confiance , acesse a página Criar uma instância.

   Acesse "Criar uma instância"

2. Para adicionar uma chave SSH pública aos metadados da instância, faça o seguinte:

   1. No menu de navegação, clique em Segurança.

   2. Expanda a seção Gerenciar acesso.

   3. Para desativar o Login do SO, desmarque a caixa de seleção Controlar o acesso à VM pelas permissões do IAM.

   4. Se você quiser permitir que chaves SSH públicas nos metadados do projeto acessem a instância, desmarque a caixa de seleção Bloquear chaves SSH em todo o projeto.

   5. Na seção Adicionar chaves SSH geradas manualmente, clique em Adicionar item.

   6. Adicione sua chave pública na caixa de texto. A compactação precisa estar em um dos seguintes formatos:

      • Formato de uma chave sem prazo de validade:

        KEY_VALUE USERNAME

      • Formato de uma chave com prazo de validade:

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

      Substitua:

      • KEY_VALUE: o valor da chave SSH pública
      • USERNAME: seu nome de usuário. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.

        Em VMs do Linux, o USERNAME não pode ser root, a menos que você configure sua VM para permitir login raiz. Para mais informações, consulte Conectar-se a VMs do Linux como usuário raiz.

        Em VMs do Windows que usam o Active Directory (AD), o nome de usuário precisa ser anexado ao domínio do AD no formato DOMAIN\. Por exemplo, o usuário cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.

      • EXPIRE_TIME: o tempo de expiração da chave, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000

3. Opcional: especifique outras opções de configuração. Para mais informações, consulte Opções de configuração durante a criação da instância.

4. Para criar e iniciar a instância, clique em Criar.

gcloud

1. No console do Cloud de Confiance , ative o Cloud Shell.

   Ativar o Cloud Shell

   Na parte de baixo do console Cloud de Confiance , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

2. Para criar uma VM e adicionar uma chave SSH pública aos metadados da instância enquanto usa a CLI gcloud use o comando gcloud compute instances create:

   gcloud compute instances create VM_NAME \
      --metadata=ssh-keys=PUBLIC_KEY
   

   Substitua:

   • VM_NAME: o nome da nova VM.

   • PUBLIC_KEY: sua chave SSH pública, em um dos seguintes formatos:

     • Formato de uma chave sem prazo de validade:

       USERNAME:KEY_VALUE

     • Formato de uma chave com prazo de validade:

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

     Substitua:

     • KEY_VALUE: o valor da chave SSH pública
     • USERNAME: seu nome de usuário. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.

       Em VMs do Linux, o USERNAME não pode ser root, a menos que você configure sua VM para permitir login raiz. Para mais informações, consulte Como se conectar a instâncias como usuário raiz.

       Em VMs do Windows que usam o Active Directory (AD), o nome de usuário precisa ser anexado ao domínio do AD no formato DOMAIN\. Por exemplo, o usuário cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.

     • EXPIRE_TIME: o tempo de expiração da chave, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000

   É possível adicionar várias chaves SSH usando a sinalização --metadata-from-file=ssh-keys=FILE_PATH. No arquivo, adicione uma lista de nomes de usuário e chaves SSH públicas em um dos formatos anteriores.

Terraform

Para adicionar uma chave SSH pública 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 usando o Compute Engine, crie uma solicitação POST para o método instances.insert:

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

Substitua:

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

No corpo da solicitação, forneça nomes de usuário e chaves SSH públicas na propriedade items:

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

Substitua PUBLIC_KEY pela sua chave pública em um dos formatos a seguir:

• Formato de uma chave sem prazo de validade:

  USERNAME:KEY_VALUE

• Formato de uma chave com prazo de validade:

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

Substitua:

• KEY_VALUE: o valor da chave SSH pública
• USERNAME: seu nome de usuário. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.

  Em VMs do Linux, o USERNAME não pode ser root, a menos que você configure sua VM para permitir login raiz. Para mais informações, consulte Como se conectar a instâncias como usuário raiz.

  Em VMs do Windows que usam o Active Directory (AD), o nome de usuário precisa ser anexado ao domínio do AD no formato DOMAIN\. Por exemplo, o usuário cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.

• EXPIRE_TIME: o tempo de expiração da chave, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000

É possível adicionar várias chaves SSH adicionando \n entre chaves.

Console

Para adicionar uma chave SSH pública aos metadados da instância usando o consoleCloud de Confiance , faça o seguinte:

1. No console do Cloud de Confiance , acesse a página Instâncias de VM.

   Acessar instâncias de VM

2. Clique no nome da VM à qual você quer adicionar uma chave SSH.

3. Clique em Editar.

4. Em Chaves SSH, clique em Adicionar item.

5. Adicione sua chave pública na caixa de texto. A chave precisa estar em um dos seguintes formatos:

   • Formato de uma chave sem prazo de validade:

     KEY_VALUE USERNAME

   • Formato de uma chave com prazo de validade:

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

   Substitua:

   • KEY_VALUE: o valor da chave SSH pública
   • USERNAME: seu nome de usuário. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.

     Em VMs do Linux, o USERNAME não pode ser root, a menos que você configure sua VM para permitir login raiz. Para mais informações, consulte Conectar-se a VMs do Linux como usuário raiz.

     Em VMs do Windows que usam o Active Directory (AD), o nome de usuário precisa ser anexado ao domínio do AD no formato DOMAIN\. Por exemplo, o usuário cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.

   • EXPIRE_TIME: o tempo de expiração da chave, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000

6. Clique em Salvar.

gcloud

1. No console do Cloud de Confiance , ative o Cloud Shell.

   Ativar o Cloud Shell

   Na parte de baixo do console Cloud de Confiance , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

2. Se houver chaves SSH nos metadados da instância, você deverá adicioná-las novamente aos metadados da instância sempre que adicionar uma nova chave SSH usando a CLI gcloud. Se você não adicionar novamente as chaves atuais, adicionar uma nova chave apagará as atuais.

   Para adicionar uma chave SSH pública aos metadados da instância usando a CLI gcloud, faça o seguinte:

   1. Se a VM já tiver chaves SSH públicas no nível da instância, solicite-as dos metadados e adicione-as a um novo arquivo:

      1. Execute o comando gcloud compute instances describe para receber os metadados da VM:

         gcloud compute instances describe VM_NAME
         

         Substitua VM_NAME pelo nome da VM em que você precisa adicionar ou remover as chaves SSH públicas.

         A saída será assim:

         ...
         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 arquivo de texto na estação de trabalho.

      4. No arquivo, cole a lista de chaves que você acabou de copiar.

      5. Adicione a nova chave no final da lista em um dos seguintes formatos:

      • Formato de uma chave sem prazo de validade:

        USERNAME:KEY_VALUE

      • Formato de uma chave com prazo de validade:

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

      Substitua:

      • KEY_VALUE: o valor da chave SSH pública
      • USERNAME: seu nome de usuário. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.

        Em VMs do Linux, o USERNAME não pode ser root, a menos que você configure sua VM para permitir login raiz. Para mais informações, consulte Como se conectar a instâncias como usuário raiz.

        Em VMs do Windows que usam o Active Directory (AD), o nome de usuário precisa ser anexado ao domínio do AD no formato DOMAIN\. Por exemplo, o usuário cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.

      • EXPIRE_TIME: o tempo de expiração da chave, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000
      1. Salve e feche o arquivo.

   2. Execute o comando gcloud compute instances add-metadata para definir o valor ssh-keys:

      gcloud compute instances add-metadata VM_NAME --metadata-from-file ssh-keys=KEY_FILE
      

      Substitua:

      • VM_NAME: a VM a que você quer adicionar a chave SSH.
      • KEY_FILE por um destes procedimentos:
      • O caminho para o arquivo criado na etapa anterior, se a VM tiver chaves SSH atuais
      • O caminho para o novo arquivo de chave SSH pública, se a VM não tiver chaves SSH atuais

REST

Se houver chaves SSH nos metadados da instância, você deverá adicioná-las novamente aos metadados da instância sempre que adicionar uma nova chave SSH usando a API Compute Engine. Se você não adicionar novamente as chaves atuais, adicionar uma nova chave apagará as atuais.

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

1. Para receber os valores fingerprint e ssh-keys dos metadados, use o método instances.get.

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

   Substitua:

   • PROJECT_ID: ID do projeto
   • ZONE: a zona da VM para adicionar uma chave SSH.
   • VM_NAME: a VM a que você está adicionando uma chave SSH.

   A resposta é semelhante a:

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

2. Adicione o novo valor de ssh-keys usando o 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:

   • PROJECT_ID: o ID do projeto
   • EXISTING_SSH_KEYS: o valor da chave ssh-keys da resposta da solicitação instances.get.
   • FINGERPRINT: o fingerprint da resposta da solicitação projects.get.

   • NEW_SSH_KEY: a nova chave SSH em um dos seguintes formatos:

     • Formato de uma chave sem prazo de validade:

       USERNAME:KEY_VALUE

     • Formato de uma chave com prazo de validade:

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

     Substitua:

     • KEY_VALUE: o valor da chave SSH pública
     • USERNAME: seu nome de usuário. Por exemplo, cloudysanfrancisco ou cloudysanfrancisco_gmail_com.

       Em VMs do Linux, o USERNAME não pode ser root, a menos que você configure sua VM para permitir login raiz. Para mais informações, consulte Como se conectar a instâncias como usuário raiz.

       Em VMs do Windows que usam o Active Directory (AD), o nome de usuário precisa ser anexado ao domínio do AD no formato DOMAIN\. Por exemplo, o usuário cloudysanfrancisco no AD ad.example.com tem um USERNAME de example\cloudysanfrancisco.

     • EXPIRE_TIME: o tempo de expiração da chave, no formato ISO 8601. Por exemplo: 2021-12-04T20:12:00+0000