Configuración de SSH en GitHub para Windows, Linux y Mac

Resumen

Usar SSH para interactuar con GitHub es una excelente forma de aumentar la seguridad y mejorar la comodidad en el manejo de repositorios. A continuación, te explicamos el paso a paso para generar y configurar tus llaves SSH en distintos sistemas operativos y cómo integrarlas en tu perfil de GitHub para mejorar la experiencia de clonación y autenticación.

¿Por qué es mejor usar SSH en lugar de HTTPS para GitHub?

Seguridad adicional: SSH permite autenticar la computadora específica que accede a los repositorios sin necesidad de ingresar una contraseña cada vez.
Comodidad: Evita la necesidad de escribir tu contraseña en cada operación con GitHub, agilizando el flujo de trabajo.

¿Cómo generar una llave SSH en Windows y Linux?

Instalar WSL si estás en Windows (opcional si usas Linux nativo).
Verificar que no tienes llaves previas: Ve al menú de “Code” en GitHub y verifica que la opción de SSH no tenga llaves configuradas.
Generar la llave SSH: En la terminal, usa el comando:
```
ssh-keygen -t ed25519 -C "tu_correo@example.com"
```
- -t ed25519 establece el nivel de encriptación.
- -C añade un comentario con tu correo, útil para identificar la llave en GitHub.
Guardar y proteger la llave:
- Usa el nombre por defecto y añade una contraseña segura.
- La llave pública se guarda en el directorio .ssh, generalmente nombrada id_ed25519.pub.
Configurar el agente SSH: Activa el agente de SSH y añade la llave privada:
```
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
```

¿Cómo añadir la llave SSH a GitHub?

Abrir el archivo de la llave pública (id_ed25519.pub) y copia el contenido.
En GitHub, ve a Settings > SSH and GPG keys > New SSH key y pega la llave.
Nombra la llave de acuerdo a la computadora en la que estás configurándola.

¿Qué pasos adicionales seguir en Mac?

Crear el archivo de configuración SSH: Abre o crea el archivo config dentro del directorio .ssh.
Agregar parámetros específicos de Mac: Añade la configuración para integrar SSH con el sistema Keychain:
```
Host github.com
   AddKeysToAgent yes
   UseKeychain yes
   IdentityFile ~/.ssh/id_ed25519
```
Añadir la llave al agente SSH con Keychain: Usa el comando:
```
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
```

¿Cómo verificar la conexión con GitHub?

Comprobar autenticación: En la terminal, ejecuta el comando:
```
ssh -T git@github.com
```
- Escribe “yes” para confirmar la conexión.
- Aparecerá un mensaje de GitHub que confirma la autenticidad.

¿Cómo clonar un repositorio usando SSH?

En GitHub, selecciona el repositorio deseado, elige la opción de clonación por SSH y copia la URL.

En la terminal, ejecuta:

git clone git@github.com:usuario/repositorio.git

Esto clona el repositorio sin solicitar contraseña, aprovechando la autenticación SSH.

Maryan Espinoza

student•

Vengo usando la Opcion 2 dedse hace mucho (La Aprendi en Curso anterior) , pero con la opcion 1 es mar corta y robusta la llave

ssh-keygen -t ed25519 -C "email@dominio.com"
ssh-keygen -t rsa -b 4096 -C "email@dominio.com"

Ed25519 es recomendado si prefieres mayor seguridad y eficiencia en un entorno moderno.
RSA de 4096 bits es ideal si necesitas alta compatibilidad y puedes tolerar un poco más de consumo de recursos.

Diego Andrés Lopez Rodriguez

student•

Para configurar SSH en GitHub, sigue estos pasos:

