この記事でわかること
- aws-vault とは何か、なぜアクセスキーを安全に扱えるのか
-
aws login・aws sso loginとの違い - aws-vault のインストールから実際の使い方まで
- aws-vault の「サブシェル」の仕組みと、ターミナルごとに権限を切り分けられる利点
- Claude Code などの AI エージェントと組み合わせるときの注意点
目次
- 環境
- そもそも何が問題なのか
- aws-vault とは
- aws login・aws sso login との比較
- 使い方
- インストール
- プロファイルを追加する
- MFA を設定する(任意)
- 登録済みのプロファイルを確認する
- サブシェルを起動して作業する
- サブシェルの仕組み
- ターミナルごとに認証を分けられる
- 応用:Claude Code に AWS 環境を調べてもらう
- ハマりどころ・Tips
- いまサブシェルの中にいるか分からなくなる
- サブシェルの中で別のプロファイルに切り替えられない
- まとめ
- 参考
環境
| 項目 | バージョン |
|---|---|
| OS | macOS 26.3 |
| aws-vault | v7.15.3 |
| AWS CLI | 2.37.9 |
そもそも何が問題なのか
AWS CLI の初期設定で aws configure を実行すると、アクセスキーは ~/.aws/credentials に 平文で 保存されます。
[default]
aws_access_key_id = AKIAXXXXXXXXXXXXXXXX
aws_secret_access_key = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
このキーには有効期限がありません。ファイルを誤って Git に push したり、PC 内のファイルを読めるツールに渡ったりすると、無効化するまでずっと使えてしまいます。
これを避ける方法として、AWS CLI でアクセスする手段は主に次の 3 つがあります。
| 方法 | 位置づけ |
|---|---|
IAM Identity Center(aws sso login) |
組織での利用の第一候補 |
| aws login | SSO のない小規模・個人の環境向け |
| aws-vault | アクセスキーを使い続ける環境向け |
この記事では、3 つ目の aws-vault を紹介します。
aws-vault とは
一言でいうと、「鍵は金庫に、渡すのは“合鍵”だけ」 にしてくれる CLI ツールです。
- 期限のないアクセスキー(長期キー)は、OS のキーチェーンという「金庫」に暗号化してしまっておく
- コマンドを実行するとき、aws-vault が金庫からキーを取り出し、AWS STS に一時キーを依頼する
- STS が発行するのは、約 1 時間で使えなくなる「合鍵」
-
awsに渡されるのは、この合鍵だけ
これで、次の 2 つが実現できます。
- 長期キーを設定ファイルに平文で書かなくてよい
- 合鍵が万一漏れても、1 時間ほどで使えなくなる
aws login・aws sso login との比較
| 観点 | aws-vault | aws login | aws sso login |
|---|---|---|---|
| 長期キー | 必要(暗号化して保管) | 不要 | 不要 |
| ログイン方法 | IAM ユーザーのアクセスキー | マネコンと同じ認証をブラウザで | 会社の ID でブラウザからログイン |
| MFA |
mfa_serial を config に設定 |
コンソールの MFA をそのまま利用 | ID 基盤側で実施 |
| 一時キー | STS で発行し環境変数で渡す | 15 分ごとに自動更新、最長 12 時間 | キャッシュから CLI が自動利用 |
| 人の管理 | IAM ユーザーとキーを個別に管理 | IAM ユーザーを個別に管理 | ID 基盤で一括管理 |
| 必要なもの | aws-vault のインストール | CLI 2.32.0 以上 + 専用ポリシー | 組織での Identity Center 設定 |
| 向いている場面 | アクセスキーを使い続ける環境 | SSO のない小規模・個人の環境 | 組織での利用(第一候補) |
使う側(ユーザー)から見て大きく違うのは、太字にした上の 2 行です。
- 長期キーを発行する必要があるか
- ログインのときにブラウザに飛ばされるか
aws-vault は長期キーが必要な代わりに、ブラウザを経由せずターミナルだけで完結します。
使い方
1. インストール
Homebrew でインストールできます。
$ brew install aws-vault
$ aws-vault --version
v7.15.3
元の開発元(99designs)のリポジトリは更新が止まっており、現在 Homebrew の aws-vault はコミュニティによるフォーク版(ByteNess/aws-vault)を指しています。
2. プロファイルを追加する
aws-vault add <プロファイル名> を実行すると、アクセスキーとシークレットアクセスキーを聞かれるので、それぞれ入力します。
$ aws-vault add kenken
Enter Access Key ID: AKIAXXXXXXXXXXXXXXXX
Enter Secret Access Key: ****************************************
Enter MFA Device ARN (If MFA is not enabled, leave this blank):
Added credentials to profile "kenken" in vault
キーは macOS のキーチェーンに暗号化して保存され、~/.aws/credentials には書かれません。
すでに ~/.aws/credentials に同じキーを書いている場合は、aws-vault に登録したあとで ファイルから削除 しましょう。残しておくと、平文のキーがそのまま残ってしまいます。
3. MFA を設定する(任意)
MFA を使う場合は、~/.aws/config のプロファイルに mfa_serial を追加します。
[profile kenken]
region = ap-northeast-1
mfa_serial = arn:aws:iam::123456789012:mfa/kenken
これで、一時キーを発行するときにワンタイムコードを聞かれるようになります。
4. 登録済みのプロファイルを確認する
$ aws-vault ls
Profile Credentials Sessions
======= =========== ========
readonly-user readonly-user sts.GetSessionToken:-179h30m14s
default - -
kenken kenken -
登録済みのプロファイルと、いま有効なセッションを一覧できます。複数の IAM ユーザーを使い分けるときに便利です。
5. サブシェルを起動して作業する
aws-vault exec <プロファイル名> でサブシェルが立ち上がります。あとはその中で、普段どおりコマンドを実行するだけです。
$ aws-vault exec kenken
Starting subshell /bin/zsh, use `exit` to exit the subshell
$ aws sts get-caller-identity
$ exit
1 コマンドだけ実行したいときは、-- のあとにコマンドを続けます。
$ aws-vault exec kenken -- aws sts get-caller-identity
サブシェルの仕組み
aws-vault を使ううえで押さえておきたいのが、サブシェル という考え方です。
aws-vault exec は、一時的な認証情報を環境変数に入れた 「子どものシェル」 を起動します。
親シェル(いつもの zsh/認証情報なし)
│
│ $ aws-vault exec my-profile
│ └ キーチェーンの鍵 → STS で一時認証情報を発行
│
└─ 子シェル(サブシェル)
AWS_ACCESS_KEY_ID=ASIA...
AWS_SECRET_ACCESS_KEY=...
AWS_SESSION_TOKEN=...
AWS_VAULT=my-profile
→ aws CLI も terraform も Claude Code もこの認証情報で動く
$ exit
→ 親シェルに戻る(認証情報は消える)
AWS の CLI や SDK は、環境変数 AWS_ACCESS_KEY_ID などがあればそれを優先して使います。そのため、サブシェルの中で起動したツールは設定なしで AWS にアクセスできます。
この方式には、次の利点があります。
| 利点 | 内容 |
|---|---|
| ファイルに残らない | 一時キーは環境変数で渡すだけで、ファイルには書かない |
| 効く範囲が限られる | 効くのはそのシェルの中だけ。親シェルや別のターミナルには影響しない |
| 片付けが不要 |
exit した時点で環境変数ごと消える。消し忘れがない |
| どのツールでも動く |
aws CLI も terraform も Claude Code も設定不要 |
ターミナルごとに認証を分けられる
サブシェル方式のもう一つの大きな利点が、ターミナルごとに「どのプロファイルで認証するか」「そもそも認証するか」を分けられる ことです。
aws login で認証すると、認証情報はプロファイルごとに ~/.aws/login/cache 配下のファイルへ保存され、~/.aws/config のプロファイルには login_session が書き込まれます。AWS CLI や SDK はコマンドを実行するたびにこの設定とキャッシュを読みにいき、認証情報を 15 分ごとに自動更新しながら最長 12 時間使い続けます。
そのため、認証したターミナルだけでなく、同じプロファイルを使う別のターミナルにも認証情報が渡ります。aws sso login(~/.aws/sso/cache)も同じ仕組みです。
たとえば、次のような状況を考えてみます。
ターミナル A:自分の作業用
$ aws login ← default プロファイルで認証
→ 認証情報が ~/.aws/login/cache に保存される
ターミナル B:裏で AI エージェントに別の作業を任せている
$ aws s3 ls ← エージェントが実行(プロファイル指定なし=default)
→ 同じプロファイルを使うので、キャッシュの認証情報が自動で使われる
(A で認証する前から起動していたエージェントでも同じ)
ターミナル A で認証しただけのつもりが、別のターミナルで動かしている AI エージェントに、うっかり AWS の操作権限を渡してしまうことになりかねません。
aws-vault なら、認証情報が入るのは aws-vault exec で起動したサブシェルの中だけです。
ターミナル A:自分の作業用
$ aws-vault exec kenken ← このシェルの中だけ認証される
ターミナル B:裏で AI エージェントに別の作業を任せている
→ 認証情報は渡っていないので、AWS は操作できない
ターミナル C:読み取り専用で調査させたい
$ aws-vault exec readonly-user
$ claude ← 読み取り権限だけで動く
「このターミナルには AWS の権限を渡す、こっちには渡さない」「こっちは読み取り専用で」と、ターミナル単位で権限を切り分けられる ので、複数のターミナルで AI エージェントを並行して動かすときにも、安全かつ便利に使えます。
aws-vault でも完全には防げない
aws-vault が防げるのは、「何もしなくても認証情報が勝手に渡ってしまうこと」です。ターミナル B のエージェントが 自分で aws-vault exec kenken -- aws ... を実行すれば、認証情報を手に入れられてしまいます。
- aws-vault のキーチェーンは、ロックが解除されている間はパスワードを聞かれずにキーを取り出せる(筆者の環境では、操作しないまま 5 分たつかスリープするとロックされる設定でした。
security show-keychain-info aws-vault.keychainで確認できます) - MFA を設定していても、aws-vault は MFA 付きのセッションをキャッシュするので、その間は MFA のコードを聞かれない
AI エージェントに勝手に使わせたくない場合は、次のような対策も組み合わせましょう。
- Claude Code の設定(
settings.json)で、aws-vaultコマンドの実行を禁止する
{
"permissions": {
"deny": ["Bash(aws-vault:*)"]
}
}
- キーチェーンがロックされるまでの時間を短くする(例:1 分)
$ security set-keychain-settings -lut 60 aws-vault.keychain
応用:Claude Code に AWS 環境を調べてもらう
サブシェルの中で Claude Code を起動すると、Claude Code が内部で実行する aws コマンドも、サブシェルの一時認証情報でそのまま動きます。
$ aws-vault exec kenken
Starting subshell /bin/zsh, use `exit` to exit the subshell
$ claude
長期キーを AI エージェントに渡したり、設定ファイルに書いたりしなくてよく、渡るのは約 1 時間で切れる一時キーだけです。
Claude Code は、渡された権限の範囲で何でも実行できます。調査だけが目的なら、読み取り専用の権限を持つ IAM ユーザーのプロファイル で起動するのがおすすめです。
ハマりどころ・Tips
いまサブシェルの中にいるか分からなくなる
サブシェルに入っても見た目は普段のシェルと変わらないので、入っているのか分からなくなりがちです。環境変数 AWS_VAULT で確認できます。
$ echo $AWS_VAULT
kenken
何も表示されなければ、サブシェルの外にいます。
サブシェルの中で別のプロファイルに切り替えられない
サブシェルの中でさらに aws-vault exec を実行すると、エラーになります。プロファイルを切り替えるときは、いったん exit してから入り直します。
$ exit
$ aws-vault exec other-profile
まとめ
- aws-vault は、長期キーを金庫(キーチェーン)にしまい、コマンドには合鍵(一時キー)だけを渡す ツール
- 一時キーはサブシェルの環境変数で渡すので、ファイルに残らず、
exitで消える - ターミナルごとに権限を切り分けられる ので、別のターミナルで動く AI エージェントにうっかり認証情報が渡らない
- ターミナルで完結するので、ログインのたびにブラウザでポチポチする手間がない
- 複数の IAM ユーザーの使い分けが楽
普段からAWS CLIを多用する方は、ぜひ一度試してみてください。