基本コース 9 / 18テーマ:IAM:認証とアクセス権限
IAMポリシーJSONの読み方:Effect・Action・Resourceを具体例で理解
IAMポリシーは、AWSでどの操作を許可・拒否するかをJSONで記述する文書です。最初はStatement(ルールのまとまり)の中にあるEffect・Action・Resourceを、1つの要求と照合して読みます。JSONの形式が正しいことと、目的の操作が最終的に許可されることは別です。
1つのStatementを操作要求と照合し、不一致の箇所と、このJSONだけでは決まらない範囲を説明できる。
IAMの主体・操作・対象、認証と認可の違い。実ポリシーを入力する必要はありません。
まず小さなStatementを読む
{
"Version": "2012-10-17",
"Statement": [{
"Sid": "ReadOneReport",
"Effect": "Allow",
"Action": "s3:GetObject",
"Resource": "arn:aws:s3:::demo-bucket/report.csv"
}]
}波括弧はまとまり、角括弧は配列です。上のStatement配列にはルールが1つあります。Versionはポリシー言語の版で、作成日ではありません。SidはStatementを識別しやすくするための名前で、名前自体が許可を与えるわけではありません。
| 要素 | この例の値 | 読むときの質問 |
|---|---|---|
| Effect | Allow | このルールは許可側か、明示的な拒否側か |
| Action | s3:GetObject | 要求しているAPI操作と一致するか |
| Resource | demo-bucket/report.csvのARN | 要求の対象と一致するか |
操作と対象を、別々に照合する
- AllowのStatement → GetObject / report.csvこのStatementには一致する
- AllowのStatement → PutObject / report.csvこのStatementの許可対象ではない
- AllowのStatement
- この例はGetObjectとreport.csvを指定する。
- GetObject / report.csv
- この例のActionとResourceに一致する。最終認可は別に確認する。
- PutObject / report.csv
- 対象が同じでも、Actionが一致しない。
ARN(Amazon Resource Name)はAWSの資源を表す識別子です。この例の末尾はバケット名だけでなく、report.csvというオブジェクトのキーまで含みます。バケット自体を扱う操作と、バケット内のオブジェクトを扱う操作では、必要な対象の書き方が異なることがあります。操作に対応するResourceの種類を確認してください。
| 要求 | このStatementとの関係 |
|---|---|
| GetObjectでreport.csvを読む | ActionとResourceが一致する |
| PutObjectでreport.csvを保存 | Actionが一致しない |
| GetObjectでother.csvを読む | Resourceが一致しない |
Allowの発見と、最終的な許可を分ける
この例は1つのルールを読むためのものです。実環境では、他のStatement、資源に付けたポリシー、権限の上限、組織の制限、要求の条件などを確認します。適用される明示Denyがあれば、Allowを重ねてもそのDenyを打ち消せません。
Conditionは、ルールが適用される追加条件を表します。要求内容との照合を省いてよいという意味ではありません。NotAction・NotResourceなどの要素も存在しますが、Action・Resourceの単純な例へ勝手に読み替えず、それぞれの定義を確認します。
自分で照合してみる
選択すると、正誤と理由が表示されます。
JSONを読んだら、要求を1条件ずつ変える
- 要求する操作と対象を先に書く。
- 各StatementのEffect、Action、Resource、存在する条件を読む。
- 一致するルールと最終認可を分け、IAM演習で1条件の変化を確認する。
確認して、自分の言葉で説明する
- ActionがGetObjectかPutObjectかを確認する。
- Resourceが同じファイルかを確認する。
- 一致と最終認可を分けて理由を説明する。
理解を確かめる: JSONのVersionを今日の日付へ直す必要はある?
ない。Versionはポリシー言語の版。
作成日や更新日を書く場所ではありません。例の要素を変更する前に、その要素が何を意味するかを確認します。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件実IAMの構文は学習用の入力形式より広い。
参照した本文まず小さなStatementを読む 操作と対象を、別々に照合する Allowの発見と、最終的な許可を分ける 自分で照合してみる
確認した内容・条件ポリシーの種類と判定に必要な情報で結果が変わります。演習ではユーザー・ロールに付けたポリシーを中心に扱います。
参照した本文まず小さなStatementを読む 操作と対象を、別々に照合する Allowの発見と、最終的な許可を分ける 自分で照合してみる
確認した内容・条件ポリシー言語の版。管理ポリシーの改訂番号や作成日と区別する。
参照した本文まず小さなStatementを読む
確認した内容・条件Statementの任意の識別子。名前を付けることは操作の許可ではない。
参照した本文まず小さなStatementを読む
確認した内容・条件資源のARN、ワイルドカードの範囲、サービスごとの対応資源。最終認可の判定とは区別する。
参照した本文操作と対象を、別々に照合する