Cursos Empresas Blog Live Conf Eventos Precios

0:0015:07

Recursos

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.

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

Curso de Git y GitHub

Clase 14 de 42

Clase 14 / 42

Edward Nieves

Hace 2 años

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

Hace 2 años

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

Hace 2 años

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.

Comentarios (89)89 comentarios

Maryan Espinoza

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.

Jose Damian Jimenez Monroy

Hace 7 meses

Diego Andrés Lopez Rodriguez

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

Diego Alejandro Gil Rave

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

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.

Gabriel Obregón

Hace un año

Javier Ramos

Este comentario merece tener 1000 corazones verdes

Ramiro Andres Bedoya Escobar

Hace 6 meses•editado

Hola, estoy trabajando desde Mac y casi en el ultimo paso, cuando ingreso el comando ssh -T no me sale el mensaje que sale en el video, arriba cambia el titulo y luego sale un mensaje de Connection closed. No entiendo :(

Daniel Barros Garces

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

Amin Espinoza

Profesor

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

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

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.

Dany Ramírez

Hace 6 meses

No le recomiendo a nadie usar rm para borrar cosas de configuración, luego te das cuenta que no había que borrarlo y te tienes que «convertir en hacker» para recuperar la información jaja, mejor usar gio trash, envia la información a la papelera del sistema.

Sebastian Páez

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?

Qué terminal estás utilizando?

WSL 2 ubuntu con zsh

Enrique Alexis Lopez Araujo

Cristian Lopez

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.

Cristian Acevedo

Por nada del mundo compartas la llave privada de SSH que es la que no tiene el .pub son cosas que tenes que tener cuidado como el comando rm -hard

Abdiel Alfaro Manuel

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.

buen apunte

Brad Velasquez

Hace un año•editado

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

y continuen con el video. :)

Brahian Angel Ospina

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.

Jacqueline Vera Hilario

Las tres opciones para clonar un repositorio tienen diferencias importantes:

HTTPS

Más simple y universal: funciona en casi cualquier red y firewall
Autenticación: requiere tu nombre de usuario y un token de acceso personal (PAT) cada vez que haces push/pull
Ventaja: no necesitas configuración previa, es plug-and-play
Desventaja: puede ser tedioso ingresar credenciales repetidamente (aunque puedes usar un credential helper para guardarlas)
Ejemplo: git clone

SSH

Más seguro y conveniente: usa un par de llaves criptográficas (pública/privada)
Autenticación: una vez configuradas las llaves SSH, no necesitas ingresar credenciales cada vez
Ventaja: después de la configuración inicial, es muy cómodo para uso frecuente
Desventaja: requiere generar y configurar llaves SSH previamente
Puede bloquearse: algunos firewalls corporativos bloquean el puerto 22
Ejemplo: git clone git@github.com:usuario/repo.git

GitHub CLI

Herramienta oficial de GitHub: es más que solo clonar, permite gestionar issues, PRs, releases, etc.
Autenticación integrada: maneja automáticamente la autenticación con GitHub
Ventaja: experiencia completa de GitHub desde la terminal
Desventaja: requiere instalar la herramienta CLI aparte
Ejemplo: gh repo clone usuario/repo

Recomendación: Si trabajas frecuentemente con Git, SSH es lo mejor. Si es ocasional o estás empezando, HTTPS es más directo. GitHub CLI es excelente si quieres una integración profunda con GitHub más allá de solo clonar.

Diego Mauricio Zuluaga Rodríguez

Hace 8 meses

LA LLAVE SSH SOLO FUNCIONA EN UNA MISMA COMPUTADORA, ESTO AUMENTA LA SEGURIDAD. ?

Hola, Diego Mauricio. Es una excelente pregunta.

No es que la llave "solo funcione" en una computadora por una limitación técnica, sino que tú decides que sea así por seguridad.

Imagina que la llave SSH es como una llave física de tu casa:

La llave privada es la que guardas en tu bolsillo (tu computadora).
La llave pública es la cerradura que instalas en la puerta (tu cuenta de GitHub).

Si quieres entrar desde otra computadora, debes generar un nuevo par de llaves específico para ese equipo. Esto es mucho más seguro porque, si alguna vez pierdes una de tus computadoras, simplemente entras a GitHub y "cambias la cerradura" (borras la llave pública de ese equipo específico) sin afectar a tus otras máquinas.

Para profundizar, te recomiendo revisar:

"Seguridad y buenas prácticas en GitHub"
"Administración de GitHub"

Dario Bublitz

Hace 9 meses

💡 Idea 18 ⭐⭐⭐⭐⭐ Configurar SSH es un "one-time setup" que te ahorra horas de fricción a largo plazo.

Ricardo Aviles Sanders

primero tenia un repositorio el cual cloné con HTTPS, despues miré esta clase para clonar con SSH y ahora está configurada así, ¿qué pasa con el otro repositorio que previamente clone con https? ¿seguirá igual con esa conexión, pidiendome la contraseña? ¿o automáticamente cambia su autenticación a ssh?

Ricardo, esa es una excelente pregunta. La respuesta corta es: no cambia automáticamente.

Cuando clonaste el primer repositorio usando HTTPS, Git guardó esa dirección específica en un archivo de configuración dentro de la carpeta .git de ese proyecto. Por lo tanto, ese repositorio seguirá intentando comunicarse con GitHub mediante HTTPS y te pedirá tus credenciales.

Para cambiarlo a SSH y dejar de usar la contraseña, puedes actualizar la "URL remota" de ese repositorio manualmente con este comando dentro de la carpeta del proyecto:

# Cambia la URL de origen a SSH
git remote set-url origin git@github.com:usuario/nombre-del-repo.git

(Asegúrate de reemplazar usuario/nombre-del-repo con la ruta real que obtienes al copiar el link SSH de GitHub).

Una vez hecho esto, Git usará tus llaves SSH para ese proyecto también. Para más detalles sobre cómo gestionar estas conexiones, te recomiendo: Uso de git pull, git push y git fetch en repositorios GitHub.

Recursos

Resumen

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

Progreso del curso

Fundamentos de Git y control de versiones

Introducción a GitHub

Herramientas de colaboración en GitHub

GitHub Codespaces

Seguridad y buenas prácticas en GitHub

Administración de GitHub

Gestión de Cambios con Pull Requests

GitHub Releases

Cierre