注目イベント！
アドベントカレンダー2024開催中！
一年を締めくくる特別なイベント、アドベントカレンダーを今年も開催しています！
初心者からベテランまで楽しめる内容で、毎日新しい技術トピックをお届けします。
詳細はこちらから！
event banner

AWS小ネタ - 裏技！？AWS CloudShellで操作ユーザーの資格情報を簡単にゲット！

Switch to English
| 7 min read
Author: yuji-kurabayashi yuji-kurabayashiの画像
#AWS #CloudShell #docker #CloudFormation

はじめに

#

AWS CloudShellは、インフラ作業用の踏み台サーバーとして活用できる機能を取り揃えており、お手軽で便利です。さらに便利な裏技として操作ユーザーの資格情報を簡単に取得できますのでご紹介します。

CloudShellの裏技

#

すごく簡単です。CloudShellで以下の通りにコマンドを実行するだけです。

curl -s -H "Authorization: $AWS_CONTAINER_AUTHORIZATION_TOKEN" "$AWS_CONTAINER_CREDENTIALS_FULL_URI"

すると、以下のようなレスポンスが得られます。

{
        "Type": "",
        "AccessKeyId": "ASIA...",
        "SecretAccessKey": "K8ZX...",
        "Token": "IQoJ...",
        "Expiration": "2024-10-10T08:44:18Z",
        "Code": "Success"
}

AccessKeyId, SecretAccessKey, Tokenが資格情報になります。資格情報の有効期限Expirationは発行してからおよそ5分以上～15分未満程度と短いので、資格情報を実際に使う直前のタイミングで発行するとよいです。ちなみに各資格情報の値はExpirationの値が変化するたびに変化するようです。やりたいことに対して操作ユーザーの権限が足りていれば、この資格情報を使えば実施可能となります。

しかし、もし操作ユーザーが強力な権限を持っていると過剰な権限になってしまいます。資格情報は必要最低限の権限に絞って発行すべきだ、もしくは資格情報の有効期限が短すぎる、という場合はaws sts assume-roleを使って資格情報を用意します。ただし、利用するには予めポリシーやロールを用意する手間がかかります。一方この裏技はこれらの手間を全く必要とせず、お手軽に利用できます。

CloudShellの環境変数には一体何が入っているのか

CloudShellでprintenv | grep AWSコマンドを打つと以下のようなものが表示されます。

AWS_CONTAINER_AUTHORIZATION_TOKEN="0tTw..."
AWS_CONTAINER_CREDENTIALS_FULL_URI="http://localhost:1338/latest/meta-data/container/security-credentials"
AWS_DEFAULT_REGION="ap-northeast-1"
・・・
  • AWS_CONTAINER_AUTHORIZATION_TOKENの設定値はCloudShell環境が立ち上がるたびに変化するようです。
  • AWS_CONTAINER_CREDENTIALS_FULL_URIの設定値は固定のようです。エンドポイントはローカルなんですね。
  • AWS_DEFAULT_REGIONの設定値はCloudShellを立ち上げているリージョンになっています。

CloudShell裏技活用例

#

例えば、AWS CLIを使っているツールをdockerコンテナ化して、これをCloudShellにてコンテナ実行して利用する場合です。私が以前執筆した「CodeBuild + ECR + AWS BatchでAWS Lambda Pythonレイヤー作成」という記事の「コンテナ実行環境にAWS Batchを採用した背景」-「試行その２ - CloudShell」にてCloudShellでdockerコンテナを実行して試していた旨の記述がありますが、実はこの試行の中でCloudShellの裏技を利用していました。
　このようなツールを作る際に試行錯誤していると、処理内容を変更すると必要な権限も変わりますし、権限の問題でエラーになってしまうと起きている問題の原因の切り分けが難しくなってスムーズに検証が進まないのは非効率です。そこでこの裏技を使うと、そもそも使うこと自体が非常に簡単で、操作ユーザー（自分）の権限をごく短時間だけ利用できるのはとても便利でした。

