Skip to main content

Agregar una clave SSH nueva a tu cuenta de GitHub

Para configurar tu cuenta en GitHub.com para utilizar tu clave SSH nueva (o existente), también necesitarás agregar la clave a tu cuenta.

Acerca de la adición de claves SSH a tu cuenta

Puedes acceder a datos y escribirlos en repositorios en GitHub.com mediante SSH (protocolo Secure Shell). Al conectarse a través de SSH, se realiza la autenticación mediante un archivo de clave privada en el equipo local. Para obtener más información, consulta "Acerca de SSH".

También puedes usar SSH para firmar confirmaciones y etiquetas. Para obtener más información sobre la firma de una confirmación, consulta "Acerca de la comprobación de firma de las confirmaciones".

Después de generar un par de claves SSH, debes agregar la clave pública a GitHub.com para habilitar el acceso SSH para tu cuenta.

Prerrequisitos

Antes de agregar una clave SSH nueva a tu cuenta en GitHub.com, completa estos pasos.

  1. Verifica las claves SSH existente. Para obtener más información, consulta "Comprobar tus claves SSH existentes".
  2. Genera una nueva clave SSH y agrégala al agente SSH de la máquina. Para obtener más información, consulta "Generación de una nueva clave SSH y adición a ssh-agent".

Agregar una clave SSH nueva a tu cuenta

Después de agregar una clave de autenticación SSH a tu cuenta en GitHub.com, puedes volver a configurar cualquier repositorio local para usar SSH. Para más información, vea "Cambio de direcciones URL remotas de HTTPS a SSH".

Nota: En GitHub se ha mejorado la seguridad mediante la eliminación de los tipos de clave antiguos y no seguros el 15 de marzo de 2022.

A partir de esa fecha, ya no se admiten las claves DSA (ssh-dss). No puedes agregar claves DSA nuevas a tu cuenta personal en GitHub.com.

Las claves RSA (ssh-rsa) con valid_after antes del 2 de noviembre de 2021 pueden seguir usando cualquier algoritmo de firma. Las llaves RSA que se generaron después de esta fecha deberán utilizar un algoritmo de firma de tipo SHA-2. Algunos clientes más angituos podrían necesitar actualizarse para poder utilizar firmas de tipo SHA-2.

  1. Copy the SSH public key to your clipboard.

    If your SSH public key file has a different name than the example code, modify the filename to match your current setup. When copying your key, don't add any newlines or whitespace.

    $ pbcopy < ~/.ssh/id_ed25519.pub
      # Copies the contents of the id_ed25519.pub file to your clipboard

    Tip: If pbcopy isn't working, you can locate the hidden .ssh folder, open the file in your favorite text editor, and copy it to your clipboard.

    $ clip < ~/.ssh/id_ed25519.pub
      # Copies the contents of the id_ed25519.pub file to your clipboard

    Tip: If clip isn't working, you can locate the hidden .ssh folder, open the file in your favorite text editor, and copy it to your clipboard.

    $ cat ~/.ssh/id_ed25519.pub
      # Then select and copy the contents of the id_ed25519.pub file
      # displayed in the terminal to your clipboard

    Tip: Alternatively, you can locate the hidden .ssh folder, open the file in your favorite text editor, and copy it to your clipboard.

    1. En la esquina superior derecha de cualquier página, haga clic en la foto del perfil y, luego, en **Settings** (Configuración).

    Icono Settings (Parámetros) en la barra de usuario

  2. En la sección "Acceso" de la barra lateral, haga clic en SSH y claves de GPG.

  3. Haga clic en Nueva clave SSH o en Agregar clave SSH. Botón de clave SSH

  4. En el campo "Title" (Título), agrega una etiqueta descriptiva para la clave nueva. Por ejemplo, si estás utilizando un portátil personal, puedes llamar a esta clave "Portátil personal".

  5. Selecciona el tipo de clave, ya sea de autenticación o de firma. Para obtener más información sobre la firma de una confirmación, consulta "Acerca de la comprobación de firma de las confirmaciones".

  6. Pega tu clave en el campo "Key". Campo clave

  7. Haga clic en Agregar clave SSH. Botón Agregar clave

  8. Si se te solicita, confirma tu contraseña en GitHub. Para obtener más información, consulta «modo sudo».

Para obtener más información sobre GitHub CLI, vea "Acerca de GitHub CLI".

Antes de que puedas utilizar el GitHub CLI para agregar una llave SSH a tu cuenta, debes autenticarte en el GitHub CLI. Para más información, vea gh auth login en la documentación de GitHub CLI.

En la actualidad, solo puedes usar la GitHub CLI para agregar claves de autenticación SSH; no puedes agregar claves de firma SSH.

Para agregar una clave de autenticación SSH a la cuenta de GitHub, usa el subcomando ssh-key add y especifica la clave pública.

gh ssh-key add KEY-FILE

Para incluir un título para la nueva clave, use la marca -t o --title.

gh ssh-key add KEY-FILE --title "personal laptop"

Si ha generado la clave SSH siguiendo las instrucciones de "Generación de una nueva clave SSH", puede agregarla a la cuenta con este comando.

gh ssh-key add ~/.ssh/id_ed25519.pub

Información adicional