Agrega claves SSH a las VM

Console

Para agregar una clave SSH pública a los metadatos del proyecto con la consola deTrusted Cloud , haz lo siguiente:

1. En la consola de Trusted Cloud , ve a la página Metadatos.

   Ir a metadatos

2. Haz clic en la pestaña Claves SSH.

3. Haz clic en Editar.

4. Haz clic en Agregar elemento.

5. En el campo Clave SSH que se abre, agrega tu clave SSH pública. La clave debe tener uno de los siguientes formatos:

   • Formato para una clave sin una hora de vencimiento:

     KEY_VALUE USERNAME

   • Formato para una clave con una hora de vencimiento:

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

   Reemplaza lo siguiente:

   • KEY_VALUE: El valor de la clave SSH pública
   • USERNAME: tu nombre de usuario. Por ejemplo, cloudysanfrancisco o cloudysanfrancisco_gmail_com.

     Para las VM de Linux, USERNAME no puede ser root, a menos que configures tu VM para permitir el acceso raíz. Para obtener más información, consulta Conéctate a VMs de Linux como usuario raíz.

     Para las VM de Windows que usan Active Directory (AD), el nombre de usuario debe estar agregado al dominio de AD, en el formato DOMAIN\. Por ejemplo, el usuario cloudysanfrancisco dentro del AD ad.example.com tiene un USERNAME de example\cloudysanfrancisco.

   • EXPIRE_TIME: La hora en que vence la clave, en formato ISO 8601. Por ejemplo: 2021-12-04T20:12:00+0000

6. Haz clic en Guardar.

gcloud

In the Trusted Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Trusted Cloud 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.

1. Si hay claves SSH existentes en los metadatos del proyecto, debes volver a agregarlas a los metadatos del proyecto cada vez que agregues una clave SSH nueva mediante la CLI de gcloud. Si no vuelves a agregar tus claves actuales, agregar una nueva borrará las existentes.

   Para agregar una clave SSH pública a los metadatos del proyecto con la CLI de gcloud, haz lo siguiente:

   1. Si tu proyecto ya tiene claves SSH públicas de nivel de proyecto, obtén esos metadatos y agrégalos a un archivo nuevo:

      1. Ejecuta el comando gcloud compute project-info describe a fin de obtener las claves SSH para el proyecto:

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

         El resultado es similar a este:

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

      2. Copia el valor de metadatos ssh-keys.

      3. Crea y abre un nuevo archivo de texto en tu estación de trabajo.

      4. En el archivo, pega la lista de las claves que acabas de copiar.

      5. Agrega la clave nueva al final de la lista en uno de los siguientes formatos:

         • Formato para una clave sin una hora de vencimiento:

           USERNAME:KEY_VALUE

         • Formato para una clave con una hora de vencimiento:

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

         Reemplaza lo siguiente:

         • KEY_VALUE: El valor de la clave SSH pública
         • USERNAME: tu nombre de usuario. Por ejemplo: cloudysanfrancisco o cloudysanfrancisco_gmail_com.

           Para las VM de Linux, USERNAME no puede ser root, a menos que configures tu VM para permitir el acceso raíz. Para obtener más información, consulta Conéctate a instancias como usuario raíz.

           Para las VM de Windows que usan Active Directory (AD), el nombre de usuario debe estar agregado al dominio de AD, en el formato DOMAIN\. Por ejemplo, el usuario cloudysanfrancisco dentro del AD ad.example.com tiene un USERNAME de example\cloudysanfrancisco.

         • EXPIRE_TIME: La hora en que vence la clave, en formato ISO 8601. Por ejemplo: 2021-12-04T20:12:00+0000

      6. Guarde y cierre el archivo.

   2. Ejecuta el comando gcloud compute project-info add-metadata a fin de configurar el valor ssh-keys de todo el proyecto:

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

      Reemplaza KEY_FILE por uno de los siguientes valores:

      • La ruta de acceso al archivo que creaste en el paso anterior, si el proyecto tenía claves SSH existentes
      • La ruta de acceso a tu nuevo archivo de claves SSH públicas, si el proyecto no tenía claves SSH existentes

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

