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.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0e43227e46fce8d2a64caba7f14ef7a1f38e4776f1358d4822a8c3bce46e5dfe |
|
MD5 | 96850bf7cd66bc39c7f991ff55d9b396 |
|
BLAKE2b-256 | 29e61222abc61fe8d7e885b48b9f22ce7fb2d0d5911a1293990528b6deb126ea |