Agregar una clave SSH nueva a tu cuenta de GitHub

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

Platform navigation

Tool navigation

En este artículo

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

Puedes acceder y escribir datos en repositorios de 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 más información, consulta "Acerca de SSH".

También puede usar SSH para firmar confirmaciones y etiquetas. Para más información sobre la firma de confirmación, consulta "Acerca de la verificación de firma de confirmación".

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

Requisitos previos

Antes de agregar una nueva clave SSH a la cuenta en GitHub.com, completa los pasos siguientes.

  1. Verifica las claves SSH existente. Para obtener más información, vea «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, vea «Generación de una nueva clave SSH y adición al agente SSH».

Agregar una clave SSH nueva a tu cuenta

Puede agregar una clave SSH y usarla para la autenticación, la firma de confirmación o ambas. Si desea usar la misma clave SSH para la autenticación y la firma, debe cargarla dos veces.

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 obtener más información, vea «Administrar repositorios remotos».

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 .

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. Copia la llave SSH pública a tu portapapeles.

    Si tu archivo de llave SSH pública tiene un nombre diferente que en el código de ejemplo, modifica el nombre de archivo para que coincida con tu configuración actual. Al copiar tu clave, no agregues líneas nuevas o espacios en blanco.

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

    Sugerencia: Si pbcopy no funciona, puede buscar la carpeta oculta .ssh, abrir el archivo en el editor de texto favorito y copiarlo en el Portapapeles.

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

Notas:

  • Con Subsistema de Windows para Linux (WSL), puedes usar clip.exe. Si clip no funciona, puedes buscar la carpeta oculta .ssh, abrir el archivo en tu editor de texto favorito y copiarlo en el Portapapeles.
  • En versiones más recientes de Windows que usan el Windows Terminal o en cualquier otro lugar que use la línea de comandos de PowerShell, puedes recibir un ParseError que indique que The '&lt;' operator is reserved for future use. En este caso, se debe usar el siguiente comando alternativo clip:
$ cat ~/.ssh/id_ed25519.pub | clip
# Copies the contents of the id_ed25519.pub file 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

Sugerencia: Como alternativa, puede buscar la carpeta oculta .ssh, abrir el archivo en el editor de texto favorito y copiarlo en el Portapapeles.

  1. En la esquina superior derecha de cualquier página en GitHub, haga clic en la fotografía de perfil y luego en Configuración.

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

  3. Haga clic en Nueva clave SSH o en Agregar 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 más información sobre la firma de confirmación, consulta "Acerca de la verificación de firma de confirmación".

  6. En el campo "Clave", pega tu clave pública.

  7. Haga clic en Agregar clave SSH.

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

Para más información sobre GitHub CLI, consulta "Acerca del CLI de GitHub".

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.

Para agregar una clave SSH a la cuenta de GitHub, use el subcomando ssh-key add y especifique la clave pública. En el caso de claves de autenticación, si se te pide que solicites ámbitos adicionales, sigue las instrucciones de la línea de comandos.

gh ssh-key add KEY-FILE --type {authentication|signing}

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 has generado la clave SSH siguiendo las instrucciones de "Generación de una nueva clave SSH y adición al agente SSH", puedes agregarla a la cuenta con este comando.

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

Información adicional