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

事前作業4.4. APIアクセスキーの作成 (handson-cli-ssm-session-manager-user)

手順の目的 [why]

IAMユーザー"handson-cli-ssm-session-manager-user"のAPIアクセスキーを作成します。

設定値の指定

設定値の指定

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

1. IAMユーザー

アクセスキーを作成するユーザー名を指定します。

変数の設定:

IAM_USER_NAME='handson-cli-ssm-session-manager-user'

2. アクセスキーディレクトリ名

アクセスキーを保存するディレクトリ名を指定します。

変数の設定:

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

ディレクトリが存在することを確認します。

コマンド:

ls -d ${DIR_ACCESS_KEY}

結果(例:存在する場合):

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

存在しない場合は作成します。

コマンド:

mkdir -p ${DIR_ACCESS_KEY}

結果(例):

(出力なし)

設定値の確認

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

変数の確認:

cat << END

  # 1. IAM_USER_NAME:"handson-cli-ssm-session-manager-user"
       IAM_USER_NAME="${IAM_USER_NAME}"
  # 2. DIR_ACCESS_KEY:"${HOME}/environment/conf-handson-cli-ssm-session-manager"
       DIR_ACCESS_KEY="${DIR_ACCESS_KEY}"

END

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

処理の実行

現在存在するアクセスキーの数を確認します。

コマンド:

COUNT_IAM_ACCESS_KEYS=$( \
  aws iam list-access-keys \
    --user-name ${IAM_USER_NAME} \
    --query 'length(AccessKeyMetadata[])' \
) \
  && echo ${COUNT_IAM_ACCESS_KEYS}

結果(例):

0

作成するアクセスキーのファイル名を指定します。

変数の設定:

FILE_ACCESS_KEY="${DIR_ACCESS_KEY}/${IAM_USER_NAME}-token-${COUNT_IAM_ACCESS_KEYS}.json" \
  && echo ${FILE_ACCESS_KEY}

結果(例):

${HOME}/environment/conf-handson-cli-ssm-session-manager/handson-cli-ssm-session-manager-user-token-0.json

アクセスキーを作成します。

変数の確認:

cat << END

  # IAM_USER_NAME:"handson-cli-ssm-session-manager-user"
    IAM_USER_NAME="${IAM_USER_NAME}"
  # FILE_ACCESS_KEY:"${HOME}/environment/conf-handson-cli-ssm-session-manager/handson-cli-ssm-session-manager-user-token-0.json"
    FILE_ACCESS_KEY="${FILE_ACCESS_KEY}"

END

コマンド:

aws iam create-access-key \
  --user-name ${IAM_USER_NAME} \
  > ${FILE_ACCESS_KEY} \
    && cat ${FILE_ACCESS_KEY}

結果(例):

{
  "AccessKey": {
    "UserName": "handson-cli-ssm-session-manager-user",
    "Status": "Active",
    "CreateDate": "2021-04-09T01:23:45.678Z",
    "SecretAccessKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "AccessKeyId": "AKIAxxxxxxxxxxxxxxxx"
  }
}

完了確認

「IAMユーザー"handson-cli-ssm-session-manager-user"のActiveなアクセスキーが存在する。」ことを確認します。

コマンド:

aws iam list-access-keys \
  --user-name ${IAM_USER_NAME} \
  --query 'AccessKeyMetadata[].[join(``,[CreateDate,`,`,Status])]' \
  --output text

結果(例):

2021-04-09T01:23:45Z,Active

「アクセスキーファイル"${HOME}/environment/conf-handson-cli-ssm-session-manager/handson-cli-ssm-session-manager-user-token-0.json"が存在する。」ことを確認します。

コマンド:

ls ${FILE_ACCESS_KEY}

結果(例):

${HOME}/environment/conf-handson-cli-ssm-session-manager/handson-cli-ssm-session-manager-user-token-0.json

手順の完了