【初心者向け】手を動かして理解するIAMスイッチロール

2024.11.29

この記事を書いたメンバー：

榊原慶太

BeeXの榊原です。今回社内で急遽スイッチロールの説明をすることになったのですが、せっかくなので記事化して今後も使いまわせる形でアウトプットすることにしました。初学者向けに一部砕けた表現をしておりますので、あらかじめご了承ください。

登場リソース

スイッチロール元・先のアカウントの構成図を用意したので早速ご覧ください。

スイッチロールに必要な要素は以下4つです。
➀スイッチロールするAWSリソース：今回はIAMユーザーです
➁AWSリソースにアタッチするIAMポリシー：今回はスイッチロール先のIAMロールのARNを記載して、このIAMロールへのスイッチロールを許可します。
➂スイッチロールを引き受けるIAMロール（クロスアカウントロール）：そのままの意味です。IAMロールの信頼ポリシーにはスイッチロールするリソースの情報を記載します。今回であればIAMユーザーのARNを記述します。
➃IAMロールにアタッチするIAMポリシー：スイッチロールしてどのような操作ができるようになるか記載されています。場合によっては複数のIAMポリシーがアタッチされます。

※今回は実際に使われるケースを想定してアカウントを跨がせていますが、➀～➃のリソースを1つのアカウント内に全て作れば、同じアカウント内でスイッチロールすることも可能です。

実際に手を動かそう

ではここからは自身の環境で再現してみましょう。

今回の構成

どこで何をしているかわからなくなったらこの構成図に戻って確認しましょう。

スイッチ元アカウントの操作（IAMユーザー作成）

まずスイッチ元のIAMユーザー（➀）を作成します。スイッチ元のIAMコンソールからIAMユーザーを作成します。

ユーザー名は自由ですが今回はSwitchRoleUserとしています。「AWSマネジメントコンソールへのユーザーアクセスを提供する」にはチェックを入れてください。

アタッチするポリシーは後ほどIAMポリシー（➁）をアタッチするのでIAMFullAccessをアタッチします。

Nameタグにも同じくSwitchRoleUserを付けます。

これでIAMユーザーの作成が完了です。後ほど作成したユーザーでAWSコンソールにログインするため、表示される認証情報は手元にメモしておきましょう。

作成したIAMユーザーのARNをメモします。

スイッチ先アカウントの操作（IAMロール作成）

次はスイッチ用のIAMロール（➂）を用意します。IAMロールにつけるIAMポリシー（➃）は今回AmazonEC2ReadOnlyAccessを用いるので新規作成は不要です。

IAMロールの作成画面に移り、信頼されたエンティティタイプはカスタム信頼ポリシーを選択し、下記のJSONファイルを入力してください。"AWS": の後ろは上でメモしたIAMユーザーのARNに書き換えてください。

 {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
              "AWS": "IAMユーザーのARN"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

次の画面ではAmazonEC2ReadOnlyAccessを選択します。

ロール名とNameタグにSwitchRole（任意の値で可）と入力します。

これでスイッチロール用のIAMロール（➂）が完成です。ARNをメモしましょう。

加えてスイッチ先アカウントのIDも控えましょう。（上でメモしたARNに含まれる12桁のIDです）

スイッチ元アカウントの操作（IAMポリシー作成＆スイッチ）

最後にIAMユーザーに与えるIAMポリシー（➁）を作成します。スイッチ元のアカウントのAWSコンソールには、最初に作成したSwitchRoleUserでサインインしてください。

IAMポリシー作成画面に行き、下記のJSONを入力してください。"Resource": の後ろは直前でメモしたIAMロールのARNに書き換えてください。

 {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "sts:AssumeRole",
            "Resource": "IAMロールのARN"
        }
    ]
}