A small CLI to help with creating AWS profile for MFA protected sessions
Project description
STS MFA CLI
Source Code: https://github.com/browniebroke/stsmfa-cli
Creating temporary profiles for multi-factor auth (MFA) protected accounts using AWS STS is too hard. This is a small CLI that helps with that.
Installation
Via Homebrew:
brew install browniebroke/tap/stsmfa-cli
Via pip, pipx, or your favourite Python package manager:
pip install stsmfa-cli
Usage
The CLI is a simple command stsmfa
that creates a profile for a temporary session protected by MFA.
Assuming your ~/.aws/credentials
file looks like this:
[my-profile-name]
aws_access_key_id = AKIAXXXXX
aws_secret_access_key = xxxx
mfa_serial = arn:aws:iam::123456789010:mfa/first.last
When running, for example:
stsmfa --profile my-profile-name 123456
This will create a session using the MFA serial defined under my-profile-name
with the one-time password 123456
, and save the required AWS key, secret and token under as a new profile my-profile-name-mfa
in you ~/.aws/credentials
file.
Now to use that session, you just need to set AWS_PROFILE=my-profile-name-mfa
.
If your MFA serial is defined under the default profile, you don't need to specify the --profile
option.
Contributors ✨
Thanks goes to these wonderful people (emoji key):
Bruno Alla 💻 🤔 📖 |
This project follows the all-contributors specification. Contributions of any kind welcome!
Credits
This package was created with Copier and the browniebroke/pypackage-template project template.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for stsmfa_cli-1.1.9-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b3d0f35f86309e9ee74132822e98d91b04164ac8cb72d18e11ddc45133db86ee |
|
MD5 | 9b35c9184218336d6d1900b6f6a7cb9e |
|
BLAKE2b-256 | 76af8991ffe1126f8d9a2a3cfb1e828e136f5ba70010a76f70067aa38ef46dd9 |