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.
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
File details
Details for the file stsmfa_cli-1.3.0.tar.gz.
File metadata
- Download URL: stsmfa_cli-1.3.0.tar.gz
- Upload date:
- Size: 5.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 755710dfe370f58c1b05b61d339401f3cf6b202e1e2dba0849327a43fe85c652 |
|
| MD5 | 0e845e1bb947fe8abad9bdf9db9615d0 |
|
| BLAKE2b-256 | 82e3aa542e3b07bf873117e9512f59ec2ba36937ee2782ae4c06c2164e621a32 |
File details
Details for the file stsmfa_cli-1.3.0-py3-none-any.whl.
File metadata
- Download URL: stsmfa_cli-1.3.0-py3-none-any.whl
- Upload date:
- Size: 5.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0e43227e46fce8d2a64caba7f14ef7a1f38e4776f1358d4822a8c3bce46e5dfe |
|
| MD5 | 96850bf7cd66bc39c7f991ff55d9b396 |
|
| BLAKE2b-256 | 29e61222abc61fe8d7e885b48b9f22ce7fb2d0d5911a1293990528b6deb126ea |
