Claves SSH para Git y GitHub

Claves SSH para Git y GitHub#

En este curso se utilizará SSH para ejecutar comandos de git sobre repositorios almacenados en GitHub. El uso de SSH permite autenticarse de forma segura sin necesidad de escribir el usuario y la contraseña en cada operación.

Para ello es necesario generar un par de llaves SSH en el servidor o equipo desde el cual se trabajará, y registrar la llave pública en la cuenta de GitHub.

Note

Como alternativa a la configuración manual de llaves SSH, también es posible utilizar GitHub CLI (``gh``). Esta herramienta puede guiar de forma interactiva el proceso de autenticación con GitHub y configurar automáticamente el acceso mediante SSH o HTTPS.

GitHub CLI resulta especialmente útil para usuarios que trabajan por primera vez con GitHub o que desean simplificar la configuración inicial del entorno.

Verificar si ya existen llaves SSH#

Una vez en la terminal (local o remota), revisa si ya existen llaves SSH. Estas se almacenan en un directorio oculto llamado .ssh dentro del directorio HOME del usuario.

ls -al ~/.ssh

Note

  • El comando ls lista el contenido de un directorio.

  • La opción -a muestra archivos ocultos.

  • La opción -l muestra información detallada.

  • El símbolo ~ es un alias del directorio HOME.

Si el directorio no existe o está vacío, será necesario generar un nuevo par de llaves.

Generación de un par de llaves SSH#

Para generar un nuevo par de llaves se recomienda usar el algoritmo Ed25519:

ssh-keygen -t ed25519 -C "tu_email@example.com"

Durante el proceso, acepta las opciones por defecto (ubicación del archivo y contraseña vacía).

Note

El comentario (-C) suele ser el correo asociado a la cuenta de GitHub y sirve únicamente como identificador.

Si tu sistema no soporta el algoritmo Ed25519, puedes utilizar RSA:

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

Agregar la llave al agente SSH#

El ssh-agent mantiene las llaves cargadas en memoria para que puedan usarse automáticamente durante la sesión.

Inicia el agente SSH:

eval "$(ssh-agent -s)"

Asumiendo que se utilizó Ed25519, agrega la llave privada al agente:

ssh-add ~/.ssh/id_ed25519

Note

Si utilizaste RSA, el archivo será id_rsa en lugar de id_ed25519.

Agregar la llave pública a GitHub#

Para registrar la llave en GitHub es necesario copiar el contenido de la llave pública:

cat ~/.ssh/id_ed25519.pub

Copia la salida completa del comando y pégala en el formulario para agregar llaves SSH en tu cuenta de GitHub:

Tip

Nunca compartas tu llave privada (id_ed25519 o id_rsa). Solo la llave pública (.pub) debe copiarse a GitHub.

Configurar usuario y correo en Git#

Es importante que Git tenga configurado el nombre de usuario y el correo que corresponden a tu cuenta de GitHub:

git config --global user.name "Tu Nombre"
git config --global user.email "tu_email@example.com"

Estos datos se utilizan para identificar al autor de los commits.

Cambiar un repositorio de HTTPS a SSH#

Si un repositorio fue clonado originalmente usando HTTPS, es posible cambiarlo para que utilice SSH.

Ejemplo:

git remote set-url origin git@github.com:mariosky/ProgWeb.git

A partir de este momento, las operaciones como git pull o git push se realizarán utilizando SSH.

Contents