Guía para Crear Credenciales SSH y Vincular GitHub en Windows
Esta guía te ayudará a generar y configurar tus claves SSH en Windows para autenticarte
de forma segura en GitHub, evitando tener que ingresar tu usuario y contraseña en cada
operación.
1. Acceder a la Carpeta SSH Local
Antes de generar una nueva clave, verifica si ya tienes una carpeta SSH en tu equipo:
1. Cambiar a la carpeta .ssh:
cd "C:\Users\pipe_\.ssh"
2. Generar una Nueva Clave SSH
1. Ejecuta el comando para generar la clave:
o Abre Git Bash y escribe:
ssh-keygen -t ed25519 -C "tu_correo@example.com"
Nota: Reemplaza "tu_correo@example.com" por la dirección de correo electrónico que
usas en GitHub.
Si tu sistema no soporta el algoritmo ed25519, puedes usar RSA:
ssh-keygen -t rsa -b 4096 -C “tu_correo@example.com”
2. Asignar nombre al par de claves:
o Cuando se te pida Enter a file in which to save the key, puedes presionar
Enter para aceptar la ubicación predeterminada o escribir un nombre
diferente (por ejemplo, id_rsa).
3. Configurar la passphrase:
o Se te solicitará una passphrase (contraseña opcional). Puedes dejarlo vacío
presionando Enter dos veces o ingresar una passphrase para mayor
seguridad.
3. Agregar la Clave SSH al Agente SSH
Para evitar ingresar la passphrase cada vez, es recomendable agregar la clave al agente
SSH.
a) Iniciar el Agente SSH (desde PowerShell)
1. Abrir PowerShell con privilegios de administrador y ejecutar:
Get-Service -Name ssh-agent | Set-Service -StartupType Manual
Start-Service ssh-agent
b) Agregar la Clave Privada al Agente
1. Desde PowerShell, agrega la clave:
ssh-add C:\Users\pipe_\.ssh\id_rsa
Nota: Ajusta el nombre del archivo (id_rsa o id_ed25519) según lo que hayas seleccionado
al generar la clave.
4. Agregar la Clave Pública a GitHub
1. Abrir el archivo de clave pública:
o Navega hasta la carpeta C:\Users\pipe_\.ssh y abre el archivo id_rsa.pub
con tu editor de texto preferido.
2. Copiar el contenido de la clave pública:
o Selecciona y copia todo el contenido del archivo.
ssh-ed25519 AAAAC3NzZDIAIBOQTg8JyWLUct2pkf89tdhZkCtidZE0A
afsandovalhiguera@gmail.com
3. Agregar la clave en GitHub:
o Inicia sesión en tu cuenta de GitHub.
o Haz clic en tu foto de perfil (esquina superior derecha) y selecciona
Settings.
o En el menú lateral, haz clic en SSH and GPG keys.
o Pulsa en New SSH key.
o En Title, asigna un nombre descriptivo (por ejemplo, "Mi PC Windows").
o Pega la clave copiada en el campo Key.
o Haz clic en Add SSH key para guardar.
5. Probar la Conexión SSH con GitHub
Para confirmar que la configuración es correcta:
1. Abre Git Bash o PowerShell y ejecuta:
ssh -T git@github.com
2. La primera vez se te preguntará si deseas continuar conectándote al host. Escribe
yes y presiona Enter.
3. Si todo está configurado correctamente, deberías ver un mensaje similar a:
Hi tu_usuario! You've successfully authenticated, but GitHub does not provide shell access.