IAMポリシーの書き方

IAM ポリシーの基本文法と、よくある書き方のパターンを整理します。

1. IAMポリシーの基本文法

IAMユーザやIAMロールの権限を具体的に記述する「IAMポリシー」の書き方について見ていきましょう。

IAMポリシーは、実際にはJSON(ジェイソン)という形式で記述されます。まずは、実際のポリシーの例を見てみましょう。以下は、「特定のS3バケットの中身(ファイル一覧)を見ることを許可する」という、非常にシンプルなポリシーです。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::example-bucket"
        }
    ]
}

少し難しそうに見えるかもしれませんが、重要なのは Statement の中にある3つの要素だけです。これらが権限の「3点セット」になっています。

2. Effect(効果)

まず、1つ目の要素である Effect(効果)についてです。ここには、例えば "Effect": "Allow" のように記述し、その操作を「許可(Allow)」するのか、それとも「拒否(Deny)」するのかを指定します。AWSには基本的に「何も書かれていなければすべて拒否される」というルールがあるため、通常はここに Allow と記述して、特定の操作ができるように許可を与えていきます。

3. Action(操作)

次に、2つ目の要素である Action(操作)についてです。ここには、具体的に「どのような操作」を許可したいのかを記述します。例えば "Action": "s3:ListBucket" のように、基本的には「サービス名:操作内容」という形式で指定します。この例であれば、「S3サービスの、バケット一覧を表示する(ListBucket)」という操作を指しています。また、ここには一つの操作だけでなく、カンマで区切って複数の操作をまとめて記述することも可能です。

4. Resource(対象)

最後に、3つ目の要素である Resource(対象)についてです。ここには、その操作を「どのリソース(対象)」に対して行わせるかを指定します。例えば "Resource": "arn:aws:s3:::example-bucket" と記述した場合、これは example-bucket という特定のバケットだけを操作の対象にする、という意味になります。一方で、もし特定のバケットに限らず「すべてのS3バケット」を対象にしたい場合は、アスタリスク(ワイルドカード)を使って "Resource": "*" と記述します。

つまり、IAMポリシーを書くということは、これら3つをつなぎ合わせて「どのリソース(Resource)に対して、何の操作(Action)を、許可する(Effect)」という短い文章を作成する作業に他なりません。この基本構造さえ理解しておけば、複雑に見えるポリシーもスムーズに読み解けるようになります。