https://github.com/pabloviquez/aws-authenticator
AWS Authenticator interface
https://github.com/pabloviquez/aws-authenticator
authentication aws aws-sts brew mfa
Last synced: 21 days ago
JSON representation
AWS Authenticator interface
- Host: GitHub
- URL: https://github.com/pabloviquez/aws-authenticator
- Owner: pabloviquez
- License: mit
- Created: 2020-01-20T17:38:57.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-06-07T23:07:31.000Z (11 months ago)
- Last Synced: 2025-02-07T19:44:38.090Z (2 months ago)
- Topics: authentication, aws, aws-sts, brew, mfa
- Language: Shell
- Size: 8.6 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AWS Authenticator Helper
This tool is a simple interface that handles the CLI authentication with Amazon Web Services using the Multi-Factor-Authentication (MFA).
## Requirements
The tool requires the AWS CLI and JQ tool.
# Install - Homebrew
```
brew tap pabloviquez/aws-authenticator
brew install aws-authenticator
```
# Install - Manually
```
wget https://github.com/pabloviquez/aws-authenticator/archive/v1.1.0.tar.gz
tar -xzvf v1.1.0.tar.gz
chmod +x v1.1.0/aws-authenticator
sudo cp v1.1.0/aws-authenticator /usr/local/bin
rm -Rf v1.1.0
```
# Basis Usage
```
aws-authenticator
```
## Force authentication and change the profile used
```
aws-authenticator -f -p MYAWSPROFILE
```
### Note
After running the tool, you need to load the variables as follows:
```
source ~/.aws/mfa-session
```
# Options
The supported options are:
```
Options:
-h Help, displays this message.
-v Verbose display.
-a ACCOUNT_ID Sets a different AWS account ID, also resets the MFA ARN serial.
-p PROFILE Uses the given profile for authentication. If not provided, will use the default.
-f Forces re-authentication.
-s Display all default values and variables loaded in environment.
-r Resets the AWS session values and deletes the ARN configured forcing to prompt
the username on the next authentication.
```
# TODO
* Load variables in the shell automatically after executing the tool.
* Be able to use different AWS config locations.