Genera una clave SSH:
- Abre tu terminal.
- Ejecuta: ssh-keygen -t ed25519 -C "tu_correo@example.com" y sigue las instrucciones para crear la clave.
Inicia el agente SSH:
- Ejecuta: eval "$(ssh-agent -s)".
- Luego, agrega tu clave privada: ssh-add ~/.ssh/id_ed25519.
Copia la clave pública:
- Usa cat ~/.ssh/id_ed25519.pub para visualizarla y cópiala.
Añade la clave a GitHub:
- Ve a GitHub, en "Settings" > "SSH and GPG keys", y selecciona "New SSH key". Pega tu clave pública.
Prueba la conexión:
- Ejecuta: ssh -T git@github.com. Deberías ver un mensaje de éxito.

Con esto, habrás configurado SSH para GitHub de forma segura y eficiente.

Ederson Felipe Lopez Bolivar

student•

Diego Alejandro Gil Rave

student•

Las llaves SSH se crean desde una carpeta general del sistema, no específicamente desde la carpeta del proyecto. Puedes generarlas en el directorio ~/.ssh (o C:\Users\tu_usuario\.ssh en Windows) usando el comando ssh-keygen. Esto permite que las llaves sean accesibles desde cualquier proyecto que requiera autenticación SSH, facilitando su uso en múltiples repositorios.

Christian Rafael Rafael Guado Geronimo

student•

Sí, es una buena idea crear una llave SSH en cada laptop y enlazarlas a tu cuenta de GitHub. Esto te permite acceder de forma segura a tus repositorios desde ambas computadoras. Recuerda que cada llave SSH es única, por lo que necesitarás añadir la llave pública de cada laptop a tu cuenta de GitHub en la sección de "SSH and GPG keys" en la configuración. Así garantizarás que solo tus dispositivos autorizados puedan comunicarse con tu cuenta de GitHub de manera segura.

Daniel Barros Garces

student•

Esta clase deberia de estar en la configuracion de git, ya que es algo super importante como para tener la tan abajo?

Amin Espinoza

teacher•

Porque solo funciona cuando dejas de trabajar en un entorno local y comienzas a hospedar tu código en un entorno remoto, hacer esto en un entorno git aislado no ofrece grandes ventajas.

David Melendez

student•

Hola Daniel, el asunto es que esto es específicamente de GitHub y no de Git. Recuerda que podemos usar Git sin la existencia de GitHub por lo que no tendríamos que configurar nada de estas cosas, solo si trabajamos en un entorno en equipo o colaborativo ahi si.

Saludos.

Nelson Londoño

student•

Para remover la carpeta .ssh y crear nuevas llaves, puedes seguir estos pasos:

Abre tu terminal.
Usa el siguiente comando para eliminar la carpeta .ssh:
```
rm -rf ~/.ssh
```
Una vez eliminada, puedes crear nuevas llaves SSH usando:
```
ssh-keygen -t ed25519 -C "tu_email@example.com"
```
Sigue las instrucciones para completar la creación de las nuevas llaves.

Recuerda que al eliminar la carpeta .ssh, perderás todas las llaves almacenadas, así que asegúrate de que no las necesites antes de proceder.

Cristian Lopez

student•

El comando eval "$(ssh-agent -s)" se utiliza para iniciar el agente SSH en tu terminal. El agente SSH es un programa que mantiene las claves privadas en memoria, lo que permite que puedas usar estas claves para autenticarte sin necesidad de ingresar tu contraseña en cada conexión. Al usar eval, ejecutas el comando y configuras las variables de entorno necesarias para que tu sesión de terminal reconozca el agente y pueda usar las llaves SSH que hayas agregado. Esto facilita el uso de conexiones SSH en proyectos, como los que gestionas en GitHub.

Enrique Alexis Lopez Araujo

student•

Para configurar SSH en Git y GitHub, sigue estos comandos:

Generar una nueva llave SSH:

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

Iniciar el agente SSH:
```
eval "$(ssh-agent -s)"
```
Agregar tu llave privada al agente:
```
ssh-add ~/.ssh/id_ed25519
```
Copia tu llave pública:
```
cat ~/.ssh/id_ed25519.pub
```
Añade la llave a GitHub: ve a Settings > SSH and GPG keys > New SSH key y pega la llave.