Console

Para crear una instancia y agregar una clave SSH pública a los metadatos de la instancia al mismo tiempo con la consola de Trusted Cloud , haz lo siguiente:

1. En la consola de Trusted Cloud , ve a la página Crear una instancia.

   Ir a Crear una instancia

2. Para agregar una clave SSH pública a los metadatos de la instancia, haz lo siguiente:

   1. En el menú de navegación, haz clic en Seguridad.

   2. Expande la sección Administrar acceso.

   3. Para inhabilitar el acceso al SO, desmarca la casilla de verificación Controlar el acceso a la VM a través de permisos de IAM.

   4. Si quieres permitir que las llaves SSH públicas en los metadatos del proyecto accedan a la instancia, desmarca la casilla de verificación Bloquear llaves SSH de nivel de proyecto.

   5. En la sección Agregar claves SSH generadas manualmente, haz clic en Agregar elemento.

   6. Agrega tu clave pública en el cuadro de texto. La clave debe tener uno de los siguientes formatos:

      • Formato para una clave sin una hora de vencimiento:

        KEY_VALUE USERNAME

      • Formato para una clave con una hora de vencimiento:

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

      Reemplaza lo siguiente:

      • KEY_VALUE: El valor de la clave SSH pública
      • USERNAME: tu nombre de usuario. Por ejemplo, cloudysanfrancisco o cloudysanfrancisco_gmail_com.

        Para las VM de Linux, USERNAME no puede ser root, a menos que configures tu VM para permitir el acceso raíz. Para obtener más información, consulta Conéctate a VMs de Linux como usuario raíz.

        Para las VM de Windows que usan Active Directory (AD), el nombre de usuario debe estar agregado al dominio de AD, en el formato DOMAIN\. Por ejemplo, el usuario cloudysanfrancisco dentro del AD ad.example.com tiene un USERNAME de example\cloudysanfrancisco.

      • EXPIRE_TIME: La hora en que vence la clave, en formato ISO 8601. Por ejemplo: 2021-12-04T20:12:00+0000

3. Opcional: Especifica otros parámetros de configuración. Para obtener más información, consulta Opciones de configuración durante la creación de instancias.

4. Para crear y, luego, iniciar la instancia, haz clic en Crear.

gcloud

1. In the Trusted Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Trusted Cloud 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.

2. Para crear una VM y agregar una clave SSH pública a los metadatos de la instancia al mismo tiempo mediante la CLI de gcloud, usa el gcloud compute instances createcomando :

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

   Reemplaza lo siguiente:

   • VM_NAME: es el nombre de la VM nueva.

   • PUBLIC_KEY: Es tu clave SSH pública, en uno de los siguientes formatos:

     • Formato para una clave sin una hora de vencimiento:

       USERNAME:KEY_VALUE

     • Formato para una clave con una hora de vencimiento:

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

     Reemplaza lo siguiente:

     • KEY_VALUE: El valor de la clave SSH pública
     • USERNAME: tu nombre de usuario. Por ejemplo: cloudysanfrancisco o cloudysanfrancisco_gmail_com.

       Para las VM de Linux, USERNAME no puede ser root, a menos que configures tu VM para permitir el acceso raíz. Para obtener más información, consulta Conéctate a instancias como usuario raíz.

       Para las VM de Windows que usan Active Directory (AD), el nombre de usuario debe estar agregado al dominio de AD, en el formato DOMAIN\. Por ejemplo, el usuario cloudysanfrancisco dentro del AD ad.example.com tiene un USERNAME de example\cloudysanfrancisco.

     • EXPIRE_TIME: La hora en que vence la clave, en formato ISO 8601. Por ejemplo: 2021-12-04T20:12:00+0000

   Puedes agregar varias claves SSH mediante la marca --metadata-from-file=ssh-keys=FILE_PATH. En el archivo, agrega una lista de nombres de usuario y claves SSH públicas en uno de los formatos anteriores.

Terraform