例えば、CloudShellにて以下を実行すると、（この例だとCloudShellで直接aws s3 lsを実行すればよいのではないかというツッコミは一旦無しで）

docker run --rm amazon/aws-cli s3 ls

dockerコンテナ内のAWS CLIが資格情報を利用できないため、以下のようなエラーになってしまいます。

Unable to locate credentials. You can configure credentials by running "aws configure".

dockerコンテナ内のAWS CLIが資格情報を利用できるようにするには、コンテナにAWS CLIが認識する特定の環境変数名で資格情報を設定する必要があります。

そこで、以下のようなシェル「publish_temporary_credentials.sh」を用意しました。

aws sts assume-roleを利用したい場合はシェルの第一引数にロールのARNをセットします。
そして、aws sts assume-roleを利用したい場合は、予めポリシーやロールを用意しておく必要があるので、これらを簡単に作成できるCloudFormationテンプレート「cfn_assume_role.yaml」を用意しました。このテンプレートを利用すると、許可したいアクションを指定してポリシーを用意して、さらに既存のポリシーと組み合わせて資格情報を発行するためのロールを作成できます。

publish_temporary_credentials.sh 
#bin/sh

TEMPORARY_CREDENTIALS=
TEMPORARY_ACCESS_KEY_ID=
TEMPORARY_SECRET_ACCESS_KEY=
TEMPORARY_SESSION_TOKEN=

if [ -n "$1" ]; then
  # specified first arg (regard as use 'sts assume-role arn')
  TEMPORARY_CREDENTIALS=$(aws sts assume-role --role-arn "$1" --role-session-name `date +%Y%m%d%H%M%S`-session)
  TEMPORARY_ACCESS_KEY_ID=$(echo -n "$TEMPORARY_CREDENTIALS" | jq -r .Credentials.AccessKeyId)
  TEMPORARY_SECRET_ACCESS_KEY=$(echo -n "$TEMPORARY_CREDENTIALS" | jq -r .Credentials.SecretAccessKey)
  TEMPORARY_SESSION_TOKEN=$(echo -n "$TEMPORARY_CREDENTIALS" | jq -r .Credentials.SessionToken)
elif [ -n "$AWS_CONTAINER_AUTHORIZATION_TOKEN" ] && [ -n "$AWS_CONTAINER_CREDENTIALS_FULL_URI" ]; then
  # executing on AWS CloudShell
  TEMPORARY_CREDENTIALS=$(curl -s -H "Authorization: $AWS_CONTAINER_AUTHORIZATION_TOKEN" "$AWS_CONTAINER_CREDENTIALS_FULL_URI")
  TEMPORARY_ACCESS_KEY_ID=$(echo -n "$TEMPORARY_CREDENTIALS" | jq -r .AccessKeyId)
  TEMPORARY_SECRET_ACCESS_KEY=$(echo -n "$TEMPORARY_CREDENTIALS" | jq -r .SecretAccessKey)
  TEMPORARY_SESSION_TOKEN=$(echo -n "$TEMPORARY_CREDENTIALS" | jq -r .Token)
fi

echo "$TEMPORARY_CREDENTIALS"
echo ""
echo export AWS_ACCESS_KEY_ID="$TEMPORARY_ACCESS_KEY_ID"
echo export AWS_SECRET_ACCESS_KEY="$TEMPORARY_SECRET_ACCESS_KEY"
echo export AWS_SESSION_TOKEN="$TEMPORARY_SESSION_TOKEN"
echo export AWS_DEFAULT_REGION="$AWS_DEFAULT_REGION"

