ハンズオン(簡易版): IAM基礎(ポリシー)

4.2. IAMポリシーバージョンの作成 (Cloud9EnvironmentRead: v2)

手順の目的

IAMポリシー"Cloud9EnvironmentRead"のバージョンを作成します。

設定値の指定

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

1. IAMポリシー名

IAMポリシー名を指定します。

変数の設定:

IAM_POLICY_NAME='Cloud9EnvironmentRead'

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

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

変数の設定:

DIR_IAM_POLICY_DOC="${HOME}/environment/conf-handson-cli-iam"

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

変数の設定:

IAM_POLICY_DOC_NAME='Cloud9EnvironmentRead-v2'

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

変数の設定:

FILE_IAM_POLICY_DOC="${DIR_IAM_POLICY_DOC}/${IAM_POLICY_DOC_NAME}.json" \
  && echo ${FILE_IAM_POLICY_DOC}

結果(例):

${HOME}/environment/conf-handson-cli-iam/Cloud9EnvironmentRead-v2.json

設定値の確認

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

変数の確認:

cat << END

  # 1. IAM_POLICY_NAME:"Cloud9EnvironmentRead"
       IAM_POLICY_NAME="${IAM_POLICY_NAME}"
  # 2. FILE_IAM_POLICY_DOC:"${HOME}/environment/conf-handson-cli-iam/Cloud9EnvironmentRead-v2.json"
       FILE_IAM_POLICY_DOC="${FILE_IAM_POLICY_DOC}"

END

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

処理の実行

IAMポリシーのパスを取得します。

コマンド:

iam_policy_path=$( \
  aws iam list-policies \
    --scope Local \
    --query "Policies[?PolicyName == \`${IAM_POLICY_NAME}\`].Path" \
    --output text \
) \
  && echo ${iam_policy_path}

結果(例):

/handson-cli/

IAMポリシーのARNを取得します。

変数の設定:

iam_policy_arn=$( \
  aws iam list-policies \
    --scope Local \
    --path-prefix "${iam_policy_path}" \
    --query "Policies[?PolicyName == \`${IAM_POLICY_NAME}\`].Arn" \
    --output text \
) \
  && echo "${iam_policy_arn}"

結果(例):

arn:aws:iam::XXXXXXXXXXXX:policy/Cloud9EnvironmentRead

IAMポリシーバージョンを作成します。

変数の確認:

cat << END

  # iam_policy_arn:"arn:aws:iam::XXXXXXXXXXXX:policy/handson-cli/Cloud9EnvironmentRead"
    iam_policy_arn="${iam_policy_arn}"
  # FILE_IAM_POLICY_DOC:"${HOME}/environment/conf-handson-cli-iam/Cloud9EnvironmentRead-v2.json"
    FILE_IAM_POLICY_DOC="${FILE_IAM_POLICY_DOC}"

END

コマンド:

aws iam create-policy-version \
  --policy-arn ${iam_policy_arn} \
  --policy-document file://${FILE_IAM_POLICY_DOC}

結果(例):

{
  "PolicyVersion": {
    "CreateDate": "2023-05-15T01:23:45.678Z",
    "VersionId": "v2",
    "IsDefaultVersion": false
  }
}

完了確認

「IAMポリシー"Cloud9EnvironmentRead"にバージョン"v2"が存在する。」ことを確認します。

コマンド:

aws iam list-policy-versions \
  --policy-arn ${iam_policy_arn} \
  --query "max_by(Versions[], &CreateDate).VersionId" \
  --output text

結果(例):

v2

手順の完了