Configurar SSH para github

Generar par de clave pública y privada

Para generar los pares de claves haremos uso de la herramienta ssh-keyhen. Este programa está disponible por medio de la línea de comandos para Linux, MacOSX y en Git Bash en Windows.

En la mayoría de los casos cuando hemos instalado Git Bash, se nos habilitará la opción en el menú contextual del clic derecho para abrirlo:

1. Crear nueva clave

Comience creando una nueva clave, usando su correo electrónico como etiqueta en la terminal:

1
ssh-keygen -t rsa -b 4096 -C "user@email.com"

Explicación:

• -t rsa: Especifica el algoritmo de encriptación en este caso el más común es rsa.
• -b 4096: Especifica que tan compleja es la llave (eL tamaño 4096 se considera seguro).
• -C "user@email.com": Especifica el email con el que se va a configurar la llave.

Se le pedirá donde almacenar la nueva llave generada (Si solo presiona Enter por lo general se almacena en el directorio del usuario en una subcarpeta oculta):

1
Enter file in which to save the key (/c/Users/<user>/.ssh/id_rsa):

Seleccione una ubicación de archivo o solo presione Enter se creara en la ubicación por defecto.

Luego nos va pedir ingresar una frase de contraseña segura la cual creará una capa adicional de seguridad. Evitará que cualquier persona que obtenga acceso a su computadora use esa clave sin la frase de contraseña. Sin embargo, será necesario que proporcione la frase de contraseña cada vez que se utilice la llave.

A modo personal prefiero no utilizar una frase de confirmación ya que una llave SHH la suelo configurar en mi equipo personal y para efecto de productividad sin la frase ahorramos tiempo.

1
Enter passphrase (empty for no passphrase): Enter same passphrase again:

Luego nos va pedir confirmar:

1
Enter same passphrase again:

Por último nos devuelve el hash generado para la nueva llave creada:

Captura: Crear una nueva clave en GitBash

2. Agregar llave al SSH-Agent

El agente ssh (ssh-agent) es un programa auxiliar que realiza un seguimiento de las claves de identidad del usuario y sus frases de contraseñas. El agente puede usar las claves para iniciar sesión en otros servidores sin que el usuario escriba nuevamente una contraseña o frase de contraseña. En palabras simples podemos decir que se trata de un programa para contener llaves privadas, utilizadas para la autenticación de claves públicas.

Antes de agregar una nueva clave SSH al servicio de ssh-agent para gestionar tus claves, debes haber comprobado las claves SSH existente y generado una nueva clave SSH y verificar que se esté ejecutando el servicio.

1. Verificar que el ssh-agent se esté ejecutando:

1
eval $(ssh-agent -s)

• eval: Ejecuta un comando de shell y efectua una doble evaluación en la línea de comandos.

2. Agrega tu llave ssh privada al ssh-agent. Si creaste tu llave con un nombre distinto debes apuntar hacia donde se encuentre la llave que creaste. Si dejaste los valores predeterminado basta con copiar el siguiente comando:

1
ssh-add ~/.ssh/id_rsa 

Captura: añadir la llave ssh creada al ssh agent en Linux (con el nombre de gh_rsa).

Captura: añadir la llave ssh creada al ssh agent en gitbash (con el nombre de id_rsa).

Ahora tenemos el par de claves ssh listo para usarse.

Registrar la llave pública a GitHub

En Git Bash podemos usar la herramienta clip de Windows para copiar tu clave de una manera sencilla y rápida.

Copiar la clave pública al portapapeles 📋:

1
clip < ~/.ssh/id_rsa.pub

Explicación:

• ~: es un símbolo llamado virgulilla que en los sistemas operativos UNIX se refiere al valor de la variable $HOME, esto es, el directorio del usuario que está logueado.

• id_rsa.pub: Este archivo es el que almacena el contenido de la llave pública, por ende, debemos tener mucho cuidado en verificar que estemos copiando el contenido de este archivo y no de otro.

Ahora vamos a nuestra cuenta de GitHub e iniciamos sesión.

En la esquina superior derecha de nuestra página, das clic en tu foto de perfil y despues da clic en configuración. En la barra lateral de configuración de usuario, da clic en llaves SSH y GPG:

• Haz clic en New SSH key o Add SSH key:

• En el campo Title, agrega una etiqueta descriptiva para la clave nueva. Por ejemplo, si estás usando tu equipo personal, es posible que llames a esta llave (Personal laptop <MARCA>-<MODELO>)ja.

• Copia la clave que está contenida en el portapapeles en el campo Key Ctrl + V:

• Si se te solicita, confirma tu contraseña GitHub:

Está lista nuestra llave para poder utilizarla con GitHub:

Probar la conexión SSH a GitHub

Ahora podemos probar nuestra conexión a través de SSH a GitHub:

1
ssh -T git@github.com

Captura: Validar la conexión con github vía ssh.

Si la última línea contiene su nombre de usuario en GitHub, quiere decir que estamos autenticado correctamente.