Tencent Cloud COS の認証エラーを解決する — NetDrive

読了目安 8 分 troubleshooting tencent-cloud
Steve
SteveSenior Engineer
NetDrive が Tencent Cloud COS バケットに接続できない場合は、SecretId/SecretKey のペア、CAM 権限、リージョンエンドポイント、バケット名、システム時計を確認して再接続しましょう。

あるゲームスタジオでは、夜間ビルドの成果物を Tencent Cloud Object Storage(COS)のバケットに保管し、QA リードの Windows ワークステーションが NetDrive でそのバケットをマウントして、テスターがドライブ文字から最新ビルドを取得しています。ところがセキュリティレビューでアカウントの API キーがすべてローテーションされ、翌朝ドライブが接続を拒否するようになりました。Tencent Cloud の認証失敗の原因は、ほとんどが次の 5 つのいずれかです。キーペア、その背後の CAM 権限、リージョンエンドポイント、バケット名、そしてマシンの時計です。このガイドではこの順に確認します。

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

Tencent Cloud ドライブを取り戻す

NetDrive を使えば Google Drive、OneDrive、S3、SFTP、WebDAV などが Windows と macOS でネイティブドライブとして表示されます — 同期も、まるごとダウンロードも不要です。

  • Windows や macOS で COS バケットをドライブとしてマウント
  • Drive Manager ですべてのドライブの状態を確認
  • 最初からやり直さずに認証情報を編集して再接続
WindowsmacOS
NetDrive をダウンロード →

無料トライアル。永久ライセンスとサブスクリプションプランあり。

エラーから原因を絞り込む

NetDrive はバージョン 3.17.799 から Tencent Cloud をサポートしており、Tencent Cloud ドライブを保存する際に接続を確認します。問題があるとエラーメッセージが表示され、動作するドライブカードは作成されません。フィールドを変更する前にメッセージを読んでください。COS のエラーコードはそれぞれ異なる問題を示します。

  • SignatureDoesNotMatch — SecretKey が SecretId と一致しない、またはどちらかの値に余分な文字が含まれたまま貼り付けられています。
  • InvalidAccessKeyId — Tencent Cloud がその SecretId を認識していません。削除、無効化、または入力ミスです。
  • AccessDenied — キーは有効ですが、キーを所有するユーザーにこのバケットへのアクセス権がありません。
  • NoSuchBucket — バケット名またはリージョンが、実在するバケットと一致していません。
  • RequestTimeTooSkewed — コンピューターの時計が Tencent Cloud の時刻から大きくずれているため、署名付きリクエストが受け付けられません。

エラーコードを書き留めておきましょう。1 つずつフィールドを修正し、その都度テストすれば、どの値が原因だったかがわかります。

クラウドドライブと接続状態を一覧表示する NetDrive の Drive Manager

チェック 1:SecretId と SecretKey のペア

Tencent Cloud の API キーは Tencent Cloud コンソールの CAM → API Keys で管理します。キーのローテーション後であれば、NetDrive に保存されたペアが最も疑わしい原因です。

  1. NetDrive が使用しているキーの所有ユーザーの API キー一覧を開きます。
  2. NetDrive に保存された SecretId が一覧に残っていて、有効になっているか確認します。
  3. 削除または無効化されていた場合は新しいキーを作成し、SecretId と SecretKey をすぐにコピーします。
  4. 両方の値を NetDrive の Tencent Cloud ドライブ設定に貼り付けます。先頭や末尾のスペースに注意してください。フィールド上では見えませんが、署名を壊します。

ローテーションで CAM サブユーザー自体が削除された場合は、キーも一緒に消えています。新しいキーを作成する前に、ユーザーがまだ存在するか確認してください。

チェック 2:バケットに対する CAM 権限

有効なキーで AccessDenied が返る場合、問題はキーではなくポリシーにあります。マウントにはルートアカウントのキーではなく CAM サブユーザーを使い、マウントするバケットへのアクセス権を付与してください。Tencent Cloud には QcloudCOSReadOnlyAccess や QcloudCOSFullAccess などのプリセットポリシーがあり、1 つのバケットに限定したカスタムポリシーを書くこともできます。

ポリシーはドライブの使い方に合わせましょう。読み取り専用ポリシーなら、テスターはビルドを閲覧・コピーできますが、ドライブへの保存はすべて失敗します。それが意図した動作なら、NetDrive の読み取り専用ドライブタイプでもマウントしてください。そうすれば制限が Explorer や Finder 上で明確になり、書き込み失敗としてだけ現れることはありません。NetDrive の読み取り専用ドライブを参照してください。

チェック 3:リージョンエンドポイントとバケット名

COS のエンドポイントはリージョンごとで、cos.<region>.myqcloud.com という形式に従います。たとえば cos.ap-guangzhou.myqcloud.com や cos.ap-singapore.myqcloud.com です。広州で作成したバケットはシンガポールのエンドポイントでは応答せず、その結果のエラーは認証失敗のように見えることがあります。コンソールでバケットの概要ページを開き、リージョンをそこからコピーしてください。記憶に頼らないようにしましょう。

COS のバケット名には、必ずアカウントの APPID がサフィックスとして付きます。build-artifacts ではなく build-artifacts-1250000001 です。サフィックスの付け忘れは NoSuchBucket のよくある原因です。NetDrive 上の名前とコンソールの名前を 1 文字ずつ比較してください。

設定を修正した後に NetDrive でドライブのマウント状態を確認する画面

チェック 4:システム時計

COS のリクエストはすべてタイムスタンプ付きで署名されます。コンピューターの時計が数分以上ずれていると、キーが完璧でも Tencent Cloud はリクエストを拒否します。長期間オフラインだったマシンや、古いスナップショットから復元した VM でよく起こります。Windows では Settings → Time & language → Date & time を開いて今すぐ同期します。macOS では System Settings → General → Date & Time で Set time and date automatically をオンにします。

ドライブを再接続する

誤っていた値を修正したら:

  1. Open NetDrive で、Drive Manager から Tencent Cloud ドライブを探します。
  2. ドライブの設定を開き、キーペア、エンドポイント、またはバケットを更新します。
  3. 保存して、NetDrive にもう一度接続を確認させます。
  4. ドライブカードから接続し、ファイルを 1 つ開いて読み取りができることを確認します。次に小さなテストファイルを保存して、書き込みができることを確認します。

既存のエントリを編集しても失敗する場合は、ドライブを削除し、コンソールで確認したばかりの値で追加し直してください。新しいエントリなら、古い保存設定の影響を排除できます。

認証は通るのにドライブの様子がおかしい場合

接続に成功しても Windows でドライブが表示されない場合は、別のデバイスがすでにそのドライブ文字を使っている可能性があります。ドライブ文字が使用中のエラーを解決するを参照してください。再接続後もフォルダーに昨日のビルドが表示される場合は、一覧が古くなっています。フォルダーの強制更新で最新の一覧を取得する方法を説明しています。

まとめ

Tencent Cloud COS の認証エラーはチェックリストとして片付けましょう。キーペア、CAM ポリシー、リージョンエンドポイント、APPID 付きのバケット名、そして時計の順です。一度に 1 つずつ変更し、Drive Manager から再接続してください。初回セットアップの全体は NetDrive で Windows に Tencent Cloud をマウントするまたは macOS 版を参照してください。Alibaba Cloud も使っているなら、Alibaba Cloud の認証エラーを解決するが同じ流れです。

— Steve, NetDrive