Para manejar múltiples cuentas, crea un archivo de configuración:

nano ~/.ssh/config

Añade algo como esto:

Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519

Host github-personal
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_rsa_personal

Esto te permite usar diferentes llaves para distintas cuentas.

Sebastian Páez

student•

Hola, realizo los pasos para registrar la identidad para no colocar la passphrase a cada momento pero cuando cierro la terminal pierde esa configuración, ¿como puedo hacer para que quede fijo?

Amin Espinoza

teacher•

Qué terminal estás utilizando?

Sebastian Páez

student•

WSL 2 ubuntu con zsh

Gabriel Obregón

student•

🧠Uso de SSH con GitHub

🔒 ¿QUÉ ES SSH Y POR QUÉ USARLO?

SSH (Secure Shell) → método seguro para conectar tu computadora con GitHub.

Ventajas principales:

🔐 Seguridad: tu equipo se autentica sin contraseñas repetidas.
⚡ Comodidad: evita escribir credenciales en cada acción (git push, git pull, etc.).

💡 Ideal para quienes trabajan frecuentemente con repositorios remotos.

⚙️ ANTES DE EMPEZAR

🪟 Windows: instala WSL (Windows Subsystem for Linux).

🐧 Linux: ya tienes todo lo necesario.

🧭 Verifica si tienes llaves existentes:

En GitHub → menú Code → opción SSH.
Revisa si ya hay llaves configuradas.
Si existen, puedes usarlas o crear nuevas.

🧩 CREAR UNA NUEVA LLAVE SSH

🧠 En la terminal, ejecuta:

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

📘 Explicación rápida:

-t ed25519 → usa cifrado moderno y seguro.
-C → agrega tu correo como comentario (para identificar la llave).

🔐 Durante el proceso:

Acepta el nombre por defecto.
Añade una contraseña si deseas protección extra.
Tu llave pública se guarda en: 👉 .ssh/id_ed25519.pub

🚀 ACTIVAR EL AGENTE SSH

💻 Ejecuta:

eval "$(ssh-agent -s)"

ssh-add ~/.ssh/id_ed25519

Esto inicia el agente SSH, que almacena la llave privada y evita pedirte la contraseña cada vez.

📍 Piensa en él como un “recordatorio seguro” de tu identidad SSH.

🌐 AGREGAR LA LLAVE A GITHUB

🔹 Abre el archivo id_ed25519.pub.

🔹 Copia todo su contenido.

🔹 En GitHub, entra a: Settings → SSH and GPG keys → New SSH key

✏️ Pega la llave copiada. 🖥️ Asigna un nombre descriptivo (ejemplo: “Laptop-personal”).

🍎 CONFIGURACIÓN EXTRA PARA macOS

📁 Abre o crea el archivo .ssh/config

✍️ Añade esta configuración:

Host github.com

AddKeysToAgent yes

UseKeychain yes

IdentityFile ~/.ssh/id_ed25519

🔗 Luego, ejecuta:

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Esto integra la llave SSH con el Keychain de macOS (gestor de contraseñas del sistema).

🧪 VERIFICAR LA CONEXIÓN CON GITHUB

Ejecuta en la terminal:

ssh -T git@github.com

🪄 Luego:

Escribe yes cuando se te pida confirmación.
Si ves un mensaje de bienvenida de GitHub → ✅ conexión exitosa.

📂 CLONAR UN REPOSITORIO CON SSH

En GitHub, entra al repositorio deseado.
Haz clic en “Clonar con SSH” y copia la URL.
En tu terminal, ejecuta:

git clone git@github.com:usuario/repositorio.git

⚙️ Esto descarga el repositorio sin pedir tu contraseña.

💡 RECUERDA

🔸 Protege tu llave privada (nunca la compartas).

🔸 Tu llave pública sí puede subirse a GitHub.

🔸 Con SSH, tu flujo de trabajo será:

✅ más rápido · 🔐 más seguro · 💼 más profesional.

Javier Ramos

student•

