Configura tu llave SSH en GitHub

Curso de Configuración de Entorno de Desarrollo en Windows

Contenido del curso

Herramientas para la web

Editor de texto

Cómo usar Linux dentro de Windows

Git y Github

Trucos de Windows

17
Instalación y Uso de PowerToys en Windows
06:23 min

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0010:36

Configura tu llave SSH en GitHub

Curso de Configuración de Entorno de Desarrollo en Windows

Clase 15 de 17

Clase 15 / 17

Recursos

Configurar una llave SSH es el paso que separa a quien escribe contraseñas todo el tiempo de quien trabaja con GitHub de forma segura y fluida. Aquí aprendes a generarla en Ubuntu, registrarla en tu agente SSH y vincularla a tu cuenta de GitHub para empezar a subir código sin fricción.

¿Qué es una llave SSH y por qué la necesitas en GitHub?

Una llave SSH es un mecanismo de autenticación basado en encriptación que reemplaza el flujo tradicional de usuario y contraseña. En lugar de escribir credenciales cada vez que te conectas, tu sistema y GitHub intercambian una llave criptográfica que valida tu identidad de forma automática y segura.

Piénsalo así: tu computadora guarda una parte privada y GitHub guarda la parte pública. Cuando ambas se reconocen, el acceso se concede sin contraseñas adicionales. Existen alternativas físicas como las YubiKey, prácticas porque sirven para iniciar sesión en servicios como Gmail, pero con la desventaja de que si las pierdes, las pierdes. La llave SSH vive en tu sistema y la respaldas tú.

¿Qué es una llave SSH? Es un par de claves criptográficas (una pública y una privada) que te permite autenticarte en servicios como GitHub sin escribir contraseña cada vez. La privada se queda en tu equipo, la pública se sube al servicio.

¿Cómo generar una llave SSH con ssh-keygen en Ubuntu?

El proceso arranca en la terminal con una utilidad que ya viene instalada en Ubuntu: ssh-keygen [01:30]. No necesitas instalar nada extra.

El comando que vas a usar es:

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

Aquí hay tres detalles que debes cuidar:

La -C debe ir en mayúscula. Si la escribes en minúscula, la terminal responde con too many arguments.
El algoritmo ed25519 es el método de encriptación que protege tu llave.
El correo entre comillas debe ser el mismo que usas (o usarás) para registrarte en GitHub.

Al ejecutarlo, la terminal te pregunta dónde quieres guardar el archivo. Presiona enter para aceptar la ruta por defecto, normalmente ~/.ssh/id_ed25519. Después te pide una passphrase, una frase contraseña que protege tu llave privada. Escríbela, repítela y memorízala bien, porque la vas a necesitar después.

¿Cómo inicializar el agente SSH y agregar tu llave?

Generar la llave no basta. Necesitas que el agente SSH la reconozca y la mantenga activa durante tu sesión. Para arrancar el agente:

bash eval "$(ssh-agent -s)"

La terminal responde con un process ID, lo que confirma que el agente está corriendo [04:10]. Ahora agregas tu llave con:

bash ssh-add ~/.ssh/id_ed25519

Te pedirá la passphrase que definiste antes. Cuando la escribas correctamente, verás un mensaje de identidad agregada con tu correo. Listo, tu sistema ya tiene la llave activa.

¿Para qué sirve el ssh-agent? Es un proceso en segundo plano que guarda tus llaves SSH desbloqueadas durante la sesión, así no tienes que escribir la passphrase cada vez que te conectas a un repositorio.

¿Cómo vincular tu llave SSH pública a tu cuenta de GitHub?

Falta el paso que conecta tu computadora con GitHub: registrar la parte pública de la llave en tu cuenta. Para verla en pantalla y copiarla, usa el comando cat:

bash cat ~/.ssh/id_ed25519.pub

El archivo .pub contiene tu llave pública, la única que debes compartir. Cópiala con precisión, sin agregar espacios ni saltos de línea extra [06:45].

¿Dónde se pega la llave SSH en GitHub?

Con la llave copiada, ve a GitHub y sigue esta ruta:

Haz clic en tu avatar en la esquina superior derecha y entra a Settings.
En el menú lateral, busca la sección Access y selecciona SSH and GPG keys.
Haz clic en New SSH key.
Asigna un título descriptivo que identifique el equipo. Por ejemplo: Windows laptop WSL Ubuntu. Esto te salva cuando manejas varias llaves en distintas máquinas.
Pega tu llave pública en el campo Key.
Confirma con Add SSH key.

GitHub mostrará la llave con la nota de que nunca se ha usado, pero eso es normal: se actualizará la primera vez que la utilices para conectarte. Si tu cuenta aún no existe, regístrate en sign up con un correo válido, una contraseña segura (números, mayúsculas, símbolos) y un username propio antes de continuar.

Habilidades y conceptos clave que practicaste

Este flujo deja varios aprendizajes técnicos listos para tu día a día como desarrollador o desarrolladora:

