¿Cómo configurar Git para usar SSH en lugar de HTTPS para repositorios remotos?

Si trabajas regularmente con Git y repositorios remotos, probablemente estés familiarizado con la necesidad de autenticarte al clonar, empujar o realizar pull en un repositorio. De forma predeterminada, Git permite conexiones a través de HTTPS y SSH. Aunque HTTPS es sencillo de usar, SSH es más seguro y conveniente una vez configurado, ya que evita la necesidad de ingresar credenciales repetidamente. En este artículo, aprenderás a configurar Git para usar SSH en lugar de HTTPS para tus repositorios remotos.

¿Por qué usar SSH en lugar de HTTPS?

El protocolo HTTPS requiere que ingreses tu nombre de usuario y contraseña en cada operación que interactúe con el repositorio remoto, salvo que configures un sistema de caché o credenciales almacenadas. Por otro lado, SSH utiliza claves públicas y privadas, proporcionando:

  • Seguridad mejorada: No se transfieren contraseñas, lo que reduce el riesgo de robo de credenciales.
  • Comodidad: Una vez configurado, Git autenticará automáticamente las conexiones a través de la clave privada almacenada en tu máquina.
  • Compatibilidad: SSH es ampliamente utilizado y compatible con la mayoría de los proveedores de servicios Git, como GitHub, GitLab y Bitbucket.

Requisitos previos

Antes de comenzar, asegúrate de cumplir con los siguientes requisitos:

  • Una instalación funcional de Git en tu máquina.
  • Un repositorio remoto al que deseas conectarte.
  • Conocimientos básicos de la línea de comandos.
  • Un cliente SSH instalado (generalmente incluido en sistemas operativos modernos).

Pasos para configurar Git con SSH

A continuación, te explicamos cómo configurar Git para usar SSH paso a paso:

1. Generar una clave SSH

El primer paso es generar una clave SSH si aún no tienes una. Esto se hace utilizando el comando ssh-keygen en tu terminal:

ssh-keygen -t ed25519 -C "tu-correo-electrónico@example.com"

Aquí:

  • -t ed25519: Especifica el tipo de clave (se recomienda ed25519 por su seguridad y velocidad).
  • -C "tu-correo-electrónico@example.com": Proporciona una etiqueta útil para identificar la clave.

Cuando se te solicite, selecciona una ubicación para guardar la clave (usa la predeterminada presionando Enter) y, opcionalmente, configura una contraseña para mayor seguridad.

2. Agregar la clave pública al servidor remoto

Después de generar la clave SSH, necesitas agregar la clave pública al servidor remoto donde resides tus repositorios. Para encontrar tu clave pública, ejecuta:

cat ~/.ssh/id_ed25519.pub

Copia el contenido del archivo resultante y agrégalo a tu plataforma de repositorio remoto:

  • GitHub: Ve a Settings > SSH and GPG keys > New SSH key y pega tu clave.
  • GitLab: Ve a Settings > SSH Keys y pega la clave.
  • Bitbucket: Ve a Personal settings > SSH keys y agrégala.

3. Configurar Git para usar SSH

Una vez que tu clave SSH esté configurada en el servidor remoto, debes decirle a Git que use SSH en lugar de HTTPS para los repositorios. Esto implica actualizar la URL remota del repositorio.

Primero, verifica la URL actual del repositorio remoto:

git remote -v

Verás algo similar a:

origin  https://github.com/usuario/repo.git (fetch)
origin  https://github.com/usuario/repo.git (push)

Ahora, cambia la URL para usar el protocolo SSH:

git remote set-url origin git@github.com:usuario/repo.git

Vuelve a verificar la URL remota:

git remote -v

Deberías ver:

origin  git@github.com:usuario/repo.git (fetch)
origin  git@github.com:usuario/repo.git (push)

4. Probar la conexión SSH

Antes de continuar, asegúrate de que la conexión SSH funcione correctamente. Ejecuta el siguiente comando:

ssh -T git@github.com

Deberías recibir un mensaje de éxito similar a este:

Hi usuario! You've successfully authenticated, but GitHub does not provide shell access.

Este mensaje confirma que tu clave SSH está configurada correctamente.

Configuración global de Git con SSH

Si deseas que todos tus repositorios usen SSH en lugar de HTTPS de manera predeterminada, puedes configurar Git globalmente:

git config --global url."git@github.com:".insteadOf "https://github.com/"

Esto asegura que cualquier clonación o actualización de repositorios de GitHub use el protocolo SSH automáticamente.

Solución de problemas comunes

A veces, puedes encontrar problemas al configurar Git con SSH. Aquí hay algunas soluciones a problemas comunes:

  • Error: “Permission denied (publickey)”: Asegúrate de que la clave pública correcta esté agregada al servidor remoto y de que tu agente SSH esté ejecutándose (ssh-add ~/.ssh/id_ed25519).
  • SSH no encuentra tu clave: Verifica que el archivo de la clave se encuentre en el directorio ~/.ssh/ y que los permisos sean correctos (chmod 600 ~/.ssh/id_ed25519).
  • Problemas con múltiples cuentas: Usa un archivo ~/.ssh/config para definir claves específicas para diferentes hosts.

Conclusión

Configurar Git para usar SSH en lugar de HTTPS es una práctica recomendada que mejora la seguridad y simplifica el flujo de trabajo al interactuar con repositorios remotos. Aunque la configuración inicial puede parecer complicada, los beneficios superan con creces el esfuerzo. Con los pasos descritos en este artículo, deberías estar listo para trabajar con Git de manera más segura y eficiente utilizando SSH.