Para agregar una clave SSH pública a los metadatos de la instancia, usa el 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 crear una VM y agregar una clave SSH pública a los metadatos de la instancia al mismo tiempo mediante Compute Engine, crea una solicitud POST para el método instances.insert:

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

Reemplaza lo siguiente:

• PROJECT_ID: El ID del proyecto
• ZONE: La zona de la VM

En el cuerpo de la solicitud, proporciona los nombres de usuario y las claves SSH públicas en la propiedad items:

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

Reemplaza PUBLIC_KEY por tu clave pública, en uno de los siguientes formatos:

• Formato para una clave sin una hora de vencimiento:

  USERNAME:KEY_VALUE

• Formato para una clave con una hora de vencimiento:

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

Reemplaza lo siguiente:

• KEY_VALUE: El valor de la clave SSH pública
• USERNAME: tu nombre de usuario. Por ejemplo: cloudysanfrancisco o cloudysanfrancisco_gmail_com.

  Para las VM de Linux, USERNAME no puede ser root, a menos que configures tu VM para permitir el acceso raíz. Para obtener más información, consulta Conéctate a instancias como usuario raíz.

  Para las VM de Windows que usan Active Directory (AD), el nombre de usuario debe estar agregado al dominio de AD, en el formato DOMAIN\. Por ejemplo, el usuario cloudysanfrancisco dentro del AD ad.example.com tiene un USERNAME de example\cloudysanfrancisco.

• EXPIRE_TIME: La hora en que vence la clave, en formato ISO 8601. Por ejemplo: 2021-12-04T20:12:00+0000

Para agregar varias claves SSH, agrega \n entre las claves.

Console

Para agregar una clave SSH pública a los metadatos de la instancia con la consola deTrusted Cloud , haz lo siguiente:

1. En la Trusted Cloud consola, ve a la página Instancias de VM.

   Ir a Instancias de VM

2. Haz clic en el nombre de la VM para la que quieres agregar una clave SSH.

3. Haz clic en Editar.

4. En Llaves SSH, haz clic en Agregar elemento.

5. Agrega tu clave pública al cuadro de texto. La clave debe tener uno de los siguientes formatos:

   • Formato para una clave sin una hora de vencimiento:

     KEY_VALUE USERNAME

   • Formato para una clave con una hora de vencimiento:

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

   Reemplaza lo siguiente:

   • KEY_VALUE: El valor de la clave SSH pública
   • USERNAME: tu nombre de usuario. Por ejemplo, cloudysanfrancisco o cloudysanfrancisco_gmail_com.

     Para las VM de Linux, USERNAME no puede ser root, a menos que configures tu VM para permitir el acceso raíz. Para obtener más información, consulta Conéctate a VMs de Linux como usuario raíz.

     Para las VM de Windows que usan Active Directory (AD), el nombre de usuario debe estar agregado al dominio de AD, en el formato DOMAIN\. Por ejemplo, el usuario cloudysanfrancisco dentro del AD ad.example.com tiene un USERNAME de example\cloudysanfrancisco.

   • EXPIRE_TIME: La hora en que vence la clave, en formato ISO 8601. Por ejemplo: 2021-12-04T20:12:00+0000

6. Haz clic en Guardar.

gcloud

1. In the Trusted Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Trusted Cloud 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.

