こんにちは、Reoです。
フリーランスのインフラエンジニアとして働きながら、InfraDojo(インフラ道場)を運営しています。
S3を操作していて、こんなエラーが出たことはありませんか?
An error occurred (AccessDenied) when calling the ListObjectsV2 operation: Access Denied
「権限が足りないのかな」と考えるところまでは分かっても、何を確認すればよいのか迷いますよね。
そんなときは、まず次の3つを整理します。
誰が、何を、どこに対して実行したのか。
今回はAWS CLIを使って、設定を変更する前の確認方法を紹介します。
この記事で使う環境
次の環境を想定しています。
- AWS CLI v2がインストールされている
- 利用するプロファイルの認証設定が済んでいる
- 確認を許可されたS3の汎用バケットがある
コマンド内のlearningは、自分のプロファイル名へ置き換えてください。
バケット名やキー名も例なので、実際の確認対象に変更します。
掲載する出力は説明用の例です。コマンドは一覧やメタデータの取得に使い、ファイルや権限設定の変更は行いません。
最初に「誰が・何を・どこへ」を整理する
S3のアクセス拒否を調べるとき、対象のバケットだけを見ても原因を絞り込めないことがあります。
想定と違うロールで実行していたり、一覧取得とファイル取得を混同していたりするためです。
まず、リクエストの前提をそろえましょう。
① 誰の認証情報で実行しているか確認する
最初に、CLIが使っている認証情報の主体を確認します。
aws sts get-caller-identity \
--profile learning \
--query '{Account:Account,Arn:Arn}' \
--output json \
--no-cli-pager
出力例です。
{
"Account": "123456789012",
"Arn": "arn:aws:sts::123456789012:assumed-role/LearningRole/example-session"
}
確認するのは、主に次の2点です。
| 項目 | 確認すること |
|---|---|
Account |
想定したAWSアカウントか |
Arn |
想定したユーザーやロールか |
AWSコンソールとCLIで、別の認証情報を使っている場合もあります。
「コンソールでは見えるのに、CLIでは拒否される」なら、まず実行主体を比較します。
ただし、このコマンドが成功しても、S3へのアクセス権限があることまでは分かりません。確認できるのは、呼び出しに使っているユーザーやロールです。AWSの仕様
② 一覧取得なのか、オブジェクトの確認なのかを分ける
「S3にアクセスする」といっても、操作によって必要な権限は違います。
今回は、次の2つを比較します。
| 操作 | CLIコマンド | 必要となるS3の権限 |
|---|---|---|
| キーの一覧を取得する | list-objects-v2 |
s3:ListBucket |
| オブジェクトのメタデータを取得する | head-object |
s3:GetObject |
通常の、バージョンIDを指定しない操作を想定しています。一覧取得の仕様、メタデータ取得の仕様
キーの一覧を確認する
aws s3api list-objects-v2 \
--bucket example-bucket \
--prefix 'logs/' \
--max-keys 5 \
--no-paginate \
--profile learning \
--query 'Contents[].Key' \
--output json \
--no-cli-pager
出力例です。
[
"logs/app.log",
"logs/error.log"
]
この例では、logs/で始まるキーについて、最初の1回の応答で最大5件を確認します。全件取得するコマンドではありません。
特定のオブジェクトのメタデータを確認する
aws s3api head-object \
--bucket example-bucket \
--key 'logs/app.log' \
--profile learning \
--query '{Size:ContentLength,Type:ContentType}' \
--output json \
--no-cli-pager
出力例です。
{
"Size": 128,
"Type": "text/plain"
}
こちらは、ファイル本体をダウンロードせずに、サイズなどのメタデータを確認する操作です。
一覧が取得できることと、個別のオブジェクトへアクセスできることは、分けて確認します。
たとえば、一覧取得が成功してhead-objectが拒否されたなら、実行主体と対象キーをそろえたうえで、オブジェクト側の権限や条件を調べる手がかりになります。
③ バケット名とキー名が合っているか確認する
次に、操作対象を確認します。
s3://example-bucket/logs/app.log
この場合は、次のように分かれます。
バケット名:example-bucket
キー名 :logs/app.log
--keyに指定するのは、s3://から始まるURL全体ではありません。
また、次のキーは別のものです。
logs/app.log
Logs/app.log
logs/app.log.txt
大文字・小文字や拡張子まで確認しましょう。
403だからといって、ファイルが存在するとは限らない
ここが、つまずきやすいポイントです。
存在しないキーにhead-objectを実行した場合でも、呼び出し元に s3:ListBucket権限がなければ、404ではなく403が返ります。
そのため、403という結果だけでは、対象キーの存在を判断できません。 AWSのエラー応答仕様
一覧取得が許可されているなら実際のキーを確認し、一覧取得もできない場合は管理者に対象の存在を確認してもらいます。
3点が合っていたら、ポリシーや条件を調べる
実行主体・操作・対象が正しいと分かったら、アクセスを制御している設定を確認します。
主な確認先には、次のものがあります。
- 実行しているユーザーやロールのIAMポリシー
- 対象バケットのバケットポリシー
- OrganizationsのSCPや、VPCエンドポイントポリシーなどの制約
- ダウンロード時などに関係する、SSE-KMSの鍵の権限
適用される明示的なDenyがある場合、別のポリシーにAllowを追加しても解決しません。また、SSE-KMSでは、メタデータ確認が成功しても、本体の取得に必要なKMS権限まで確認できたとは限りません。AWSのトラブルシューティング
エラー文に理由が含まれていれば、その内容も確認します。
管理者へ相談するときも、「S3が使えません」だけでなく、次の情報をそろえると調べやすくなります。
実行した日時:
実行主体のARN:
実行したコマンド:
対象のバケット名・キー名:
エラーメッセージ:
共有時は、認証情報や業務上の機密情報を含めないようにします。
まずは、失敗した操作を具体的にする
S3でアクセス拒否が出たときは、次の順番で確認してみてください。
-
get-caller-identityで実行主体を確認する - 一覧取得とオブジェクトへの操作を分ける
- バケット名・キー名を確認する
- その結果をもとに、権限や条件を調べる
最初の目標は、すべての権限設定を覚えることではありません。
「誰が、どの対象に、何をしようとして拒否されたのか」を説明できること。
ここまで整理できると、次に調べる場所を絞りやすくなります。
コマンドの結果から、状況を整理する練習を
今回のような切り分けでは、コマンドを入力するだけでなく、結果を読んで「何が分かったか」を整理することが大切です。
僕自身も学習に使っているInfraDojo(インフラ道場)では、ブラウザ上のターミナルでLinuxコマンドを入力しながら学べます。
これからインフラを学ぶ初心者の方にも、基礎を確認し直したい現役エンジニアの方にも、手を動かす学習先の一つとして活用してもらえたら嬉しいです。
▼ InfraDojo(インフラ道場)
