Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.

Agregar una clave SSH nueva a tu cuenta de GitHub

Para configurar tu cuenta en tu instancia de GitHub Enterprise Server 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 tu instancia de GitHub Enterprise Server 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".

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

Prerrequisitos

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

  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

Después de agregar una clave de autenticación SSH a tu cuenta en tu instancia de GitHub Enterprise Server, puedes volver a configurar cualquier repositorio local para usar SSH. Para obtener más información, vea «Administrar repositorios remotos».

Nota: De forma predeterminada, con GitHub Enterprise Server 3.6 y versiones posteriores, a partir de la fecha límite de medianoche UTC del 1 de agosto de 2022, se producirá un error en las conexiones SSH que cumplan las dos condiciones siguientes.


  • La clave RSA se agregó a una cuenta de usuario en tu instancia de GitHub Enterprise Server después de la fecha límite de medianoche UTC del 1 de agosto de 2022.
  • El cliente SSH firma el intento de conexión con la función hash SHA-1.

GitHub Enterprise Server 3.6 y versiones posteriores tampoco admite conexiones SSH que usan cifrados DSA, HMAC-SHA-1 o CBC. Las claves SSH RSA cargadas antes de la fecha límite pueden seguir autenticándose mediante la función hash SHA-1, siempre que la clave siga siendo válida. Para más información sobre cómo encontrar la versión de GitHub Enterprise Server que usas, consulta "Acerca de las versiones de GitHub Docs".

El administrador del sitio puede ajustar la fecha límite de las conexiones que utilizan RSA-SHA-1 y puede bloquear todas las conexiones que utilizan RSA-SHA-1. Para más información, ponte en contacto con el administrador del sitio o consulta "Configuración de conexiones SSH a la instancia".

  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

    Sugerencia: 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.

    $ 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, haga clic en la foto del perfil y, luego, en **Settings** (Configuración).

    Captura de pantalla del menú de cuentas de GitHub que muestra las opciones para que los usuarios vean y editen su perfil, contenido y configuración. El elemento de menú "Configuración" aparece en naranja oscuro.

  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. En el campo "Clave", pega tu clave pública.

  6. Haga clic en Agregar clave SSH.

  7. Si se te solicita, confirma tu contraseña en GitHub Enterprise Server. 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 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 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