2.2.1. 信頼ポリシードキュメントの作成 (handson-iam-authentication-role-role)

手順の目的

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

設定値の指定

設定値の指定

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

1. プリンシパル名

ロールの利用を許可するIAMロールを指定します。

変数の設定:

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

2. 信頼ポリシー用ドキュメントディレクトリ

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

変数の設定:

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

ディレクトリが存在することを確認し、存在しない場合は作成します。

コマンド:

ls -d ${DIR_IAM_ROLE_DOC} > /dev/null 2>&1 \
  || mkdir -p ${DIR_IAM_ROLE_DOC}

結果(例):

(出力なし)

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

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

変数の設定:

readonly IAM_ROLE_DOC_NAME='handson-iam-authentication-role-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-role-role.json

設定値の確認

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

変数の確認:

cat << END

  # 1. IAM_ROLE_NAME:"handson-iam-authentication-role-role"
       IAM_ROLE_NAME="${IAM_ROLE_NAME}"
  # 2. DIR_IAM_ROLE_DOC:"${HOME}/conf-handson-iam-authentication"
       DIR_IAM_ROLE_DOC="${DIR_IAM_ROLE_DOC}"
  # 3. FILE_IAM_ROLE_DOC:"${HOME}/conf-handson-iam-authentication/handson-iam-authentication-role-role.json"
       FILE_IAM_ROLE_DOC="${FILE_IAM_ROLE_DOC}"

END

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

処理の実行

1. 前処理

主処理に必要な情報の取得

IAMロールARNの取得

IAMロールのARNを取得します。

コマンド:

iam_role_arn=$( \
  aws iam list-roles \
    --query "Roles[?RoleName == \`${IAM_ROLE_NAME}\` ].Arn" \
    --output text \
) \
  && echo ${iam_role_arn}

結果(例):

arn:aws:iam::XXXXXXXXXXXX:role/handson-cli/handson-iam-authentication-role-role

2. 主処理

信頼ポリシードキュメントを作成します。

変数の確認:

cat << END

  # FILE_IAM_ROLE_DOC:"${HOME}/conf-handson-iam-authentication/handson-iam-authentication-role-role.json"
    FILE_IAM_ROLE_DOC="${FILE_IAM_ROLE_DOC}"
  # iam_role_arn:"arn:aws:iam::XXXXXXXXXXXX:role/handson-cli/handson-iam-authentication-role-role"
    iam_role_arn="${iam_role_arn}"

END

コマンド:

cat << EOF > ${FILE_IAM_ROLE_DOC}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": "sts:AssumeRole",
      "Principal": {
        "AWS": "${iam_role_arn}"
      },
      "Effect": "Allow",
      "Sid": ""
    }
  ]
}
EOF

cat ${FILE_IAM_ROLE_DOC}

結果(例):

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": "sts:AssumeRole",
      "Principal": {
        "AWS": "arn:aws:iam::XXXXXXXXXXXX:role/handson-cli/handson-iam-authentication-role-role"
      },
      "Effect": "Allow",
      "Sid": ""
    }
  ]
}

JSONファイルを作成したら、フォーマットが壊れてないか必ず確認します。

コマンド:

cat ${FILE_IAM_ROLE_DOC} \
  |  python3 -m json.tool \
  > /dev/null

結果(例):

(出力なし)

注釈

エラーが出力されなければOKです。

3. 後処理

完了条件の確認

本手順の主処理は、以下の完了条件を満たしたときに成功したものとします。

完了条件1: 信頼ポリシードキュメント"${HOME}/conf-handson-iam-authentication/handson-iam-authentication-role-role.json"が存在する。

「信頼ポリシードキュメント"${HOME}/conf-handson-iam-authentication/handson-iam-authentication-role-role.json"が存在する。」ことを確認します。

コマンド:

ls ${FILE_IAM_ROLE_DOC}

結果(例):

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

手順の完了確認