Error de Git: git@github.com: Permission denied (publickey)

Descripción del Error

El mensaje de error “git@github.com: Permission denied (publickey)” indica que Git no puede autenticarte en GitHub utilizando tu clave SSH. Esto puede suceder por varias razones, como la ausencia de una clave SSH configurada, la configuración incorrecta de la clave, o que la clave no esté asociada con tu cuenta de GitHub. Este error puede ser frustrante, especialmente para aquellos que son nuevos en el uso de Git y GitHub.

Causas Comunes

Las causas más frecuentes del error “git@github.com: Permission denied (publickey)” son:

1. No tienes una clave SSH en tu máquina: Si nunca has creado una clave SSH, Git no tendrá ninguna forma de autenticarte.
2. La clave SSH no está asociada con tu cuenta de GitHub: Aunque tengas una clave SSH, si no la has agregado a tu cuenta de GitHub, el acceso será denegado.
3. Permisos incorrectos en tu clave SSH: Si los permisos de tu clave son demasiado abiertos, GitHub no permitirá su uso.
4. Configuración incorrecta del archivo de configuración de SSH: Si el archivo config en tu directorio .ssh no está configurado correctamente, puede causar problemas de autenticación.
5. Uso del URL SSH incorrecto: Intentar acceder al repositorio usando un URL que requiere permisos de escritura cuando sólo tienes acceso de lectura.

Métodos de Solución

A continuación, se presentan varios métodos para resolver el error “git@github.com: Permission denied (publickey)”.

Método 1: Generar y agregar una clave SSH

1. Abre la terminal.
2. Navega a tu directorio .ssh ejecutando:
   bash
cd ~/.ssh
3. Genera una nueva clave SSH con el comando:
   bash
ssh-keygen
4. Presiona Enter para aceptar la ubicación predeterminada y proporciona una frase de contraseña si lo deseas.
5. Copia la clave pública al portapapeles con uno de los siguientes comandos, dependiendo de tu sistema operativo:
6. Para macOS:
   bash
cat id_rsa.pub | pbcopy
7. Para Linux:
   bash
cat id_rsa.pub | xclip
8. Para Windows (Powershell):
   powershell
Get-Content id_rsa.pub | Set-Clipboard
9. Accede a tu cuenta de GitHub, ve a “Settings” -> “SSH and GPG keys” y haz clic en “New SSH key”. Pega la clave copiada y guarda los cambios.

Método 2: Probar la conexión SSH

1. Abre la terminal y ejecuta el siguiente comando para verificar la conexión SSH:
   bash
ssh -vT git@github.com
2. Este comando te proporcionará un diagnóstico detallado sobre la conexión y puede ayudarte a identificar el problema.

Método 3: Verificar URL del repositorio

Asegúrate de usar la URL correcta para clonar tu repositorio. Debes usar la URL SSH si tienes permisos de escritura. Verifica la URL con el siguiente comando:
“`bash
git@github.com: