ハンズオン(簡易版): SSM基礎 セッションマネージャ

事前作業3.2. IAMポリシーの作成 (handson-SSMSessionManagerPermissions-policy)

手順の目的 [why]

IAMポリシー"handson-SSMSessionManagerPermissions-policy"を作成します。

設定値の指定

設定値の指定

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

1. IAMポリシー名

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

変数の設定:

IAM_POLICY_NAME='handson-SSMSessionManagerPermissions-policy'

2. IAMポリシーパス

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

変数の設定:

IAM_POLICY_PATH='/handson-cli/'

3. IAMポリシーの説明

IAMポリシーの説明を指定します。

変数の設定:

IAM_POLICY_DESCRIPTION='Policy for handson-SSMSessionManagerPermissions-policy.'

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

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

変数の設定:

DIR_IAM_POLICY_DOC="${HOME}/environment/conf-handson-cli-ssm-session-manager"

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

変数の設定:

IAM_POLICY_DOC_NAME='handson-SSMSessionManagerPermissions-policy'

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

変数の設定:

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

結果(例):

${HOME}/environment/conf-handson-cli-ssm-session-manager/handson-SSMSessionManagerPermissions-policy.json

設定値の確認

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

変数の確認:

cat << END

  # 1. IAM_POLICY_NAME:"handson-SSMSessionManagerPermissions-policy"
       IAM_POLICY_NAME="${IAM_POLICY_NAME}"
  # 2. IAM_POLICY_PATH:"/handson-cli/"
       IAM_POLICY_PATH="${IAM_POLICY_PATH}"
  # 3. IAM_POLICY_DESCRIPTION:"Policy for handson-SSMSessionManagerPermissions-policy."
       IAM_POLICY_DESCRIPTION="${IAM_POLICY_DESCRIPTION}"
  # 4. FILE_IAM_POLICY_DOC:"${HOME}/environment/conf-handson-cli-ssm-session-manager/handson-SSMSessionManagerPermissions-policy.json"
       FILE_IAM_POLICY_DOC="${FILE_IAM_POLICY_DOC}"

END

下段の変数が入っていない、もしくは上段と同等の値が入っていない場合は、それぞれの手順番号に戻って変数の設定を行います。

処理の実行

IAMポリシーを作成します。

変数の確認:

cat << END

  # IAM_POLICY_NAME:"handson-SSMSessionManagerPermissions-policy"
    IAM_POLICY_NAME="${IAM_POLICY_NAME}"
  # IAM_POLICY_PATH:"/handson-cli/"
    IAM_POLICY_PATH="${IAM_POLICY_PATH}"
  # IAM_POLICY_DESCRIPTION:"Policy for handson-SSMSessionManagerPermissions-policy."
    IAM_POLICY_DESCRIPTION="${IAM_POLICY_DESCRIPTION}"
  # FILE_IAM_POLICY_DOC:"${HOME}/environment/conf-handson-cli-ssm-session-manager/handson-SSMSessionManagerPermissions-policy.json"
    FILE_IAM_POLICY_DOC="${FILE_IAM_POLICY_DOC}"

END

コマンド:

aws iam create-policy \
  --policy-name ${IAM_POLICY_NAME} \
  --path "${IAM_POLICY_PATH}" \
  --policy-document file://${FILE_IAM_POLICY_DOC} \
  --description "${IAM_POLICY_DESCRIPTION}"

結果(例):

{
  "Policy": {
    "PolicyName": "handson-SSMSessionManagerPermissions-policy",
    "CreateDate": "2021-04-09T01:23:45.678Z",
    "AttachmentCount": 0,
    "IsAttachable": true,
    "PolicyId": "ANPAxxxxxxxxxxxxxxxxx",
    "PermissionsBoundaryUsageCount": 0,
    "DefaultVersionId": "v1",
    "Path": "/handson-cli/",
    "Arn": "arn:aws:iam:::XXXXXXXXXXXX:policy/handson-SSMSessionManagerPermissions-policy",
    "UpdateDate": "2021-04-09T01:23:45.678Z"
  }
}

完了確認

「IAMポリシー"handson-SSMSessionManagerPermissions-policy"が存在する。」ことを確認します。

コマンド:

aws iam list-policies \
  --scope Local \
  --path-prefix "${IAM_POLICY_PATH}" \
  --max-items 1000 \
  --query "Policies[?PolicyName == \`${IAM_POLICY_NAME}\`].PolicyName" \
  --output text

結果(例):

handson-SSMSessionManagerPermissions-policy

手順の完了