0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【AWS CLI】aws-vaultでAWS環境にアクセスしてみた

0
Last updated at Posted at 2026-11-19

この記事でわかること

  • aws-vault とは何か、なぜアクセスキーを安全に扱えるのか
  • aws login・aws sso login との違い
  • aws-vault のインストールから実際の使い方まで
  • aws-vault の「サブシェル」の仕組みと、ターミナルごとに権限を切り分けられる利点
  • Claude Code などの AI エージェントと組み合わせるときの注意点

目次

  1. 環境
  2. そもそも何が問題なのか
  3. aws-vault とは
  4. aws login・aws sso login との比較
  5. 使い方
    1. インストール
    2. プロファイルを追加する
    3. MFA を設定する(任意)
    4. 登録済みのプロファイルを確認する
    5. サブシェルを起動して作業する
  6. サブシェルの仕組み
    • ターミナルごとに認証を分けられる
  7. 応用:Claude Code に AWS 環境を調べてもらう
  8. ハマりどころ・Tips
    • いまサブシェルの中にいるか分からなくなる
    • サブシェルの中で別のプロファイルに切り替えられない
  9. まとめ
  10. 参考

環境

項目 バージョン
OS macOS 26.3
aws-vault v7.15.3
AWS CLI 2.37.9

そもそも何が問題なのか

AWS CLI の初期設定で aws configure を実行すると、アクセスキーは ~/.aws/credentials に 平文で 保存されます。

~/.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 ツールです。

  1. 期限のないアクセスキー(長期キー)は、OS のキーチェーンという「金庫」に暗号化してしまっておく
  2. コマンドを実行するとき、aws-vault が金庫からキーを取り出し、AWS STS に一時キーを依頼する
  3. STS が発行するのは、約 1 時間で使えなくなる「合鍵」
  4. 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 を追加します。

~/.aws/config
[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 コマンドの実行を禁止する
.claude/settings.json
{
  "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を多用する方は、ぜひ一度試してみてください。

参考

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?