Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pda/aws-keychain
CLI manager for AWS IAM access keys in Mac OS X keychain; succeeded by https://github.com/99designs/aws-vault
https://github.com/pda/aws-keychain
Last synced: 14 days ago
JSON representation
CLI manager for AWS IAM access keys in Mac OS X keychain; succeeded by https://github.com/99designs/aws-vault
- Host: GitHub
- URL: https://github.com/pda/aws-keychain
- Owner: pda
- Created: 2014-11-06T09:54:04.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2017-08-23T11:37:21.000Z (about 7 years ago)
- Last Synced: 2024-10-04T04:13:59.119Z (about 1 month ago)
- Language: Shell
- Homepage:
- Size: 14.6 KB
- Stars: 193
- Watchers: 21
- Forks: 20
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
aws-keychain
============
*Note: I recommend https://github.com/99designs/aws-vault instead, and will not be maintaining aws-keychain.*
The aim of `aws-keychain` is to run commands that require AWS credentials
without ever storing those credentials unencrypted on disk. Mac OS X's keychain
is used for storage, and credentials are passed to commands via the well known
environment variables that all tools look for.
```
aws-keychain (c) 2014-2015 Paul Annesley MIT license.
Store multiple AWS IAM access keys in Mac OS X keychain.
Check out one of them at a time into ~/.aws/credentials
Manage access keys in Keychain:
aws-keychain add
aws-keychain add # (interactive prompt for key and secret)
aws-keychain ls
aws-keychain exec
aws-keychain rm
```
Install
-------
Copy/symlink `aws-keychain` to somewhere in your path.
```sh
ln -s $(pwd)/aws-keychain /usr/local/bin
```
If you're using Zsh, copy/symlink `aws-keychain-completion.zsh` to `_aws-keychain` in an `$fpath` directory:
```sh
ln -s $(pwd)/aws-keychain-completion.zsh /usr/local/share/zsh/site-functions/_aws-keychain
```
If you're using Bash, source `aws-keychain-completion.bash` in your `.bashrc` or copy/symlink `aws-keychain-completion.bash` to your `etc/bash_completion.d`:
```sh
ln -s $(pwd)/aws-keychain-completion.bash /usr/local/etc/bash_completion.d/aws-keychain-completion.bash
```
Example
-------
```sh
# beware shell history
$ aws-keychain add personal AKILNNK8O1KFMIZRQY1J QURSltVBG33e1qUxVhtsDw
$ aws-keychain add work
Access Key ID: AKIJA9JFOPAKMH9AJPCJ
Secret Access Key (hidden): ********
$ aws-keychain ls
personal
work
$ aws-keychain exec personal aws s3 ls
2012-08-22 13:56:43 some-bucket-name
2014-02-12 19:12:31 another-bucket
$ aws-keychain rm work
password has been deleted.
$ aws-keychain ls
personal
```