export TEMPORARY_AWS_ACCESS_KEY_ID="$TEMPORARY_ACCESS_KEY_ID"
export TEMPORARY_AWS_SECRET_ACCESS_KEY="$TEMPORARY_SECRET_ACCESS_KEY"
export TEMPORARY_AWS_SESSION_TOKEN="$TEMPORARY_SESSION_TOKEN"
  • exportコマンド風に出力しているのは、発行した資格情報をCloudShell以外の環境で利用したい場合にコピーペーストして利用できるようにするためです。
  • AWS CLIでの実行コマンドによっては、資格情報の他にリージョンの設定が必要になる場合もあるので併せて出力してセットしています。
    • 実際にdockerコンテナ内でaws s3 cpコマンドを実行したらリージョンが指定されていないというエラーが出てしまいました。
  • 発行した資格情報を以下の環境変数名で設定します。直接「AWS_ACCESS_KEY_ID」などに設定していない理由は、CloudShellで直接利用するAWS CLIに影響が出てしまうのを避けるためです。
    • TEMPORARY_AWS_ACCESS_KEY_ID
    • TEMPORARY_AWS_SECRET_ACCESS_KEY
    • TEMPORARY_AWS_SESSION_TOKEN

以下のようにシェルを実行した後でdocker runコマンドの環境変数で資格情報等を渡して実行すると成功します。
シェルを実行する際のポイントとして、シェルの処理内で設定している環境変数を実際に環境に反映するには、sourceを付与してsource ./publish_temporary_credentials.shのように実行する必要があります。

chmod +x ./publish_temporary_credentials.sh
source ./publish_temporary_credentials.sh
# for use 'sts assume-role arn'
# source ./publish_temporary_credentials.sh arn:aws:iam::123456789012:role/assume-role-name

docker run --rm \
  -e AWS_ACCESS_KEY_ID="$TEMPORARY_AWS_ACCESS_KEY_ID" \
  -e AWS_SECRET_ACCESS_KEY="$TEMPORARY_AWS_SECRET_ACCESS_KEY" \
  -e AWS_SESSION_TOKEN="$TEMPORARY_AWS_SESSION_TOKEN" \
  -e AWS_DEFAULT_REGION="$AWS_DEFAULT_REGION" \
  amazon/aws-cli s3 ls

便利なワンライナー

#

参考までに、資格情報をexportコマンド風に出力するワンライナーです。

CloudShell裏技版

#

CloudShellにこのままコピー＆ペーストして利用します。

curl -s -H "Authorization: $AWS_CONTAINER_AUTHORIZATION_TOKEN" "$AWS_CONTAINER_CREDENTIALS_FULL_URI" \
  | jq -r "[ \"export AWS_ACCESS_KEY_ID=\" + .AccessKeyId, \"export AWS_SECRET_ACCESS_KEY=\" + .SecretAccessKey, \"export AWS_SESSION_TOKEN=\" + .Token ] | .[]" && \
echo export AWS_DEFAULT_REGION="$AWS_DEFAULT_REGION"

aws sts assume-role版

#

"your_sts_assume_role_ARN"の部分を適宜書き換えたものを利用します。
また、前述のCloudFormationテンプレート cfn_assume_role.yaml で作成したスタックの出力にも以下のコマンドが出力されているので、そのままコピー＆ペーストして利用します。

aws sts assume-role --role-arn "your_sts_assume_role_ARN" --role-session-name `date +%Y%m%d%H%M%S`-session \
  | jq -r "[ \"export AWS_ACCESS_KEY_ID=\" + .Credentials.AccessKeyId, \"export AWS_SECRET_ACCESS_KEY=\" + .Credentials.SecretAccessKey, \"export AWS_SESSION_TOKEN=\" + .Credentials.SessionToken ] | .[]" && \
echo export AWS_DEFAULT_REGION="$AWS_DEFAULT_REGION"

さいごに

#

CloudShellの裏技はお手軽ですが、例えば操作ユーザーがAdministratorAccessのロールを持っている場合は非常に強力な権限を持つ資格情報となるので取り扱いには注意して、aws sts assume-roleを使って適切に権限を制限することも検討します。

豆蔵では共に高め合う仲間を募集しています！

recruit

具体的な採用情報はこちらからご覧いただけます。