99designs /aws-vault

A vault for securely storing and accessing AWS credentials in development environments

★ 8,999⑂ 824👁 115⑃ 639● 637▤ 78
GoMITCreated 2015-08-11
下载:v7.2.0v7.2.0 ↓7.2.02023-03-26
+0
日增长
8,999
stars
824
forks
115
watchers
639
prs
637
issues
78
releases

README

AWS Vault




 [!WARNING]
 This project has been abandoned and it's not receiving any more updates. If you want to continue to receive updates
 or contribute, please feel free to look at the active fork at: https://github.com/ByteNess/aws-vault

AWS Vault is a tool to securely store and access AWS credentials in a development environment.

AWS Vault stores IAM credentials in your operating system's secure keystore and then generates temporary credentials from those to expose to your shell and applications. It's designed to be complementary to the AWS CLI tools, and is aware of your profiles and configuration in ~/.aws/config.

Check out the announcement blog post for more details.

 Installing

You can install AWS Vault:
- by downloading the latest release
- on macOS with Homebrew: brew install aws-vault
- on macOS with MacPorts: port install aws-vault
- on Windows with Chocolatey: choco install aws-vault
- on Windows with Scoop: scoop install aws-vault
- on Linux with Homebrew on Linux: brew install aws-vault
- on Arch Linux: pacman -S aws-vault
- on Gentoo Linux: emerge --ask app-admin/aws-vault (enable Guru first)
- on FreeBSD: pkg install aws-vault
- on OpenSUSE: enable devel:languages:go repo then zypper install aws-vault
- with Nix: nix-env -i aws-vault
- with asdf-vm: asdf plugin-add aws-vault https://github.com/karancode/asdf-aws-vault.git && asdf install aws-vault 

 Documentation

Config, usage, tips and tricks are available in the USAGE.md file.

 Vaulting Backends

The supported vaulting backends are:

 macOS Keychain
 Windows Credential Manager
 Secret Service (Gnome Keyring, KWallet)
 KWallet
 Pass
 Encrypted file

Use the --backend flag or AWS_VAULT_BACKEND environment variable to specify.

 Quick start

shell
 Store AWS credentials for the "jonsmith" profile
$ aws-vault add jonsmith
Enter Access Key Id: ABDCDEFDASDASF
Enter Secret Key: %%%

 Execute a command (using temporary credentials)
$ aws-vault exec jonsmith -- aws s3 ls
bucket_1
bucket_2

 open a browser window and login to the AWS Console
$ aws-vault login jonsmith

 List credentials
$ aws-vault list
Profile                  Credentials              Sessions
=======                  ===========              ========
jonsmith                 jonsmith                 -

 Start a subshell with temporary credentials
$ aws-vault exec jonsmith
Starting subshell /bin/zsh, use exit to exit the subshell
$ aws s3 ls
bucket_1
bucket_2


 How it works

aws-vault uses Amazon's STS service to generate temporary credentials via the GetSessionToken or AssumeRole API calls. These expire in a short period of time, so the risk of leaking credentials is reduced.

AWS Vault then exposes the temporary credentials to the sub-process in one of two ways

1. Environment variables are written to the sub-process. Notice in the below example how the AWS credentials get written out
   shell
   $ aws-vault exec jonsmith -- env | grep AWS
   AWS_VAULT=jonsmith
   AWS_DEFAULT_REGION=us-east-1
   AWS_REGIO

Latest release

v7.2.0 v7.2.0 2023-03-26
What's Changed
 Update golangci-lint by @mtibben in https://github.com/99designs/aws-vault/pull/1194
 Fix credential type detection for login by @mtibben in https://github.com/99designs/aws-vault/pull/1193
 Prioritise source_profile over sso config by @mtibben in https://github.com/99designs/aws-vault/pull/1196
 Fix ini output to match credentials file by @mtibben in https://github.com/99designs/aws-vault/commit/a4f5e3dc3fd2dbe61a1527adbe945374d8973b94

Full Changelog: https://github.com/99designs/aws-vault/compare/v7.1.2...v7.2.0

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON