INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN

基本コース 9 / 18テーマ:IAM:認証とアクセス権限

IAMポリシーJSONの読み方:Effect・Action・Resourceを具体例で理解

IAMポリシーは、AWSでどの操作を許可・拒否するかをJSONで記述する文書です。最初はStatement(ルールのまとまり)の中にあるEffect・Action・Resourceを、1つの要求と照合して読みます。JSONの形式が正しいことと、目的の操作が最終的に許可されることは別です。

この教材で学ぶこと

1つのStatementを操作要求と照合し、不一致の箇所と、このJSONだけでは決まらない範囲を説明できる。

先に知っておくこと

IAMの主体・操作・対象、認証と認可の違い。実ポリシーを入力する必要はありません。

まず小さなStatementを読む

report.csvを読むための読解例。実環境へ貼り付けない
{
  "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を識別しやすくするための名前で、名前自体が許可を与えるわけではありません。

先に読む3つの要素
要素この例の値読むときの質問
EffectAllowこのルールは許可側か、明示的な拒否側か
Actions3:GetObject要求しているAPI操作と一致するか
Resourcedemo-bucket/report.csvのARN要求の対象と一致するか

操作と対象を、別々に照合する

同じバケットでも、操作と対象の両方が必要
同じバケットでも、操作と対象の両方が必要1: AllowのStatement — このStatementには一致する — GetObject / report.csv. 2: AllowのStatement — このStatementの許可対象ではない — PutObject / report.csv12AllowのStatementGetObject /report.csvPutObject /report.csv同じバケットでも、操作と対象の両方が必要1: AllowのStatement — このStatementには一致する — GetObject / report.csv. 2: AllowのStatement — このStatementの許可対象ではない — PutObject / report.csv12AllowのStatementGetObject /report.csvPutObject /report.csv
  1. AllowのStatement → GetObject / report.csvこのStatementには一致する
  2. 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の種類を確認してください。

要求を1つ変えたときの読解
要求この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のまま、要求だけをPutObjectへ変えました。このStatementは保存を許可していますか?
答えと理由を読む

正解:このStatementのActionに一致しない · Resourceが同じでも、ActionはGetObjectのままです。このStatementからPutObjectの許可は読み取れません。他のポリシーも含む最終認可は、この例だけでは決まりません。

JSONを読んだら、要求を1条件ずつ変える

  1. 要求する操作と対象を先に書く。
  2. 各StatementのEffect、Action、Resource、存在する条件を読む。
  3. 一致するルールと最終認可を分け、IAM演習で1条件の変化を確認する。

確認して、自分の言葉で説明する

  1. ActionがGetObjectかPutObjectかを確認する。
  2. Resourceが同じファイルかを確認する。
  3. 一致と最終認可を分けて理由を説明する。
理解を確かめる: JSONのVersionを今日の日付へ直す必要はある?

ない。Versionはポリシー言語の版。

作成日や更新日を書く場所ではありません。例の要素を変更する前に、その要素が何を意味するかを確認します。

出典と確認した条件

説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。