Encriptación con ed25519: el algoritmo moderno y seguro recomendado para llaves SSH.
Uso de ssh-keygen: la utilidad nativa de Linux para generar pares de llaves criptográficas.
Gestión del ssh-agent: el proceso que mantiene tu llave activa durante la sesión [04:00].
Comando cat: una herramienta básica de Linux para imprimir el contenido de archivos en la terminal [06:30].
Manejo de passphrase: la capa adicional de protección que blinda tu llave privada.
Configuración en GitHub Settings > Access: el lugar exacto donde se administran llaves SSH y GPG.

Con tu llave configurada en ambos lados, ya puedes empezar a subir código a GitHub sin contraseñas y sin fricción. Si quieres profundizar en cómo funciona la criptografía detrás de SSH y todo el flujo de Git, el siguiente paso natural es seguir con el curso de Git y GitHub. ¿Te animas a contar en los comentarios qué nombre le pusiste a tu llave?

Maria Gabriela Rodriguez Cuevas

Hace 3 años

🗝 Clase #: Vincular la llave SSH 15/17 🗝

Llave SSH 🔑

Cuando se configura la clave SSH con GitHub, ya no es necesario autenticarse introduciendo el correo y contraseña en la terminal cada vez que se hace un commit.

Pasos para vincular la llave SSH 🔐

Para vincular la llave SSH se debe escribir: ◦ ssh en minúscula, ◦ luego la palabra keygen que es una utilidad que viene por defecto en la terminal de Ubuntu y genera la llave ssh, ◦ el comando ed25519 es el algoritmo de encriptación que permite generar claves SSH en máquinas virtuales, ◦ el -C debe estar en mayúscula, ◦ el correo debe ser el que tienes registrado en tu cuenta de GitHub, importante tu correo debe ir entre comillas "":

ssh-keygen -t ed25519 -C "email_de_GitHub"

Dar ENTER, luego se le da ENTER de nuevo, pregunta por una ++palabra clave++ que se ingresa 2 veces (no olvidar).
Validar que el agente SSH está corriendo:

eval "$(ssh-agent -s)"

- 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ña (fuente: aquí).
- Al ejecutar todo el comando de eval en la terminal, debe salir: Agent pid 7550 que indica que el agente se está ejeutando.
Agregar la llave al agente SSH:

ssh-add ∼/.ssh/id_ed25519

- ++Nota++: para escribir la virgulilla ~ presionar las teclas Alt Gr + 4 y la barra espaciadora y listo.
Vincular con GitHub:
- En la terminal vamos imprimir el contenido de la llave pública y luego la copiamos:

cat ~/.ssh/id_ed25519.pub

Ir a la página de GitHub, iniciar sesión, luego bucar en la esquina superior derecha: Profile > Settings > SSH and GPG keys > New SSh key pegar toda la llave y colocarle un título. Se la da en el botón verde: Add SSH key.

Paola Brito Sanchez

Hace 3 años

buenas podrias decirme a partir de que parte se copia la llave para ponerla en github es decir,desde donde empiezo y donde termino porque puse desde SHA256 HSTA EL FINAL incluido el agent pid y no me lo guardo

Eric López

Hace 3 años

Gracias por el aporte...

Comentarios (102)102 comentarios

Patricia Mago

Hace 4 años

Eduardo Ortiz

Jesus Cuadro

Vladimir Garcia Quintana

Eduardo Monzón

Diana Carolina Moncada Bohórquez

Erne Giar

Pedro Andrés Chaparro Quintero

Maximiliano Letelier

Hace 2 años

Johan Arango

Anuar Manuel Monterrosa Bedoya

David Antonio Morales Barrera

Manuela Gomez

Peter Rivera Morales

Marcos Monteverde

Jafet Brito

Danny Estrada

Luis Castro

Nicolas Alpargatero

Pablo Quevedo

Mauricio Montañez

Hace un año

ERNESTO ALONSO CARDONA ALZATE

Juan Ramon Sanchez

SEBASTIAN SALAZAR

Eddie Andree Enmanuel Romero Castellanos

Luis Tapia

Herramientas para la web

Configuración de Entorno de Desarrollo en Windows

Instalación y uso de Google Chrome para desarrollo web

Herramientas para Desarrolladores en Google Chrome

Editor de texto

Uso de Visual Studio Code para Desarrollo Web Básico

Extensiones esenciales para personalizar Visual Studio Code

Cómo usar Linux dentro de Windows

Instalación y configuración de Windows Subsystem for Linux 2

Activar WSL2 y resolver errores comunes

Configuración y Uso de Windows Subsystem for Linux (WSL) con Ubuntu

Instala Ubuntu en VirtualBox sin WSL

Instala Visual Studio Code en Ubuntu con VirtualBox

Comandos básicos de terminal Linux para web

Instalar Node.js y NPM en Ubuntu

Instalación y Ejecución Básica de Python en Linux

Git y Github

Registro y configuración inicial de GitHub en WSL

Configura tu llave SSH en GitHub

Sube tu primer repositorio a GitHub

Trucos de Windows

Instalación y Uso de PowerToys en Windows

Configura tu llave SSH en GitHub

Progreso del curso

Herramientas para la web

Editor de texto

Cómo usar Linux dentro de Windows

Git y Github

Trucos de Windows

Recursos

Recursos