Configuración automática de claves SSH en macOS para Git

Preparación previa: generar un par de claves SSH

1. Abrir la terminal
   Usa Spotlight (⌘+Space) para buscar “Terminal” y ábrela.

2. Generar el par de claves
   Ejecuta el siguiente comando (reemplaza [email protected] con tu correo electrónico):

   ssh-keygen -t ed25519 -C "[email protected]" -f ~/.ssh/git_example

   • Cuando se solicite, presiona Enter para usar la configuración predeterminada.
   • Para mayor seguridad, puedes establecer una frase de contraseña (passphrase).

3. Ver los archivos generados
   En el directorio ~/.ssh se generarán dos archivos:

   git_example    # Clave privada (debes guardarla de forma segura)
   git_example.pub # Clave pública (debes configurarla en el servidor Git)

Configurar el uso automático de la clave especificada

1. Editar el archivo de configuración de SSH

   mkdir -p ~/.ssh && chmod 700 ~/.ssh
   vim ~/.ssh/config

2. Agregar la configuración
   Usa la siguiente plantilla (modifica los parámetros según sea necesario):

   # Configuración principal del servidor Git
   Host git.example.com
       HostName git.example.com
       User git
       Port 22
       IdentityFile ~/.ssh/git_example
       IdentitiesOnly yes
   
   # Configuración adicional (para otros servicios Git)
   Host github.com
       HostName github.com
       User git
       IdentityFile ~/.ssh/github_key

3. Establecer permisos de archivo

   chmod 600 ~/.ssh/config

Configuración del lado del servidor

1. Agregar la clave pública al servicio Git
   Copia el contenido de la clave pública:

   pbcopy < ~/.ssh/git_example.pub

   Agrega la clave pública en:
   • GitHub: Settings → SSH and GPG keys
   • GitLab: Preferences → SSH Keys
   • Servidor Git propio: archivo ~/.ssh/authorized_keys en el servidor

Verificar la configuración

1. Probar la conexión SSH

   ssh -T [email protected]

   Si es exitoso, se mostrará un mensaje de bienvenida del proveedor (por ejemplo, “Hi username!” de GitHub).

2. Probar clonando un repositorio

   git clone [email protected]:username/repo.git

   El sistema usará automáticamente la clave especificada, sin intervención manual.

Solución de problemas

1. Modo de depuración
   Agrega el parámetro -v para ver el proceso de conexión detallado:

   ssh -Tv [email protected]

2. Problemas comunes

   • Error Permissions 0644 are too open: ejecuta chmod 600 ~/.ssh/*
   • Tiempo de espera de conexión: verifica la configuración del firewall o proxy de red.
   • Fallo de autenticación: confirma que la clave pública se haya agregado correctamente al servidor.

Aplicaciones adicionales

Configurando múltiples bloques Host, se puede lograr:

• Usar diferentes claves para diferentes plataformas (GitHub/GitLab/Gitee)
• Separar cuentas de trabajo y personales
• Gestión de claves en entornos con múltiples servidores

Nota: git.example.com en los ejemplos de este artículo es un dominio de demostración. Al usarlo, reemplázalo con la dirección de tu servicio Git.