Tencent-Cloud-COS-Authentifizierungsfehler beheben — NetDrive
NetDrive verbindet sich nicht mit Ihrem Tencent-Cloud-COS-Bucket? Prüfen Sie SecretId/SecretKey, CAM-Rechte, Regions-Endpoint, Bucket-Namen und Systemuhr, dann neu verbinden.
Ein Spielestudio legt seine nächtlichen Build-Artefakte in einem Bucket von Tencent Cloud Object Storage (COS) ab, und die Windows-Workstation der QA-Leitung bindet diesen Bucket über NetDrive ein, damit Tester den neuesten Build über einen Laufwerksbuchstaben holen können. Dann rotiert eine Sicherheitsprüfung alle API-Schlüssel im Konto, und am nächsten Morgen verweigert das Laufwerk die Verbindung. Die meisten Authentifizierungsfehler bei Tencent Cloud lassen sich auf fünf Dinge zurückführen: das Schlüsselpaar, die CAM-Berechtigungen dahinter, den Regions-Endpoint, den Bucket-Namen oder die Uhr des Rechners. Diese Anleitung prüft sie in genau dieser Reihenfolge.

Holen Sie Ihr Tencent-Cloud-Laufwerk zurück
Mit NetDrive erscheinen Google Drive, OneDrive, S3, SFTP, WebDAV und mehr als native Laufwerke unter Windows und macOS — ohne Synchronisation, ohne vollständige Downloads.
- COS-Buckets unter Windows oder macOS als Laufwerk einbinden
- Drive Manager zeigt den Status jedes Laufwerks
- Zugangsdaten bearbeiten und neu verbinden, ohne neu anzufangen
Kostenlose Testversion. Lifetime- und Abo-Pläne verfügbar.
Ordnen Sie den Fehler der wahrscheinlichen Ursache zu
NetDrive unterstützt Tencent Cloud seit Version 3.17.799 und prüft die Verbindung, wenn Sie ein Tencent-Cloud-Laufwerk speichern. Stimmt etwas nicht, erhalten Sie eine Fehlermeldung und keine funktionierende Laufwerkskarte. Lesen Sie die Meldung, bevor Sie ein Feld ändern, denn COS-Fehlercodes weisen auf unterschiedliche Probleme hin:
- SignatureDoesNotMatch — der SecretKey passt nicht zur SecretId, oder einer der Werte wurde mit zusätzlichen Zeichen eingefügt.
- InvalidAccessKeyId — Tencent Cloud kennt die SecretId nicht. Sie wurde gelöscht, deaktiviert oder vertippt.
- AccessDenied — der Schlüssel ist gültig, aber der Benutzer, dem er gehört, darf nicht auf diesen Bucket zugreifen.
- NoSuchBucket — Bucket-Name oder Region passen zu keinem existierenden Bucket.
- RequestTimeTooSkewed — die Uhr des Computers weicht zu weit von der Zeit bei Tencent Cloud ab, als dass die signierte Anfrage akzeptiert würde.
Notieren Sie den Code. Wenn Sie jeweils nur ein Feld korrigieren und danach testen, wissen Sie, welches das Problem verursacht hat.