2. Si hay claves SSH existentes en los metadatos de la instancia, debes volver a agregarlas a los metadatos de la instancia cada vez que agregues una llave SSH nueva con la CLI de gcloud. Si no vuelves a agregar tus claves actuales, agregar una nueva borrará las existentes.

   Para agregar una clave SSH pública a los metadatos de la instancia mediante la CLI de gcloud, haz lo siguiente:

   1. Si tu VM ya tiene claves SSH públicas de nivel de instancia, obtén esas claves de los metadatos y agrégalas a un archivo nuevo:

      1. Ejecuta el comando gcloud compute instances describe a fin de obtener los metadatos para la VM:

         gcloud compute instances describe VM_NAME
         

         Reemplaza VM_NAME por el nombre de la VM para la que necesitas agregar o quitar las claves SSH públicas.

         El resultado es similar a este:

         ...
         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. Copia el valor de metadatos ssh-keys.

      3. Crea y abre un nuevo archivo de texto en tu estación de trabajo.

      4. En el archivo, pega la lista de las claves que acabas de copiar.

      5. Agrega la clave nueva al final de la lista en uno de los siguientes formatos:

      • Formato para una clave sin una hora de vencimiento:

        USERNAME:KEY_VALUE

      • Formato para una clave con una hora de vencimiento:

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

      Reemplaza lo siguiente:

      • KEY_VALUE: El valor de la clave SSH pública
      • USERNAME: tu nombre de usuario. Por ejemplo: cloudysanfrancisco o cloudysanfrancisco_gmail_com.

        Para las VM de Linux, USERNAME no puede ser root, a menos que configures tu VM para permitir el acceso raíz. Para obtener más información, consulta Conéctate a instancias como usuario raíz.

        Para las VM de Windows que usan Active Directory (AD), el nombre de usuario debe estar agregado al dominio de AD, en el formato DOMAIN\. Por ejemplo, el usuario cloudysanfrancisco dentro del AD ad.example.com tiene un USERNAME de example\cloudysanfrancisco.

      • EXPIRE_TIME: La hora en que vence la clave, en formato ISO 8601. Por ejemplo: 2021-12-04T20:12:00+0000
      1. Guarde y cierre el archivo.

   2. Ejecuta el comando gcloud compute instances add-metadata para configurar el valor ssh-keys:

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

      Reemplaza lo siguiente:

      • VM_NAME: Es la VM a la que deseas agregar la clave SSH
      • KEY_FILE por uno de los siguientes valores:
      • La ruta al archivo que creaste en el paso anterior, si la VM tenía claves SSH existentes
      • La ruta a tu nuevo archivo de claves SSH públicas, si la VM no tenía claves SSH existentes

REST

Si hay claves SSH existentes en los metadatos de la instancia, debes volver a agregarlas a los metadatos de la instancia cada vez que agregues una nueva clave SSH mediante la API de Compute Engine. Si no vuelves a agregar tus claves actuales, agregar una nueva borrará las existentes.

Para agregar una clave SSH pública a los metadatos de la instancia con la API de Compute Engine, haz lo siguiente:

1. Obtén los valores fingerprint y ssh-keys de los metadatos mediante el método instances.get.

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

   Reemplaza lo siguiente:

   • PROJECT_ID: El ID de tu proyecto
   • ZONE: Es la zona de la VM para agregar una clave SSH.
   • VM_NAME: Es la VM para la que agregarás una clave SSH.

   La respuesta es similar al ejemplo a continuación:

   ...
   "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. Agrega el valor ssh-keys nuevo con el 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"
   }
   

   Reemplaza lo siguiente:

   • PROJECT_ID: El ID de tu proyecto
   • EXISTING_SSH_KEYS: Es el valor de la clave ssh-keys de la respuesta de la solicitud instances.get.
   • FINGERPRINT: la fingerprint de la respuesta de la solicitud projects.get

   • NEW_SSH_KEY: Es la nueva clave SSH, en uno de los siguientes formatos:

     • Formato para una clave sin una hora de vencimiento:

       USERNAME:KEY_VALUE

     • Formato para una clave con una hora de vencimiento:

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

     Reemplaza lo siguiente:

     • KEY_VALUE: El valor de la clave SSH pública
     • USERNAME: tu nombre de usuario. Por ejemplo: cloudysanfrancisco o cloudysanfrancisco_gmail_com.

       Para las VM de Linux, USERNAME no puede ser root, a menos que configures tu VM para permitir el acceso raíz. Para obtener más información, consulta Conéctate a instancias como usuario raíz.

       Para las VM de Windows que usan Active Directory (AD), el nombre de usuario debe estar agregado al dominio de AD, en el formato DOMAIN\. Por ejemplo, el usuario cloudysanfrancisco dentro del AD ad.example.com tiene un USERNAME de example\cloudysanfrancisco.

     • EXPIRE_TIME: La hora en que vence la clave, en formato ISO 8601. Por ejemplo: 2021-12-04T20:12:00+0000