2.1.2. IAMロールの作成 (handson-iam-authentication-user-role)¶

手順の目的¶

IAMロール"handson-iam-authentication-user-role"を作成します。

設定値の指定¶

手順に必要な設定値を変数に格納をします。

1. IAMロール名¶

IAMロール名を指定します。

変数の設定:

readonly IAM_ROLE_NAME='handson-iam-authentication-user-role'

2. IAMロールパス¶

IAMロールパスを指定します。

変数の設定:

readonly IAM_ROLE_PATH='/handson-cli/'

3. 信頼ポリシードキュメントファイル名¶

信頼ポリシードキュメント用ディレクトリを指定します。

変数の設定:

readonly DIR_IAM_ROLE_DOC="${HOME}/conf-handson-iam-authentication"

信頼ポリシードキュメント名を指定します。

変数の設定:

readonly IAM_ROLE_DOC_NAME='handson-iam-authentication-user-role'

信頼ポリシードキュメントのファイル名を指定します。

変数の設定:

readonly FILE_IAM_ROLE_DOC="${DIR_IAM_ROLE_DOC}/${IAM_ROLE_DOC_NAME}.json" \
  && echo ${FILE_IAM_ROLE_DOC}

結果(例):

/home/cloudshell-user/conf-handson-iam-authentication/handson-iam-authentication-user-role.json

4. IAMロールの説明¶

IAMロールの説明を指定します。

変数の設定:

readonly IAM_ROLE_DESCRIPTION='Role for iam user.'

設定値の確認¶

各変数に正しい設定値が格納されていることを確認します。

変数の確認:

cat << END

  # 1. IAM_ROLE_NAME:"handson-iam-authentication-user-role"
       IAM_ROLE_NAME="${IAM_ROLE_NAME}"
  # 2. IAM_ROLE_PATH:"/handson-cli/"
       IAM_ROLE_PATH="${IAM_ROLE_PATH}"
  # 3. FILE_IAM_ROLE_DOC:"${HOME}/conf-handson-iam-authentication/handson-iam-authentication-user-role.json"
       FILE_IAM_ROLE_DOC="${FILE_IAM_ROLE_DOC}"
  # 4. IAM_ROLE_DESCRIPTION:"Role for iam user."
       IAM_ROLE_DESCRIPTION="${IAM_ROLE_DESCRIPTION}"

END

各変数について、上の行と下の行の値の内容もしくは形式が同じであることを確認します。もし異なる場合は、それぞれの手順番号に戻って変数の設定を行います。

処理の実行¶

IAMロールを作成します。

変数の確認:

cat << END

  # IAM_ROLE_NAME:"handson-iam-authentication-user-role"
    IAM_ROLE_NAME="${IAM_ROLE_NAME}"
  # IAM_ROLE_PATH:"/handson-cli/"
    IAM_ROLE_PATH="${IAM_ROLE_PATH}"
  # IAM_ROLE_DESCRIPTION:"Role for iam user."
    IAM_ROLE_DESCRIPTION="${IAM_ROLE_DESCRIPTION}"
  # FILE_IAM_ROLE_DOC:"${HOME}/conf-handson-iam-authentication/handson-iam-authentication-user-role.json"
    FILE_IAM_ROLE_DOC="${FILE_IAM_ROLE_DOC}"

END

コマンド:

aws iam create-role \
  --role-name ${IAM_ROLE_NAME} \
  --path ${IAM_ROLE_PATH} \
  --assume-role-policy-document file://${FILE_IAM_ROLE_DOC} \
  --description "${IAM_ROLE_DESCRIPTION}"

結果(例):

{
    "Role": {
        "Path": "/handson-cli/",
        "RoleName": "handson-iam-authentication-user-role",
        "RoleId": "AROAXXXXXXXXXXXXXXXXX",
        "Arn": "arn:aws:iam::XXXXXXXXXXXX:role/handson-cli/handson-iam-authentication-user-role",
        "CreateDate": "2026-05-28T01:23:45.678Z",
        "AssumeRolePolicyDocument": {
            "Version": "2012-10-17",
            "Statement": [
                {
                    "Sid": "",
                    "Effect": "Allow",
                    "Principal": {
                        "Service": "<サービス名>.amazonaws.com"
                    },
                    "Action": "sts:AssumeRole"
                }
            ]
        }
    }
}

完了確認¶

「IAMロール"handson-iam-authentication-user-role"が存在する。」ことを確認します。

コマンド:

aws iam list-roles \
  --query "Roles[?RoleName == \`${IAM_ROLE_NAME}\`].RoleName" \
  --output text

結果(例):

handson-iam-authentication-user-role

手順の完了確認¶

(参考) マネジメントコンソールの確認¶

IAMダッシュボード( https://console.aws.amazon.com/iam/home )にアクセスします。

左ペインの"ロール"をクリックします。

ロール一覧(画面)

検索欄にロール名"handson-iam-authentication-user-role"を入力して、エンターキーを押します。
ロール名"handson-iam-authentication-user-role"が表示されていることを確認します。