Claves SSH para GitHub y GitLab

Guía para generar tu clave SSH y registrarla en GitHub y/o GitLab. En dai, git usa SSH (clonar, push, pull); los tokens son solo para el forge y el tracker, y nunca se usa la contraseña (ADR-0007). Con la clave configurada, dai pr puede pushear la rama sin pedirte credenciales.

Una vez por máquina. La misma clave sirve para GitHub y GitLab (y para todos tus repos). No necesitas una por proyecto.

---

Paso 1 — ¿Ya tienes una clave?

ls ~/.ssh/id_ed25519.pub

Si el archivo existe, ya tienes clave: salta al Paso 4. Si dice "No such file", sigue con el paso 2.

---

Paso 2 — Genera la clave

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

• Usa el correo de tu cuenta de GitHub/GitLab.
• Cuando pregunte la ubicación, acepta la default (Enter).
• La passphrase es opcional pero recomendada (una contraseña que protege la clave).

Si tu sistema es viejo y no soporta ed25519, usa -t rsa -b 4096.

---

Paso 3 — Carga la clave en el agente SSH

eval "$(ssh-agent -s)"        # inicia el agente
ssh-add ~/.ssh/id_ed25519     # carga tu clave (pide la passphrase si pusiste una)

Windows: usa Git Bash para estos comandos, o habilita el servicio OpenSSH Authentication Agent de Windows.

---

Paso 4 — Copia la clave pública

Nunca compartas la privada (id_ed25519). Copia solo la pública (.pub):

cat ~/.ssh/id_ed25519.pub        # muestra la clave; copiala entera (empieza con "ssh-ed25519")
# atajos: macOS → | pbcopy   ·   Windows (Git Bash) → | clip   ·   Linux → | xclip -sel clip

---

Paso 5 — Pégala en GitHub y/o GitLab

• GitHub: Settings → SSH and GPG keys → New SSH key. Pega la clave, ponle un título (ej. laptop-trabajo) y guarda. Acceso directo: https://github.com/settings/ssh/new
• GitLab: Preferences → SSH Keys → Add new key. Pega la clave y guarda. En un GitLab self-hosted/corporativo entra por la URL de tu instancia (https://gitlab.tu-empresa.com/-/user_settings/ssh_keys).

---

Paso 6 — Prueba la conexión

ssh -T git@github.com
# → "Hi <usuario>! You've successfully authenticated..."

ssh -T git@gitlab.com
# (self-hosted: ssh -T git@gitlab.tu-empresa.com)

La primera vez te pregunta si confías en el host: escribí yes. Si ves el saludo con tu usuario, quedó lista.

---

Reglas de seguridad

• 🔒 La clave privada nunca sale de tu máquina. No la pegues en ningún lado, no la commitees, no la mandes por chat. Solo se registra la pública (.pub).
• 🧯 Si se compromete tu máquina, borra la clave pública de GitHub/GitLab (misma pantalla del paso 5) y generá una nueva.
• 👤 Es por máquina y por persona: cada dev tiene la suya.