Solucionar errores de autenticación de Backblaze B2 — NetDrive

5 min de lectura troubleshooting backblaze-b2
Kai
KaiJunior Engineer
Resuelve los fallos de inicio de sesión de Backblaze B2 en NetDrive causados por claves de aplicación limitadas a un bucket, claves caducadas y pares de claves mal emparejados.

Una unidad de Backblaze B2 que el mes pasado se montaba sin problemas de repente lanza un error de autenticación, o una conexión completamente nueva rechaza credenciales copiadas y pegadas directamente desde la consola de Backblaze. En ambos casos, la causa suele estar en cómo funcionan las claves de aplicación de B2 y no en un problema de la cuenta en sí — las claves de B2 tienen restricciones y fechas de caducidad que un simple inicio de sesión con usuario y contraseña no tiene.

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

Montar Backblaze B2 como letra de unidad

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.

  • Subidas multiparte para archivos grandes
  • Las subidas en segundo plano mantienen la unidad receptiva durante las transferencias
  • Disponible en Windows, macOS y Linux (experimental)
WindowsmacOS
Descargar NetDrive →

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

Relacionar el error con una causa

Backblaze B2 admite conexiones de NetDrive desde la versión 3.5.434, y casi todos los fallos de autenticación encajan en uno de estos patrones:

SíntomaCausa más probable
”Access denied” o “unauthorized” que nombra un bucket concretoLa clave de aplicación está restringida a un bucket distinto del introducido
Credenciales que antes funcionaban fallan de repenteLa clave de aplicación caducó o se eliminó en la consola de Backblaze
El keyID y la key copiados y pegados se rechazan de inmediatoEspacios en blanco de más, un pegado truncado, o el par equivocado copiado de una lista con varias claves

Solución 1: comprobar la restricción de bucket de la clave de aplicación

Backblaze permite que una cuenta cree varias Application Key además de la Master Application Key original, y cada clave restringida puede limitarse a un único bucket por seguridad. Es la práctica correcta — una conexión de NetDrive dedicada a un solo bucket no debería usar una clave con acceso a toda la cuenta —, pero también implica que el nombre del bucket introducido en NetDrive debe coincidir exactamente con el bucket para el que se creó la clave, o la conexión fallará con un error que parece de credenciales inválidas.

Inicia sesión en la consola de Backblaze B2 y revisa el ajuste Allowed Bucket(s) de la clave. Si aparece un bucket concreto, confirma que ese nombre coincide exactamente con el que se introdujo como bucket en la configuración de la unidad de NetDrive — las mayúsculas/minúsculas y los guiones importan, ya que los nombres de bucket de B2 distinguen mayúsculas de minúsculas.

Logotipo del proveedor Backblaze B2 tal como aparece en la lista de proveedores de NetDrive

Solución 2: regenerar una clave caducada o eliminada

Las claves de aplicación en B2 pueden crearse con una fecha de caducidad, y una vez que esa fecha pasa, la clave deja de autenticarse sin ningún aviso dentro de NetDrive — la unidad simplemente ya no puede iniciar sesión. Ocurre lo mismo si una clave se eliminó o revocó directamente en la consola de Backblaze, lo cual se manifiesta de forma idéntica a una caducidad desde el punto de vista de NetDrive.

  1. En la consola de Backblaze, crea una nueva Application Key (o comprueba si la existente aparece como caducada/eliminada).
  2. Copia de inmediato el nuevo keyID y la nueva applicationKey — Backblaze solo muestra la clave de aplicación completa una vez, en el momento de la creación.
  3. En NetDrive, abre Drive Manager, selecciona la unidad B2, haz clic en Edit y sustituye los campos keyID y applicationKey por los nuevos valores.
  4. Haz clic en Connect para volver a autenticarte.

NetDrive Drive Manager mostrando las unidades en la nube configuradas, usado para editar una conexión de Backblaze B2

Solución 3: volver a introducir las credenciales en lugar de copiar y pegar fragmentos

Como las claves de aplicación de B2 son cadenas largas generadas aleatoriamente, un fallo habitual es copiar solo una parte de la clave — un triple clic que se salta un carácter final, o un pegado que arrastra un salto de línea accidental. Como Backblaze muestra la applicationKey completa solo una vez, no hay forma de verificar después una copia guardada frente a la consola.

Si las credenciales fallan inmediatamente después de la configuración y tanto la restricción de bucket como la caducidad son correctas, el camino más seguro es generar una clave de aplicación completamente nueva en lugar de intentar depurar una que posiblemente esté truncada:

  1. Elimina la clave antigua en la consola de Backblaze.
  2. Crea una nueva Application Key, limitada al bucket correcto.
  3. Pega primero el keyID y la applicationKey en un campo de texto sin formato para confirmar que no se incluyeron espacios ni saltos de línea, y luego introdúcelos en los campos de conexión de NetDrive.

Confirmación de que una unidad se conectó correctamente tras volver a autenticarse en NetDrive

Si nada de esto aplica

Si la restricción de bucket coincide, la clave no ha caducado, y una clave recién generada sigue fallando, comprueba que la cuenta en sí no tenga una retención por pago o verificación — B2 puede rechazar las llamadas a la API a nivel de cuenta con independencia de la validez de una clave individual, y eso se muestra en NetDrive como el mismo fallo de autenticación genérico.

Resumen

La mayoría de los fallos de autenticación de Backblaze B2 en NetDrive se reducen a una clave restringida que apunta al bucket equivocado, una clave caducada o eliminada, o un copiado y pegado corrupto de la larga cadena applicationKey. Para la configuración inicial en la que se basa esta solución de problemas, consulta Montar Backblaze B2 en Windows con NetDrive o Montar Backblaze B2 en macOS con NetDrive. Si una configuración de almacenamiento de objetos similar usa Amazon S3, Solucionar errores de Access Denied de S3 en NetDrive cubre el lado equivalente de permisos IAM del mismo problema.

— Kai, NetDrive