Alibaba Cloud の認証エラーを解決する — NetDrive
OSS バケットのマウント時に NetDrive が Alibaba Cloud の認証情報を拒否する場合は、アクセスキー、RAM 権限、エンドポイント、バケット名を確認して再接続しましょう。
先週まで問題なく Alibaba Cloud のバケットをマウントしていたビルドサーバーで、NetDrive が認証情報エラーを表示し、ドライブからアーティファクトを読み込む夜間ジョブが最初のファイルで失敗します。マシンには何も変更を加えていません。Alibaba Cloud ドライブの認証が通らなくなったとき、原因はほぼ必ず次の 4 つのいずれかです。アクセスキー、その背後にある権限、エンドポイント、バケット名です。このガイドでは、最も早く原因にたどり着ける順番で確認していきます。
Alibaba Cloud ドライブを復旧しましょう
NetDrive を使えば Google Drive、OneDrive、S3、SFTP、WebDAV などが Windows と macOS でネイティブドライブとして表示されます — 同期も、まるごとダウンロードも不要です。
- マウント前に認証情報をテスト
- Drive Manager で全ドライブの状態を確認
- マウント設定を失わずに再接続
無料トライアル。永久ライセンスとサブスクリプションプランあり。
変更する前にエラーを読む
Alibaba Cloud ドライブを保存すると NetDrive が接続をテストし、認証情報に問題があれば新しいドライブカードの代わりにインラインメッセージが表示されます。このメッセージが最初の手がかりです。キーが拒否された場合は Access Key ID またはシークレットが原因です。権限に関する拒否であれば、キーの背後にある RAM ユーザーが原因です。バケットにまったく到達できない場合は、たいていエンドポイントかバケット名が原因です。
フィールドを編集する前に、どのケースかを書き留めておいてください。複数の項目を同時に変更すると、何が効いたのか分からなくなります。
確認 1: アクセスキーのペア
NetDrive は Access Key ID と対応するシークレットを求めます。最も多い失敗は、もう使えなくなったキーペアです。
- Alibaba Cloud コンソールにサインインし、そのキーを所有する RAM ユーザーを開きます。
- キーが一覧に残っていて、ステータスが無効ではなく有効であることを確認します。
- キーをローテーションした場合、NetDrive に保存されている古いペアは使えません。新しいペアを作成し、両方の値をすぐにコピーしてください。シークレットは一度しか表示されません。
- 新しい値をドライブの設定に貼り付けます。コピー時に末尾へ空白が混ざりやすいので確認してください。
削除された RAM ユーザーのキーも、無効化されたキーと同じように失敗するため、ユーザーがまだ存在するか確認しましょう。
確認 2: RAM 権限
有効なキーでも、RAM ユーザーにバケットへの権限がなければ拒否されます。日常のマウントにはアカウントのルートキーではなく RAM ユーザーを使い、そのポリシーがマウントする特定のバケットへのアクセスを許可していることを確認してください。ドライブにファイルを書き込む必要がある場合、読み取り専用の権限では閲覧はできても最初の保存で失敗します。
最近ポリシーを厳しくしたなら、それが最有力の原因です。エラーが始まる前の状態とポリシーを比較してください。
確認 3: エンドポイントとバケット名
Alibaba Cloud のエンドポイントはリージョンごとに異なります。たとえば杭州は oss-cn-hangzhou.aliyuncs.com です。あるリージョンのバケットは別のリージョンのエンドポイントでは応答しないため、別プロジェクトからコピーして貼り付けると、認証エラーのように見えるエラーが発生します。コンソールでバケットの Overview ページを開き、そこからエンドポイントをコピーしてください。
次に Bucket フィールドをコンソールと一文字ずつ比較します。バケット名は正確である必要があります。1 文字違うだけでも、あるいはバケットを削除して別のリージョンに作り直した場合でも、間違ったキーと同じ症状になります。
ドライブを再接続する
間違っていたフィールドを修正したら、次の手順で進めます。
- NetDrive を開き、Drive Manager で Alibaba Cloud ドライブを探します。
- ドライブの設定を開き、キー、シークレット、エンドポイント、バケットを更新します。
- Test をクリックし、NetDrive がバケットに到達できると確認するまで待ちます。
- 保存し、カードからドライブを接続します。
既存の項目を編集してもエラーが解消しない場合は、ドライブを削除し、コンソールで確認した値を使って Add Drive ダイアログから追加し直してください。新しい項目にすれば、古い保存値が原因である可能性を排除できます。
認証は通るのにマウントが失敗する場合
Test が成功してもドライブが表示されない場合、問題は認証情報の段階を過ぎています。Windows ではドライブ文字がすでに使用中であることがよくある原因です。Fix Drive Letter Already in Use を参照してください。接続後にフォルダーが空だったり古く見えたりする場合は、Force Folder Refresh で説明している手動更新を試してください。
まとめ
Alibaba Cloud の認証エラーはチェックリストとして扱いましょう。キー、権限、エンドポイント、バケットの順です。一度に 1 つずつ直し、変更のたびに Test を使い、Drive Manager から再接続します。初回セットアップの全手順は Mount Alibaba Cloud on Windows with NetDrive を参照してください。姉妹サービスをお使いの場合は、Mount Tencent Cloud on Windows が同じ流れを説明しています。
— Steve, NetDrive