Corrige fallos de autenticación SFTP en NetDrive: claves, contraseñas y puertos

5 min de lectura troubleshooting sftp
Tayson
TaysonSenior Engineer
Soluciona errores de autenticación SFTP en NetDrive: problemas de formato de clave SSH, puertos incorrectos, fallos de verificación de host y contraseñas rechazadas en Windows y macOS.

Agregaste una conexión SFTP en NetDrive, hiciste clic en Conectar y obtuviste un error de autenticación, o la unidad se quedó en espera y falló en silencio después de treinta segundos. Los fallos de autenticación SFTP son el obstáculo más común al montar servidores Linux, dispositivos NAS y cuentas de hosting compartido. Casi todos los casos se remontan a una de tres causas: credenciales o configuración del host incorrectas, un formato de clave SSH incompatible, o una entrada obsoleta en la caché de claves de host.

NetDrive drive manager showing Google Drive, S3 and pCloud mounted as drive lettersMounted clouds appearing as native drives in Windows File Explorer

Monta cualquier servidor SFTP como una unidad nativa

NetDrive hace que Google Drive, OneDrive, S3, SFTP, WebDAV y más aparezcan como unidades nativas en Windows y macOS — sin sincronizar, sin descargas completas.

  • Compatible con autenticación por contraseña y por clave SSH
  • Funciona con servidores Linux, NAS Synology/QNAP y cuentas de hosting
  • Disponible en Windows y macOS
WindowsmacOS
Descargar NetDrive →

Prueba gratuita. Planes de por vida y de suscripción disponibles.

Relaciona tu síntoma con una causa

Antes de tocar ninguna configuración, identifica qué síntoma presentas:

SíntomaCausa más probable
”Authentication failed” de inmediatoUsuario, contraseña o clave incorrectos y no aceptados
Se queda entre 30 y 60 segundos y luego falla por tiempo de esperaNombre de host o puerto incorrecto; firewall bloqueando el puerto 22
”Host key verification failed”Primera conexión a este host, o la huella del servidor cambió
Monta brevemente y luego se caeTiempo de espera inactivo del servidor o inestabilidad de red

Este artículo cubre las tres primeras causas. Si tu unidad se desconecta tras estar inactiva, los patrones de keepalive de Fix Mount Disconnects After Sleep on macOS también aplican a SFTP.

Solución 1: Verifica las credenciales y la configuración del host

Abre el Drive Manager de NetDrive, selecciona tu unidad SFTP y haz clic en Edit. Revisa cada campo con atención:

  • Host — el nombre de host o la dirección IP del servidor, sin ningún prefijo sftp://. NetDrive añade el protocolo automáticamente. Una barra final aquí rompe la resolución.
  • Port — SFTP usa 22 de forma predeterminada. Si el administrador del servidor movió SSH a un puerto no estándar (una medida de endurecimiento habitual), introdúcelo explícitamente. Conectarse al puerto 22 cuando el servidor escucha en el 2222 produce un tiempo de espera agotado, no un mensaje de “authentication failed”, por eso suele pasarse por alto.
  • Username — distingue mayúsculas de minúsculas. Admin y admin son cuentas distintas en sistemas Linux.
  • Password — vuelve a introducirla aunque el campo parezca rellenado. Las credenciales guardadas pueden quedar obsoletas en silencio tras una rotación de contraseña en el servidor.

NetDrive mount status panel showing current connection state and drive health

Después de actualizar cualquier campo, haz clic en Connect en lugar de simplemente guardar. NetDrive solo valida las credenciales en un intento de conexión real, no al guardar.

Verifying the SFTP server IP address before connecting in NetDrive

Solución 2: Problemas de formato de clave SSH

La autenticación por clave SSH es más segura que la de contraseña, pero NetDrive requiere la clave privada en formato PEM: claves RSA que empiezan con -----BEGIN RSA PRIVATE KEY----- o claves ECDSA que empiezan con -----BEGIN EC PRIVATE KEY-----. Las versiones modernas de OpenSSH generan claves en un formato más nuevo (-----BEGIN OPENSSH PRIVATE KEY-----) de forma predeterminada, que NetDrive no acepta.

Para convertir una clave en formato OpenSSH a PEM en la máquina donde se generó la clave:

ssh-keygen -p -m PEM -f ~/.ssh/id_rsa

Esto reescribe el archivo de clave privada en su lugar. Haz una copia de seguridad antes de ejecutar este comando.

En la configuración de la unidad SFTP de NetDrive:

  1. Ajusta Auth type a Key en lugar de Password.
  2. En Private key file, busca el archivo de clave privada .pem en tu máquina local.
  3. Si la clave tiene una frase de contraseña, introdúcela en Key passphrase.
  4. Confirma que la clave pública correspondiente ya está en ~/.ssh/authorized_keys en el servidor remoto.

Una comprobación rápida del lado del servidor: ejecutar ssh -v user@hostname desde una terminal muestra qué métodos de autenticación ofrece el servidor y qué claves acepta. Las líneas que contienen Offering public key y Server accepts key confirman que el emparejamiento es correcto sin necesidad de involucrar a NetDrive.

Solución 3: Verificación de clave de host obsoleta

Cuando NetDrive se conecta a un host SFTP por primera vez, o después de que la huella SSH del servidor cambia por un reemplazo de hardware, una reinstalación del sistema operativo o la reutilización de una dirección IP, puede negarse a conectar con un error de clave de host.

NetDrive almacena las claves de host aceptadas en su caché interna de known-hosts. Para eliminar una entrada obsoleta:

  1. En Drive Manager, selecciona tu unidad SFTP y abre Edit.
  2. Busca la opción Clear known hosts o Reset host key en el panel de configuración avanzada.
  3. Reconecta. NetDrive te pedirá que aceptes la nueva huella.

Antes de aceptar una huella cambiada, verifícala de forma independiente ejecutando ssh-keyscan -t rsa hostname desde cualquier máquina que ya tenga acceso SSH al servidor, y compara la salida con lo que presenta NetDrive. Aceptar una huella inesperada en un servidor de producción es un riesgo de seguridad importante.

Verifying the port number for the SFTP server before connecting in NetDrive

Resumen

Los fallos de autenticación SFTP en NetDrive casi siempre se deben a las credenciales, el formato de clave o la configuración del host, no a NetDrive en sí. Trabaja las tres soluciones en orden (primero las credenciales, luego el formato de clave, luego la caché de claves de host) y aislarás la causa en pocos minutos. Si ninguna resuelve el problema, activa el registro detallado en las preferencias de NetDrive y publica el log en support.bdrive.com para un diagnóstico más profundo.

Lecturas relacionadas: Fix WebDAV Synology Connection Errors y Fix S3 Access Denied Errors in NetDrive.

— Tayson, NetDrive