Este comentario merece tener 1000 corazones verdes

Brad Velasquez

student••

Si alguien al ejecutar el siguiente comando: ssh -T git@github no les genera nada, prueben lo siguiente: vim ~/.ssh/config, pueden usar nano si les parece ma's comodo.

copien y pegen lo siguiente:

Host github.com
  HostName ssh.github.com
  Port 443
  User git
  IdentityFile ~/.ssh/id_ed25519
  IdentitiesOnly yes

ahora vuelvan a ejecutar otra vez el comando: ssh -T git@github.com

y continuen con el video. :)

Abdiel Alfaro

student•

El archivo "config" debe permanecer en el directorio .ssh de tu usuario en macOS, no en la raíz del sistema operativo. Este directorio se encuentra típicamente en la ruta ~/.ssh/. Mantener el archivo "config" en esta ubicación asegura que tu configuración de SSH sea reconocida correctamente y se mantenga organizada, facilitando la gestión de conexiones a diferentes servidores, como GitHub.

Javier Ramos

student•

buen apunte

Edward Nieves

student•

Tuve un problema al intentar establecer la conecxion ssh a github con el comando "ssh -T git@github.com"

me dice lo siguiente:

sign_and_send_pubkey: signing failed for ED25519 "/home/developer/.ssh/id_ed25519" from agent: agent refused operation

git@github.com: Permission denied (publickey).

como lo puedo solucionar? alguien me puede orientar lo agradeceria.

Ezequiel Choque

student•

El error que estás viendo indica que el agente SSH no pudo firmar la solicitud con tu clave privada ED25519. Esto puede deberse a varios motivos, pero aquí te dejo algunos pasos para solucionar el problema:

### 1. **Verifica que el agente SSH esté en ejecución**

Asegúrate de que el agente SSH esté en ejecución y que tenga tu clave privada agregada.

```bash

eval "$(ssh-agent -s)"

ssh-add ~/.ssh/id_ed25519

```

Si ssh-add te pide una contraseña, ingrésala. Esto debería agregar tu clave privada al agente SSH.

### 2. **Verifica los permisos de los archivos de claves**

Asegúrate de que los permisos de los archivos de claves sean correctos. Los archivos de claves SSH deben tener permisos restrictivos para que funcionen correctamente.

```bash

chmod 600 ~/.ssh/id_ed25519

chmod 644 ~/.ssh/id_ed25519.pub

chmod 700 ~/.ssh

```

### 3. **Verifica que la clave pública esté agregada en GitHub**

Asegúrate de que la clave pública (id\_ed25519.pub) esté agregada en tu cuenta de GitHub.

1. Copia la clave pública al portapapeles:

```bash

cat ~/.ssh/id_ed25519.pub

```

2. Ve a GitHub y navega a **Settings** > **SSH and GPG keys**.

3. Haz clic en **New SSH key** o **Add SSH key**.

4. Pega la clave pública en el campo correspondiente y guarda los cambios.

### 4. **Reinicia el agente SSH**

Si el agente SSH no está funcionando correctamente, puedes intentar reiniciarlo:

```bash

eval "$(ssh-agent -k)"

eval "$(ssh-agent -s)"

ssh-add ~/.ssh/id_ed25519

```

### 5. **Verifica la configuración de SSH**

Asegúrate de que tu archivo de configuración de SSH (~/.ssh/config) esté correctamente configurado. Debería tener algo como esto:

```plaintext

Host github.com

IdentityFile ~/.ssh/id_ed25519

User git

```

### 6. **Prueba la conexión nuevamente**

Después de realizar los pasos anteriores, prueba la conexión nuevamente:

```bash

ssh -T git@github.com

```

Si todo está configurado correctamente, deberías ver un mensaje como:

```plaintext

Hi <username>! You've successfully authenticated, but GitHub does not provide shell access.

```

### 7. **Revisa el agente SSH en segundo plano**

