Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Esta versión de GitHub Enterprise se discontinuó el 2020-11-12. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Generar una nueva clave SSH y agregarla al ssh-agent

Una vez que has comprobado las claves SSH existentes, puedes generar una nueva clave SSH para usarla para la autenticación y luego agregarla al ssh-agent.

En este artículo

Si todavía no tienes una clave SSH, debes generar una nueva clave SSH. Si no estás seguro de si ya tienes una clave SSH, comprueba las claves existentes.

Si no deseas volver a ingresar tu contraseña cada vez que usas tu clave SSH, puedes agregar tu clave al SSH agent, que gestiona tus claves SSH y recuerda tu contraseña.

Generar una nueva clave SSH

  1. Abre la TerminalTerminalGit Bash.

  2. Pega el siguiente texto, que sustituye tu dirección de correo electrónico en GitHub Enterprise.

    $ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

    Esto crea una nueva clave ssh usando el correo electrónico proporcionado como etiqueta.

    > Generating public/private rsa key pair.
  3. Cuando se te indique "Ingresar un archivo donde guardar la clave", presiona Intro. Al hacerlo aceptas la ubicación predeterminada del archivo.

    > Enter a file in which to save the key (/Users/you/.ssh/id_rsa): [Press enter]
    > Enter a file in which to save the key (/c/Users/you/.ssh/id_rsa):[Press enter]
    > Enter a file in which to save the key (/home/you/.ssh/id_rsa): [Press enter]
  4. Donde se indica, escribe una contraseña segura. Para obtener más información, consulta "Trabajar con frases de contraseña de la clave SSH".

    > Enter passphrase (empty for no passphrase): [Type a passphrase]
    > Enter same passphrase again: [Type passphrase again]

Agregar tu clave SSH al ssh-agent

Antes de agregar una nueva clave SSH al ssh-agent para gestionar tus claves, debes haber comprobado las claves SSH existentes y generado una nueva clave SSH. Cuando agregues tu clave SSH al agente, usa el comando macOS ssh-add y no una aplicación instalada por macports, homebrew o alguna otra fuente externa.

  1. Inicia el agente SSH en segundo plano.

    $ eval "$(ssh-agent -s)"
    > Agent pid 59566
  2. Si estás usando macOS Sierra 10.12.2 o una versión posterior, deberás modificar tu archivo ~/.ssh/config para cargar las claves automáticamente en el ssh-agent y almacenar las contraseñas en tu keychain.

    • Primero, revisa si tu archivo ~/.ssh/config existe en la ubicación predeterminada.

      $ open ~/.ssh/config
      > The file /Users/you/.ssh/config does not exist.
    • Si el archivo no existe, créalo.

      $ touch ~/.ssh/config
    • Abre tu archivo ~/.ssh/config, posteriormente, modifícalo reemplazando ~/.ssh/id_rsa si no estás utilizando la ubicación y el nombre para tu llave id_rsa.

      Host *
        AddKeysToAgent yes
        UseKeychain yes
        IdentityFile ~/.ssh/id_rsa
      
  3. Agrega tu llave privada SSH al ssh-agent y almacena tu contraseña en tu keychain. Si creaste tu llave con un nombre distinto, o si estás agregando una llave existente que tiene un nombre distinto, reemplaza id_rsa en el comando con el nombre de tu archivo de llave privada.

    $ ssh-add -K ~/.ssh/id_rsa

    Nota: La opción -K es una versión estándar de Apple de ssh-add, que almacena la contraseña en tu keychain cuando agregas una clave SSH al ssh-agent.

    Si no tienes instalada la versión estándar de Apple, puedes recibir un mensaje de error. Para obtener más información sobre cómo resolver este error, consulta "Error: ssh-add: opción ilegal -- K".

  4. Agrega la clave SSH a tu cuenta de GitHub

Si tienes GitHub Desktop instalado, puedes usarlo para clonar repositorios y no manejar claves SSH.

  1. Verifica que el ssh-agent se esté ejecutando. Puedes utilizar las instrucciones de "Autolanzamiento del ssh-agent" que se encuentran en Trabajar con frases de acceso de las llaves SSH" o iniciarlo manualmente:

    # start the ssh-agent in the background
    $ eval $(ssh-agent -s)
    > Agent pid 59566
  2. Agrega tu llave privada SSH al ssh-agent. Si creaste tu llave con un nombre distinto, o si estás agregando una llave existente que tiene un nombre distinto, reemplaza id_rsa en el comando con el nombre de tu archivo de llave privada.

    $ ssh-add ~/.ssh/id_rsa
  3. Agrega la clave SSH a tu cuenta de GitHub

  1. Inicia el agente SSH en segundo plano.

    $ eval "$(ssh-agent -s)"
    > Agent pid 59566
  2. Agrega tu llave privada SSH al ssh-agent. Si creaste tu llave con un nombre distinto, o si estás agregando una llave existente que tiene un nombre distinto, reemplaza id_rsa en el comando con el nombre de tu archivo de llave privada.

    $ ssh-add ~/.ssh/id_rsa
  3. Agrega la clave SSH a tu cuenta de GitHub

Leer más