Prüfung 1: Das Paar aus SecretId und SecretKey
Tencent-Cloud-API-Schlüssel verwalten Sie in der Tencent-Cloud-Konsole unter CAM → API Keys. Nach einer Schlüsselrotation ist das in NetDrive gespeicherte Paar die wahrscheinlichste Ursache.
- Öffnen Sie die API-Schlüsselliste des Benutzers, dessen Schlüssel NetDrive verwendet.
- Prüfen Sie, ob die in NetDrive gespeicherte SecretId noch in der Liste steht und aktiviert ist.
- Wurde sie gelöscht oder deaktiviert, erstellen Sie einen neuen Schlüssel und kopieren Sie SecretId und SecretKey sofort.
- Fügen Sie beide Werte in die Einstellungen des Tencent-Cloud-Laufwerks in NetDrive ein. Achten Sie auf ein Leerzeichen am Anfang oder Ende. Es ist im Feld unsichtbar und macht die Signatur ungültig.
Hat die Rotation auch den CAM-Unterbenutzer gelöscht, ist der Schlüssel mit ihm verschwunden. Prüfen Sie, ob der Benutzer noch existiert, bevor Sie einen neuen Schlüssel erstellen.
Prüfung 2: CAM-Berechtigungen für den Bucket
Eine AccessDenied-Antwort trotz gültigem Schlüssel bedeutet, dass das Problem in der Richtlinie liegt, nicht im Schlüssel. Verwenden Sie zum Einbinden einen CAM-Unterbenutzer statt des Root-Konto-Schlüssels und gewähren Sie ihm Zugriff auf den einzubindenden Bucket. Tencent Cloud bietet vordefinierte Richtlinien wie QcloudCOSReadOnlyAccess und QcloudCOSFullAccess, oder Sie schreiben eine eigene Richtlinie, die auf einen Bucket beschränkt ist.
Passen Sie die Richtlinie an die Nutzung des Laufwerks an. Mit einer Nur-Lese-Richtlinie können Tester Builds durchsuchen und kopieren, aber jedes Speichern auf dem Laufwerk schlägt fehl. Wenn Sie dieses Verhalten bewusst wollen, binden Sie das Laufwerk zusätzlich mit dem schreibgeschützten Laufwerkstyp von NetDrive ein. So ist die Einschränkung im Explorer oder Finder klar erkennbar und zeigt sich nicht nur als fehlgeschlagene Schreibvorgänge. Siehe Schreibgeschütztes Laufwerk in NetDrive.
Prüfung 3: Regions-Endpoint und Bucket-Name
COS-Endpoints sind regionsspezifisch und folgen dem Muster cos.<region>.myqcloud.com, zum Beispiel cos.ap-guangzhou.myqcloud.com oder cos.ap-singapore.myqcloud.com. Ein in Guangzhou erstellter Bucket antwortet nicht auf dem Endpoint in Singapur, und der resultierende Fehler kann wie ein Zugangsdatenfehler aussehen. Öffnen Sie die Übersichtsseite des Buckets in der Konsole und kopieren Sie die Region von dort. Verlassen Sie sich nicht auf Ihr Gedächtnis.
Bucket-Namen in COS tragen immer die APPID des Kontos als Suffix: build-artifacts-1250000001, nicht build-artifacts. Ein fehlendes Suffix ist die übliche Ursache für NoSuchBucket. Vergleichen Sie den Namen in NetDrive Zeichen für Zeichen mit der Konsole.

Prüfung 4: Die Systemuhr
Jede COS-Anfrage wird mit einem Zeitstempel signiert. Weicht die Uhr des Computers um mehrere Minuten ab, lehnt Tencent Cloud die Anfrage ab, auch wenn der Schlüssel einwandfrei ist. Das passiert vor allem bei Rechnern, die lange offline waren, oder bei VMs, die aus einem alten Snapshot wiederhergestellt wurden. Öffnen Sie unter Windows Settings → Time & language → Date & time und synchronisieren Sie jetzt. Aktivieren Sie unter macOS Set time and date automatically in System Settings → General → Date & Time.
Das Laufwerk neu verbinden
Sobald Sie den falschen Wert korrigiert haben:
- Open NetDrive und suchen Sie das Tencent-Cloud-Laufwerk im Drive Manager.
- Öffnen Sie die Einstellungen des Laufwerks und aktualisieren Sie Schlüsselpaar, Endpoint oder Bucket.
- Speichern Sie und lassen Sie NetDrive die Verbindung erneut prüfen.
- Verbinden Sie das Laufwerk über seine Karte und öffnen Sie eine Datei, um das Lesen zu bestätigen. Speichern Sie dann eine kleine Testdatei, um das Schreiben zu bestätigen.
Schlägt das Bearbeiten des vorhandenen Eintrags weiterhin fehl, löschen Sie das Laufwerk und fügen Sie es mit den eben in der Konsole geprüften Werten neu hinzu. Ein frischer Eintrag schließt veraltete gespeicherte Einstellungen aus.
Wenn die Authentifizierung klappt, das Laufwerk aber weiter hakt
Ist die Verbindung erfolgreich und das Laufwerk erscheint unter Windows trotzdem nicht, verwendet möglicherweise schon ein anderes Gerät den Laufwerksbuchstaben. Siehe Fehler „Laufwerksbuchstabe bereits belegt“ beheben. Zeigen Ordner nach dem Neuverbinden noch die Builds von gestern, ist die Auflistung veraltet. Ordneraktualisierung erzwingen erklärt, wie Sie eine frische holen.
Fazit
Arbeiten Sie einen Tencent-Cloud-COS-Authentifizierungsfehler wie eine Checkliste ab: Schlüsselpaar, CAM-Richtlinie, Regions-Endpoint, Bucket-Name mit APPID, dann die Uhr. Ändern Sie immer nur eine Sache und verbinden Sie über den Drive Manager neu. Die vollständige Ersteinrichtung finden Sie unter Tencent Cloud unter Windows mit NetDrive einbinden oder in der macOS-Version. Wenn Sie auch Alibaba Cloud nutzen, folgt Alibaba-Cloud-Authentifizierungsfehler beheben demselben Muster.
— Steve, NetDrive