メインコンテンツへスキップ
見出し画像

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 はこの順序で動きます。

    1. credentials → どの鍵を使って入るか

    2. 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] ひとつで十分です。


    実際の挙動

    1. aws s3 ls --profile dev を実行

    2. CLI はまず credentials[default] の鍵で認証 (source_profile = default のおかげ)

    3. その鍵で STS AssumeRole API を呼び出し、role_arn のロールを引き受ける

    4. 一時的なクレデンシャルを取得し、role_session_name がログに記録される


    まとめ

    • credentials = AWS に入るための鍵

    • config = 鍵を使ってどう動くかのルール

    • role_arn = 借りるロールの指定

    • role_session_name = 借りたセッションにつける名前(監査用)

    • source_profile = 最初にどの鍵を使ってロールを引き受けるかを指定するもの

     source_profile があれば、credentials に環境ごとのプロファイルをたくさん書かなくても、default の鍵だけで複数の環境 (dev / stg / prod) を切り替えて使える。

     
     

    toshi

     
     
    Kubernetesが好きなインフラエンジニア / 株式会社クラフトマンソフトウェア / 文系出身から営業→企画→フロントエンド→バックエンド→インフラエンジニアへとキャリアチェンジしてきました。いつか自前でクラウドみたいなものをつくれるように日々奮闘中です!

    あなたへのおすすめ