AWS CLI でコマンドを打つと結果は返ってきますが、いまどのアカウントに向かって打ったのかは画面に出ません。
どの認証情報を使うかは、手元のファイル、環境変数、コマンドの引数など何か所からでも指定できて、CLI はそれを決まった順番で探しています。
この順番を知らないまま使うと、仕事用と個人用のアカウントを取り違えたり、残っていた環境変数に引っ張られたりしかねません。
2 つの設定ファイルの役割と、プロファイルが選ばれる順番が分かると、--profile を毎回付ける運用がなぜ効くのかまで説明がつきます。
AWS は私が個人開発で使っている範囲を例にし、GCP と Azure は各社の公式ドキュメントをもとに比べます。
AWS CLIの認証情報とは
AWS CLI は、AWS のサービスの API をコマンドラインから呼ぶためのツールです。
API を呼ぶとき、CLI は手元の認証情報を使ってリクエストに署名します。
認証情報と、リージョンや出力形式といった設定をひとまとめにして名前を付けたものを、プロファイルと呼びます。
configとcredentialsの役割
プロファイルの中身は、ホームディレクトリの .aws フォルダにある 2 つのファイルに分けて保存されます。
| ファイル | 既定の場所 | 入れるもの | プロファイルの見出し |
|---|---|---|---|
| config | ~/.aws/config(Windows は %UserProfile%\.aws\config) | リージョン、出力形式、IAM Identity Center やロールの設定など | [default]、 |
| credentials | ~/.aws/credentials(Windows は %UserProfile%\.aws\credentials) | アクセスキーなどの秘密の値 | [default]、[名前](profile を付けない) |
見出しの書き方が 2 つのファイルで違い、config では名前の前に profile を付け、credentials では付けません。
どちらのファイルにも認証情報は書けますが、同じ名前のプロファイルに両方で書いた場合は credentials の値が使われます。
AWS は、認証情報を credentials のほうに置くよう勧めています。
置き場所そのものは、環境変数 AWS_CONFIG_FILE と AWS_SHARED_CREDENTIALS_FILE で別のパスに変えられます。
Configuration and credential file settings in the AWS CLI(AWS CLI ユーザーガイド)
プロファイルの選び方
プロファイルを何も指定しないと、CLI は default という名前のプロファイルを使います。
ほかのプロファイルを使うには、コマンドに --profile 名前 を付けるか、環境変数 AWS_PROFILE に名前を入れます。
両方あるときは、コマンドに付けた --profile が AWS_PROFILE より優先されます。
# 1 回のコマンドだけ personal を使う
aws sts get-caller-identity --profile personal
# この PowerShell のセッションの間だけ personal を既定にする
$Env:AWS_PROFILE = "personal"
PowerShell で $Env: に入れた値は、そのセッションを閉じるまでしか残りません。
Configuring environment variables for the AWS CLI(AWS CLI ユーザーガイド)
認証情報が選ばれる順番
CLI は、認証情報や設定をいくつかの場所から決まった順番で探します。
公式のユーザーガイドが挙げる順番は、次の 10 段階です。
- コマンドラインのオプション(
--profile、--regionなど) - 環境変数
- ロールの引き受け(assume role)
- ウェブ ID によるロールの引き受け
- IAM Identity Center
- credentials ファイル
- 外部のプロセス(custom process)
- config ファイル
- コンテナの認証情報(ECS のタスクロール)
- EC2 のインスタンスプロファイル
Authentication and access credentials for the AWS CLI(AWS CLI ユーザーガイド)
上にあるものほど優先され、たとえば --region を付ければ、環境変数やプロファイルに書いたリージョンより先に効きます。
ただし、コマンドラインのオプションで認証情報そのものは渡せず、渡せるのはどのプロファイルを使うかまでです。
コマンドの引数、環境変数、設定ファイル、コンテナやインスタンスのロールの順に強いと覚えておくと、どの値が使われたかを追いやすくなります。
どこで使われるか
プロファイルと優先順位が効いてくるのは、1 台の PC から複数のアカウントを使うときと、CI や AWS の中でコマンドを動かすときです。
手元で複数のアカウントを使い分ける
仕事用と個人用、開発用と本番用のように、アカウントごとにプロファイルを分けておくと、コマンドごとに行き先を選べます。
IAM Identity Center の場合は、アカウント ID とロール名の組み合わせごとにプロファイルを書く形が、公式ドキュメントの例になっています。
反対に、プロファイルを指定し忘れたコマンドは default に向かうので、default に何を置くかで、付け忘れたときの影響が決まります。
CIやAWSの中で動かすとき
CI や EC2 の上では、プロファイルのファイルを用意しなくても CLI が認証情報を見つけられる仕組みがあります。
GitHub Actions で AWS の認証に使う aws-actions/configure-aws-credentials は、既定では受け取った認証情報を環境変数に書き出します。
aws-actions/configure-aws-credentials(GitHub)
そのため後続のステップの aws コマンドは、優先順位の 2 番目にある環境変数から認証情報を拾います。
EC2 のインスタンスや ECS のタスクにロールを付けておけば、プロファイルも環境変数も無いときに、CLI はそのロールの一時的な認証情報を使います。
Using an IAM role in the AWS CLI(AWS CLI ユーザーガイド)
私のプロジェクトでの扱い
私は、検索特化サイトの dekinai.dev と個人開発の別のアプリを、個人の AWS アカウントで動かしています。
手元で aws コマンドを打つときのプロファイル名は personal に統一し、どのコマンドにも --profile personal を付ける決まりにしています。
default に別の環境がひも付いていても、意図しない削除やデプロイのぶつかり合いを起こさないようにするためです。
personal の region を aws configure get region --profile personal で読むと、ap-northeast-1(東京)が返ります。
デプロイは GitHub Actions から行い、どのリポジトリのワークフローも、OIDC で 1 つの共有ロールを引き受けています。
共有ロールの信頼ポリシーは、条件で自分の GitHub アカウントのリポジトリからの引き受けだけを許しています。
実際に使っているワークフローからの抜粋です。
permissions:
id-token: write
contents: read
# 略
- name: Configure AWS Credentials
uses: aws-actions/configure-aws-credentials@v6
with:
role-to-assume: ${{ secrets.AWS_ROLE_ARN }}
aws-region: ${{ env.AWS_REGION }}
id-token: write は、ワークフローが OIDC のトークンを受け取るために要る権限です。
抜粋のとおり、認証のためにワークフローへ渡しているのは引き受けるロールの ARN だけで、アクセスキーは出てきません。
手元ではプロファイルを毎回名指しし、CI には長期の鍵を持たせない、という 2 つの決まりにしています。
設定がどこから来たかを確かめる
どのプロファイルの、どのファイルの値が使われているかは、aws configure list で確かめられます。
このコマンドは、値と一緒に、その値をどこから読んだかを表示します。
ここからの検証は、2026 年 10 月 17 日に Windows 11 の PowerShell と AWS CLI 2.32.6 で行いました。
本物の設定ファイルは使わず、AWS_CONFIG_FILE と AWS_SHARED_CREDENTIALS_FILE で検証用のダミーのファイルを読ませています。
アクセスキーも実在しないダミーの値で、末尾をファイル側は FIL1、環境変数側は ENV1 にしました。
# demo\config
region = ap-northeast-1
output = json
# demo\credentials(ダミー。値は略)
[personal]
aws_access_key_id = AKIA...FIL1
aws_secret_access_key = ...FIL1
まず、ダミーのファイルだけを読ませた状態で打ちました。
$Env:AWS_CONFIG_FILE = "demo\config"
$Env:AWS_SHARED_CREDENTIALS_FILE = "demo\credentials"
aws configure list --profile personal
NAME : VALUE : TYPE : LOCATION
profile : personal : manual : --profile
access_key : ****************FIL1 : shared-credentials-file :
secret_key : ****************FIL1 : shared-credentials-file :
region : ap-northeast-1 : config-file : demo\config
profile の行は TYPE が manual、LOCATION が –profile で、コマンドの引数でプロファイルを選んだことが読み取れます。
次に、環境変数にもダミーのアクセスキーと AWS_REGION を入れて、同じコマンドを打ちました。
$Env:AWS_ACCESS_KEY_ID = "AKIA...ENV1" # ダミー(値は略)
$Env:AWS_SECRET_ACCESS_KEY = "...ENV1" # ダミー(値は略)
$Env:AWS_REGION = "us-west-2"
aws configure list --profile personal
NAME : VALUE : TYPE : LOCATION
profile : personal : manual : --profile
access_key : ****************FIL1 : shared-credentials-file :
secret_key : ****************FIL1 : shared-credentials-file :
region : us-west-2 : env : ['AWS_REGION', 'AWS_DEFAULT_REGION']
aws configure get region --profile personal
ap-northeast-1
アクセスキーは FIL1 のままで、--profile を付けたコマンドは環境変数のアクセスキーを使いませんでした。
AWS CLI のソースコードも、プロファイルを明示したときは環境変数の認証情報を探さない作りになっています。
credentials.py(aws/aws-cli 2.32.6)
一方でリージョンは環境変数の us-west-2 に変わり、LOCATION にも AWS_REGION が出ています。
同じ状態でも aws configure get region は ap-northeast-1 を返していて、環境変数で上書きされた後の値ではありませんでした。
最後に、プロファイルの指定まわりでコマンドが止まる場面を 2 つ確かめました。
# personal が書かれていないファイルを読ませた場合(終了コード 255)
aws configure list --profile personal
The config profile (personal) could not be found
# 以降の表示は略
# personal はあるが、認証情報が無い場合(終了コード 253)
aws sts get-caller-identity --profile personal
Unable to locate credentials. You can configure credentials by running "aws login".
名前を指定したプロファイルが見つからないとき、CLI は default に切り替えて続けることはせず、エラーで止まりました。
認証情報がどこにも無いときも、このメッセージでコマンドが止まります。
いまどのアカウントの誰として動いているかは、aws sts get-caller-identity --profile personal で確かめられ、UserId、Account、Arn の 3 つが返ってきます。
先に知っておく用語
認証情報まわりのドキュメントには、似た言葉がいくつも出てきます。
長期の認証情報と一時的な認証情報
CLI で使う長期の認証情報は、IAM ユーザーやルートユーザーのアクセスキーのことで、有効期限がありません。
アクセスキーはアクセスキー ID とシークレットアクセスキーの 2 つで 1 組になっていて、シークレットのほうは作ったときにしか取り出せません。
1 人の IAM ユーザーが持てるアクセスキーは 2 つまでです。
Manage access keys for IAM users(IAM ユーザーガイド)
一時的な認証情報は、ロールの引き受けや IAM Identity Center へのサインインで発行され、期限が来ると使えなくなります。
credentials ファイルに書く場合、一時的な認証情報にはアクセスキーとシークレットに加えて aws_session_token が付きます。
IAM Identity Centerのプロファイル
IAM Identity Center で使うプロファイルは config ファイルにだけ書き、credentials ファイルは使いません。
aws configure sso を実行すると、サインイン先の URL などが [sso-session 名前] の節に、アカウント ID とロール名がプロファイルの節に書き込まれます。
使う前に aws sso login --profile 名前 でブラウザからサインインすると、トークンが ~/.aws/sso/cache に保存されます。
サインインが有効な間は、期限が切れた AWS の認証情報を CLI が自動で取り直し、サインインそのものが切れたらログインし直します。
Configuring IAM Identity Center authentication with the AWS CLI(AWS CLI ユーザーガイド)
IAM Identity Center を有効にするときの選び方は、シリーズの前の記事で扱いました。
aws login
AWS CLI 2.32.0 から使えるようになった aws login は、コンソールにサインインするときの ID で CLI にもログインできるコマンドです。
IAM ユーザーや、IAM と連携した外部の ID でサインインでき、CLI が一時的な認証情報を最大 12 時間まで自動で更新します。
IAM ユーザーやロールで使うには、AWS 管理ポリシーの SignInLocalDevelopmentAccess を付けておく必要があります。
IAM Identity Center を使っているなら、こちらではなく前の節の aws sso login を使います。
手元の CLI の認証方法として、公式のユーザーガイドが推奨の筆頭に挙げているのもこの方法です。
先ほどの検証で出たエラーメッセージも、設定の方法として aws login を案内していました。
Login for AWS local development using console credentials(AWS CLI ユーザーガイド)
ロールを引き受けるプロファイル
config ファイルのプロファイルに role_arn と source_profile を書くと、そのプロファイルを指定したときに CLI が裏で AssumeRole を呼びます。
# 書式(値は説明用の仮のもの)
role_arn = arn:aws:iam::123456789012:role/example-role
source_profile = user1
source_profile に書いたプロファイルの認証情報でロールを引き受け、その一時的な認証情報でコマンドを実行する流れです。
取得した一時的な認証情報は ~/.aws/cli/cache に保存され、期限が切れるまで使い回されます。
ロールそのものの仕組みは、IAM の記事で整理しました。
いつ使わないか
認証情報の置き方は、避ける組み合わせを先に知っておくと選びやすくなります。
| 状況 | 使わないもの | 代わりに使うもの | 根拠 |
|---|---|---|---|
| 人が手元の PC から CLI を使う | aws configure で保存した長期のアクセスキー | aws login、IAM Identity Center の aws sso login | ユーザーガイドが長期の認証情報を推奨しないとしているため |
| プロファイルを付け忘れるおそれがある | 強い権限や本番のアカウントの認証情報を置いた default | 名前付きのプロファイルを毎回 --profile で指定する | 指定しないコマンドは default を使うため |
| スクリプトの中でアカウントを切り替える | AWS_PROFILE だけに頼る切り替え | コマンドごとに --profile を付ける | 環境変数にアクセスキーが残っていると、AWS_PROFILE より先に使われるため |
| GitHub Actions からデプロイする | Secrets に置いた長期のアクセスキー | OIDC でロールを引き受ける | CI/CD のような AWS の外のワークロードにも一時的な認証情報が勧められているため |
| EC2 や ECS の上で CLI を動かす | インスタンスに置いたアクセスキー | インスタンスプロファイル、タスクロール | ロールを付ければ長期のキーを置かずに済むため |
AWS CLI のユーザーガイドも、実際のデータを扱う作業では IAM ユーザーで認証せず、IAM Identity Center などとの連携を使うよう警告しています。
Authenticating using IAM user credentials for the AWS CLI(AWS CLI ユーザーガイド)
長期のアクセスキーが要るのは、ロールを使えないワークロードや、IAM Identity Center に対応していないサードパーティのツールなどに限られます。
そうした場面でも、AWS はキーの最終使用の情報を見ながら、必要に応じて更新や削除をするよう勧めています。
Security best practices in IAM(IAM ユーザーガイド)
課金と落とし穴
IAM、IAM Identity Center、STS は追加の料金なしで使え、料金がかかるのは、それらの認証情報でほかのサービスを操作したときです。
プロファイルやリージョンを取り違えて作ったリソースにも、ほかのリソースと同じように料金がかかります。
認証情報をどこに置き、誰に渡さないかを決めて守るのは、利用者の側の受け持ちです。
環境変数のアクセスキーはAWS_PROFILEより強い
AWS_ACCESS_KEY_ID と AWS_SECRET_ACCESS_KEY が環境変数に入っていると、AWS_PROFILE でプロファイルを選んでいても、環境変数のアクセスキーのほうが使われます。
先ほどの credentials.py にも、この 3 つを環境変数で同時に渡したときは、明示した認証情報が優先されるとコメントで書かれています。
コマンドに --profile を付けた場合は、検証のとおり、環境変数のアクセスキーは使われませんでした。
AWS_PROFILE を変えても行き先が変わらないときは、まず環境変数にアクセスキーが残っていないかを確かめます。
configure getで見えるのはファイルの値
リージョンも上書きの順番が決まっていて、AWS_REGION が AWS_DEFAULT_REGION とプロファイルの region を上書きし、--region がさらにそれを上書きします。
検証で見たとおり、aws configure get はこの上書きを反映しないので、実際の行き先は aws configure list で見ます。
認証情報ファイルは平文で置かれる
credentials ファイルに保存したアクセスキーは、平文のまま置かれます。
AWS は、アクセスキーをアプリケーションのファイルに書かないことと、アクセスキーを含むファイルをプロジェクトのフォルダに置かないことを挙げています。
漏れたときに先に無効化する手順や、Git の履歴に残る問題は、シークレット管理の記事にまとめています。
キャッシュに残る一時的な認証情報
一時的な認証情報も、手元のフォルダにキャッシュとして残ります。
| 方法 | キャッシュの場所 | 消し方 |
|---|---|---|
| IAM Identity Center | ~/.aws/sso/cache | aws sso logout |
| aws login | ~/.aws/login/cache | aws logout |
| ロールの引き受け | ~/.aws/cli/cache | フォルダを消す |
期限が切れるのを待たずに消したいときは、表の方法でログアウトするか、キャッシュのフォルダを消します。
他クラウドでは
GCP と Azure の CLI にも行き先を切り替える仕組みがあり、AWS との違いは、切り替えた状態がどこまで続くかです。
GCP の gcloud CLI では、プロジェクトやアカウントなどのプロパティに名前を付けてまとめたものを構成(configuration)と呼び、複数作れます。
有効にできる構成は一度に 1 つで、gcloud config configurations activate で切り替えると、次に切り替えるまでのコマンドすべてに効きます。
1 回のコマンドだけ変えるなら --configuration フラグを、ターミナルの中だけ変えるなら環境変数 CLOUDSDK_ACTIVE_CONFIG_NAME を使います。
Managing gcloud CLI configurations(Google Cloud)
Azure CLI では、az login でサインインした後のコマンドが、アクティブなサブスクリプションに対して実行されます。
アクティブなサブスクリプションは az account set --subscription で切り替え、1 回のコマンドだけなら --subscription パラメーターで指定します。
How to manage Azure subscriptions with the Azure CLI(Microsoft Learn)
AWS CLI は指定が無ければ default を使い、GCP と Azure は最後に切り替えた構成やサブスクリプションを使い続けます。
区分 AWS GCP Azure 切り替えの単位 プロファイル 構成(configuration) サブスクリプション 何も指定しないとき default プロファイル アクティブな構成 アクティブなサブスクリプション 1 回のコマンドだけ変える --profile--configuration--subscription続けて切り替える 環境変数 AWS_PROFILEgcloud config configurations activateaz account set設定の置き場所 ~/.aws~/.config/gcloud(Windows は %APPDATA%\gcloud)~/.azure(Windows は %USERPROFILE%\.azure)
3 社の部品の対応表の全体版は、シリーズ最初の記事にまとめてあります。
参考
本文のリンクで紹介した公式ドキュメントとソースコードは、いずれも 2026-10-17 に参照しました。
AWS CLI の認証の方法は aws login のように新しく足されることがあるので、設定する前にはリンク先の最新の記述を確かめてください。
最後に
AWS CLI は、コマンドの引数、環境変数、設定ファイル、コンテナやインスタンスのロールという大まかな順番で認証情報を探し、先に見つかったものを使います。
プロファイルを指定しないコマンドは default に向かい、AWS_PROFILE は環境変数のアクセスキーに負けますが、コマンドに付けた --profile は負けません。
人の作業は aws login や IAM Identity Center の一時的な認証情報に寄せ、CI は OIDC で鍵を持たずにロールを引き受けるのが、AWS の勧める形です。
資格試験では、AWS Certified Cloud Practitioner(CLF-C02)のタスク 2.3 がアクセスキーと認証情報の保管を、タスク 3.1 が CLI を含むプログラムからのアクセスを挙げています。
AWS Certified Cloud Practitioner(CLF-C02)Content Domain 2
AWS Certified Cloud Practitioner(CLF-C02)Content Domain 3
Solutions Architect – Associate(SAA-C03)では、タスク 1.1 の STS とロールの切り替え、タスク 1.2 のアプリケーションの設定と認証情報の保護が近い範囲です。
AWS Certified Solutions Architect – Associate(SAA-C03)Content Domain 1
AZ-900 では管理とガバナンスの分野にある Azure CLI の項目が、GCP の Associate Cloud Engineer ではセクション 5.2 の短期のサービスアカウントの認証情報が近い範囲になります。
Study guide for Exam AZ-900(Microsoft Learn)
Associate Cloud Engineer 試験ガイド(Google Cloud)
どのコマンドにも –profile を付け、迷ったら aws configure list で行き先を見る、の 2 つを習慣にすれば、どのアカウントに向かって打っているかを毎回自分の目で確かめられます。
以上です。
















コメントを残す