Skip to content

Latest commit

 

History

History
52 lines (40 loc) · 2.36 KB

README.md

File metadata and controls

52 lines (40 loc) · 2.36 KB
Raw

The Problem statement a.k.a laziness

AWS CLI for MFA (Multi-factor authentication) enabled profiles relies of OTP which is only valid for 36 hours max. The manual way is

  1. pick up the phone, open Google Authenticator, find out the token code
  2. type in a an aws cli command and supply the token code, generate new credentials
  3. manually edit ~/.aws/credentials file with the new values.

What this script does

Automates all of the steps above in a single script. (Yes, no need to use the phone) Using the pyOTP library, it gets your OTP, fetches a new set of AWS credentials, and optionally overwrites your current aws credentials file.

How to install

##Easy pip3 install -r requirements.txt

##Ideal (Create a virtualenv and install) python3 -m venv venv source venv\bin\activate pip3 install -r requirements.txt

How to run

Edit awsOTP.py and configure your parameters. You will find this in the #configuration section. python3 awsOTP.py

##Note: The script runs in 2 steps Step 1) It tries to fetch the new AWS credentials. If you like, you can stop the script at this stage and manually copy paste the credentials to your file. Step 2) If you select "y" when prompted to overwrite, The script makes a backup of existing credentials file (.bak in existing folder) and overwrites the contents of the USERNAME_mfa config (The name of the tag is specified in the python file as AWSMFATag) [USERNAME_mfa] aws_access_key_id=################### aws_secret_access_key=############### aws_session_token=##################

Did it work?

If all went well, you should be able to run one of your standard aws cli commands which makes use of your mfa profile.

Pre-requisites

  1. Python3 + AWS CLI (command line interface is installed)
  2. aws credentials file & config file is already setup. This is usually found in ~/.aws/ folder on Linux machines.

Know issues.

  1. Since the generated OTP is only valid for 60 seconds, in some cases it might be expired too son. If you get an invalid MFA Token/ expired error, simply re-run the script, It will pick up the new OTP token and try to generate a new set of credentials.
  2. Only the last version of credentials file is backed up.

Potential security issue

All config parameters are stored in plain text, including your MFA/2FA code. Do not use this script of a shared machine or servers.

Test coverage

Tested on Ubuntu 18.04 LTS desktop