A small CLI to help with creating AWS profile for MFA protected sessions
Project description
STS MFA 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-0.1.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 12aae1b99ccd40de9b7f3ca62cef0e7812c2f6e70ae475cae95cf90d8b9e8774 |
|
MD5 | 7a1f529c0ba0d39611585241b6d383b8 |
|
BLAKE2b-256 | 02bd659ca0f2cb90651c93a949e02bba085a7a12450eb0b52d6dfa40cc5e2091 |