Solucionar errores de autenticación de Tencent Cloud COS — NetDrive
¿NetDrive no se conecta a tu bucket de Tencent Cloud COS? Revisa SecretId/SecretKey, permisos CAM, endpoint de región, nombre del bucket y reloj, y vuelve a conectar.
Un estudio de videojuegos guarda los artefactos de sus builds nocturnos en un bucket de Tencent Cloud Object Storage (COS), y la estación de trabajo Windows del responsable de QA monta ese bucket con NetDrive para que los testers tomen el build más reciente desde una letra de unidad. Entonces una revisión de seguridad rota todas las claves API de la cuenta, y a la mañana siguiente la unidad se niega a conectar. La mayoría de los fallos de autenticación de Tencent Cloud se reducen a cinco cosas: el par de claves, los permisos CAM detrás de él, el endpoint de región, el nombre del bucket o el reloj del equipo. Esta guía los revisa en ese orden.

Recupera tu unidad de Tencent Cloud
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.
- Monta buckets COS como unidad en Windows o macOS
- Drive Manager muestra el estado de cada unidad
- Edita las credenciales y reconecta sin empezar de cero
Prueba gratuita. Planes de por vida y de suscripción disponibles.
Relaciona el error con su causa probable
NetDrive admite Tencent Cloud desde la versión 3.17.799 y comprueba la conexión cuando guardas una unidad de Tencent Cloud. Si algo falla, recibes un mensaje de error y ninguna tarjeta de unidad funcional. Lee el mensaje antes de cambiar cualquier campo, porque los códigos de error de COS apuntan a problemas distintos:
- SignatureDoesNotMatch — la SecretKey no coincide con la SecretId, o uno de los valores se pegó con caracteres de más.
- InvalidAccessKeyId — Tencent Cloud no reconoce la SecretId. Se eliminó, se desactivó o se escribió mal.
- AccessDenied — la clave es válida, pero el usuario propietario no tiene permiso para acceder a este bucket.
- NoSuchBucket — el nombre del bucket o la región no coinciden con un bucket existente.
- RequestTimeTooSkewed — el reloj del equipo está demasiado desfasado respecto a la hora de Tencent Cloud como para aceptar la solicitud firmada.
Anota el código. Si corriges un campo cada vez y pruebas después de cada cambio, sabrás cuál causó el problema.

Comprobación 1: el par SecretId y SecretKey
Las claves API de Tencent Cloud se gestionan en la consola de Tencent Cloud en CAM → API Keys. Tras una rotación de claves, el par guardado en NetDrive es el sospechoso más probable.
- Abre la lista de claves API del usuario cuya clave usa NetDrive.
- Confirma que la SecretId guardada en NetDrive sigue en la lista y está activada.
- Si se eliminó o desactivó, crea una clave nueva y copia la SecretId y la SecretKey de inmediato.
- Pega ambos valores en la configuración de la unidad de Tencent Cloud en NetDrive. Cuidado con los espacios al principio o al final: no se ven en el campo y rompen la firma.
Si la rotación también eliminó el subusuario CAM, la clave desapareció con él. Comprueba que el usuario sigue existiendo antes de crear una clave nueva.
Comprobación 2: permisos CAM sobre el bucket
Una respuesta AccessDenied con una clave válida significa que el problema está en la política, no en la clave. Para montar, usa un subusuario CAM en lugar de la clave de la cuenta raíz y concédele acceso al bucket que vas a montar. Tencent Cloud ofrece políticas predefinidas como QcloudCOSReadOnlyAccess y QcloudCOSFullAccess, o puedes escribir una política personalizada limitada a un solo bucket.
Ajusta la política al uso de la unidad. Una política de solo lectura permite a los testers explorar y copiar builds, pero cualquier guardado en la unidad fallará. Si quieres ese comportamiento a propósito, monta también la unidad con el tipo de unidad de solo lectura de NetDrive. Así la restricción queda clara en el Explorador o en Finder y no aparece solo como escrituras fallidas. Consulta Unidad de solo lectura en NetDrive.
Comprobación 3: endpoint de región y nombre del bucket
Los endpoints de COS son específicos de cada región y siguen el patrón cos.<region>.myqcloud.com, por ejemplo cos.ap-guangzhou.myqcloud.com o cos.ap-singapore.myqcloud.com. Un bucket creado en Guangzhou no responderá en el endpoint de Singapur, y el error resultante puede parecer un fallo de credenciales. Abre la página de resumen del bucket en la consola y copia la región desde allí. No te fíes de la memoria.
En COS, los nombres de bucket siempre llevan el APPID de la cuenta como sufijo: build-artifacts-1250000001, no build-artifacts. Omitir el sufijo es la causa habitual de NoSuchBucket. Compara el nombre en NetDrive con el de la consola carácter por carácter.

Comprobación 4: el reloj del sistema
Cada solicitud a COS se firma con una marca de tiempo. Si el reloj del equipo se ha desviado varios minutos, Tencent Cloud rechaza la solicitud aunque la clave sea perfecta. Suele ocurrir en equipos que estuvieron mucho tiempo sin conexión o en máquinas virtuales restauradas desde una instantánea antigua. En Windows, abre Settings → Time & language → Date & time y sincroniza ahora. En macOS, activa Set time and date automatically en System Settings → General → Date & Time.
Reconectar la unidad
Una vez corregido el valor erróneo:
- Open NetDrive y busca la unidad de Tencent Cloud en Drive Manager.
- Abre la configuración de la unidad y actualiza el par de claves, el endpoint o el bucket.
- Guarda y deja que NetDrive vuelva a comprobar la conexión.
- Conecta la unidad desde su tarjeta y abre un archivo para confirmar que la lectura funciona. Luego guarda un pequeño archivo de prueba para confirmar que la escritura funciona.
Si editar la entrada existente sigue fallando, elimina la unidad y vuelve a añadirla con los valores que acabas de comprobar en la consola. Una entrada nueva descarta cualquier configuración guardada obsoleta.
Cuando la autenticación pasa pero la unidad sigue fallando
Si la conexión se realiza pero la unidad sigue sin aparecer en Windows, puede que otro dispositivo ya esté usando esa letra de unidad. Consulta Solucionar el error de letra de unidad en uso. Si tras reconectar las carpetas muestran los builds de ayer, el listado está desactualizado. Forzar la actualización de carpetas explica cómo obtener uno nuevo.
Resumen
Resuelve un error de autenticación de Tencent Cloud COS como una lista de verificación: par de claves, política CAM, endpoint de región, nombre del bucket con APPID y, por último, el reloj. Cambia una sola cosa cada vez y reconecta desde Drive Manager. Para la configuración inicial completa, consulta Montar Tencent Cloud en Windows con NetDrive o la versión para macOS. Si también usas Alibaba Cloud, Solucionar errores de autenticación de Alibaba Cloud sigue el mismo patrón.
— Steve, NetDrive