
AWS の config と credentials、そして IAM ロールの設定まで整理してみる
AWS を触り始めると必ず出てくるのが ~/.aws/credentials と ~/.aws/config。
最初は「鍵と設定ファイル」くらいの理解で十分ですが、運用が進むと IAM ロールを引き受ける (AssumeRole) 設定や source_profile の存在も登場してきたり、何のための設定なんだと思うことはないでしょうか?
そこで今回は、、credentials と config、そして IAM ロールの仕組みを整理してみます。
基本の2つのファイル
(1) credentials = 鍵をしまってある場所
保存先: ~/.aws/credentials
[default]
aws_access_key_id = AKIAxxxxxxxxxxxx
aws_secret_access_key = xxxxxxxxxxxxxxxxx
ここには AWS に入るための鍵そのもの が置いてあります。
玄関の鍵を持っていないと家に入れないのと同じで、これがないとアクセスはできません。
(2) config = 使い方のルールブック
保存先: ~/.aws/config
[default]
region = ap-northeast-1
output = json
[profile dev]
region = us-east-1
output = text
どのリージョンを使うか、出力形式をどうするかといった「行動ルール」が記されています。
入るための鍵が credentials、入ったあとどう振る舞うかを決めるのが config。
2つが組み合わさって動く
AWS CLI や SDK はこの順序で動きます。
credentials → どの鍵を使って入るか
config → 入ったあと、どの地域・どんな設定で使うか
つまり、
credentials = 誰が家に入るか
config = 入った人がどの部屋を使い、どう振る舞うか
そんな役割分担です。
IAM ロールを引き受ける (AssumeRole)
もう一歩進んだ使い方として「IAM ロールを借りる」仕組みがあります。
例えるなら、
自分の社員証 (credentials) を持って受付に行く
「この部屋を使わせてください」と申請する (role_arn)
受付からその部屋専用の入館証を一時的に受け取る (AssumeRole で得られる一時クレデンシャル)
こんな流れです。
role_arn = 借りたい部屋の指定
role_arn = arn:aws:iam::123456789012:role/UserRole_For_DevTeam
「このロールを借ります」と指定するもの。
role_session_name = 借りた入館証に付ける名前
role_session_name = Taro_Suzuki
借りたセッションの識別子です。
CloudTrail などの監査ログに残るので「誰が・何の目的で」使ったかが後からわかります。
source_profile の役割
IAM ロールを使うときによく出てくるのが source_profile。
[profile dev]
region = ap-northeast-1
source_profile = default
role_arn = arn:aws:iam::123456789012:role/UserRole_For_DevTeam
role_session_name = Taro_Suzuki
ここでポイントは source_profile = default。
これがあると、credentials の [default] に書いた鍵でまず認証し、そのあと指定したロール (role_arn) を引き受けます。
つまり credentials に dev や stg をそれぞれ書かなくても、default の鍵だけで dev / stg / prod など複数環境に切り替えてアクセスできる ようになります。
参考例では credentials に [dev] を書きましたが、実際は [default] ひとつで十分です。
実際の挙動
aws s3 ls --profile dev を実行
CLI はまず credentials[default] の鍵で認証 (source_profile = default のおかげ)
その鍵で STS AssumeRole API を呼び出し、role_arn のロールを引き受ける
一時的なクレデンシャルを取得し、role_session_name がログに記録される
まとめ
credentials = AWS に入るための鍵
config = 鍵を使ってどう動くかのルール
role_arn = 借りるロールの指定
role_session_name = 借りたセッションにつける名前(監査用)
source_profile = 最初にどの鍵を使ってロールを引き受けるかを指定するもの
source_profile があれば、credentials に環境ごとのプロファイルをたくさん書かなくても、default の鍵だけで複数の環境 (dev / stg / prod) を切り替えて使える。