Si estás utilizando un entorno gráfico, asegúrate de que el agente SSH esté correctamente configurado en segundo plano. Algunos entornos de escritorio tienen sus propios manejadores de claves SSH que pueden interferir con el agente SSH tradicional.

### 8. **Revisa si hay conflictos con otras claves**

Si tienes múltiples claves SSH, asegúrate de que estás utilizando la correcta. Puedes listar las claves agregadas al agente SSH con:

```bash

ssh-add -l

```

Si ves que la clave incorrecta está siendo utilizada, puedes eliminarla con:

```bash

ssh-add -d ~/.ssh/id_rsa # Reemplaza con la clave que deseas eliminar

```

Luego, agrega la clave correcta nuevamente.

Si después de seguir estos pasos el problema persiste, podría ser útil revisar los logs de SSH para obtener más detalles sobre el error. Puedes hacerlo ejecutando:


ssh -T -v <git@github.com>

Esto te dará una salida detallada que puede ayudarte a diagnosticar el problema.

Ezequiel Choque

student•

Si es que no usaste IA eso me arrojo, todavía no estoy viendo este video pero lo vere pronto pero espero que te haya servido de ayuda si es que no lograste resolverlo.

Cornelio Reyes

student•

a mi no me acepta eval como comando..alguien tiene la misma duda???

Amin Espinoza

teacher•

Siento la demora al responder! Cuéntame que terminal usas? Yo o hago con Linux.

Amin Espinoza

teacher•

¿Qué terminal estás usando?

Ángel Sabillón

student•

Tuve un problema: "WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!" . Alguien mas tuvo algun problema simiar?

Arturo Casas Quiroga

student•

No de mi lado. has probado con esto? https://stackoverflow.com/questions/20840012/ssh-remote-host-identification-has-changed

Amin Espinoza

teacher•

No, no me ha pasado, estaría genial si me ayudas con una captura de pantalla del momento en que te aparece para poder tener un poco más de claridad de cómo ayudar.

Juan R Rossano

student•

Una consulta. ¿Se puede generar un par de claves, copiarlas a otro equipo y estar conectados con el mismo a github? Es decir que en el equipo del trabajo hago todos los pasos, copio los dos archivos para instalarlos en la notebook del trabajo para cuando estoy home office, y de los dos hago los pasos de ssh-add y ssh T para habilitarlos con el mismo juego de claves ¿O preciso un juego para cada equipo? Gracias.

Jose Luis Flores

student•

Lo recomendable es que cada equipo tenga sus llaves, asi seas tu el dueño, porque necesitarías copiar la llave privada en algun sitio , y no es lo recomendable

hace el proceso en ambas maquinas y te curas de salud

Carlos Arturo Gómez

student•

Uso wls2 y cada que cierro sesión (cierro la terminal) o si trabajo desde VS code, cada que necesito hacer un push o un pull me pide la contraseña, no importa si lo agrego al agente. Quiero saber si hay alguna forma de configurarlo para no estar en esas (Me parece poco practico).

Daniel Andres Rojas Paredes

student•

Para generar llaves SSH:

ssh-keygen -t ED25519 -C "tu_correo@example.com"

Para añadir la llave al agente SSH:

eval $(ssh-agent -s)
ssh-add ~/.ssh/id_ed25519

Para copiar la llave pública:
```
cat ~/.ssh/id_ed25519.pub
```
Para verificar conexión con GitHub:
```
ssh -T git@github.com
```

Estos comandos son esenciales para la configuración de SSH y mejorar la seguridad al trabajar con GitHub.

Brahian Angel Ospina

student•

Para crear llaves SSH en Windows, puedes usar el siguiente comando en tu terminal (por ejemplo, en Git Bash o WSL):

ssh-keygen -t ed25519 -C "tu-correo@ejemplo.com"

Esto generará un par de llaves. La llave privada se guardará en ~/.ssh/id_ed25519 y la llave pública en ~/.ssh/id_ed25519.pub. Luego, añade la llave pública a tu cuenta de GitHub siguiendo los pasos mencionados en el material.