Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jaxxstorm/change-aws-credentials
A simple tool to change your AWS credentials quickly from the commandline
https://github.com/jaxxstorm/change-aws-credentials
aws commandline credentials mfa password profile rotate secret
Last synced: about 1 month ago
JSON representation
A simple tool to change your AWS credentials quickly from the commandline
- Host: GitHub
- URL: https://github.com/jaxxstorm/change-aws-credentials
- Owner: jaxxstorm
- License: mit
- Created: 2017-12-29T21:52:11.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T08:29:20.000Z (11 months ago)
- Last Synced: 2024-07-17T00:47:14.265Z (4 months ago)
- Topics: aws, commandline, credentials, mfa, password, profile, rotate, secret
- Language: Go
- Size: 48.8 KB
- Stars: 9
- Watchers: 2
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# change-aws-credentials
[](https://travis-ci.org/jaxxstorm/change-aws-credentials)
A simple tool to change your AWS credentials quickly from the commandline.
Currently supports changing your password, will eventually support changing your MFA and Access/Secret Keys
# Prerequisites
Your AWS users must have the ability to change their own IAM credentials. You can see how to configure this [here](http://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_users-self-manage-mfa-and-creds.html)
# Installation
### OS X
Install via homebrew: `brew install jaxxstorm/tap/change-aws-credentials`
### Linux
Install the Go binary and place it in your `$PATH`. You can download the latest version using this handy one-liner:
```
curl -s https://api.github.com/repos/jaxxstorm/change-aws-credentials/releases/latest | jq -r '.assets[]| select(.browser_download_url | contains("linux")) | .browser_download_url' | wget -i -
```
### Windows
Download the latest release from the [releases](https://github.com/jaxxstorm/change-aws-credentials/releases/latest) page and install as appropriate.
# Usage
Assuming you have a working aws credentials file in the usual location (`$HOME/.aws`) then you can just run the command:
```bash
Allows users to quickly reset their AWS credentials without
having to burden an administrator
Usage:
change-aws-credentials [flags]
change-aws-credentials [command]
Available Commands:
help Help about any command
keys Rotate your AWS keys
password Change your AWS Password
Flags:
-P, --awsprofile string AWS Profile to Change Credentials for
--config string config file (default is $HOME/.change-aws-password.yaml)
-h, --help help for change-aws-credentials
Use "change-aws-credentials [command] --help" for more information about a command.
```
## Docker
A docker image is built with every version, just remember to mount your AWS credentials file in the docker container like so:
```
docker run -it -v $HOME:/root/ change-aws-credentials:latest keys
```
## Profiles
You can specify the AWS profile you want to change the password for using the `-P` flag. If you don't explicitly specify this, the tool will warn you which profile you're changing using by checking the `AWS_PROFILE` environment variable
# Building
If you want to contribute, we use glide for dependency management, so it should be as simple as:
- cloning this repo into `$GOPATH/src/github.com/jaxxstorm/change-aws-credentials`
- run glide install from the directory
- run go build -o change-aws-credentials main.go