Skip to main content

A small CLI to help with creating AWS profile for MFA protected sessions

Project description

STS MFA CLI

CI Status Test coverage percentage

Poetry Ruff pre-commit

PyPI Version Supported Python versions License


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
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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stsmfa_cli-1.4.2.tar.gz (5.3 kB view details)

Uploaded Source

Built Distribution

stsmfa_cli-1.4.2-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

File details

Details for the file stsmfa_cli-1.4.2.tar.gz.

File metadata

  • Download URL: stsmfa_cli-1.4.2.tar.gz
  • Upload date:
  • Size: 5.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for stsmfa_cli-1.4.2.tar.gz
Algorithm Hash digest
SHA256 cbc8b1c120c1b63c9ee32a42af8dd092e02ff2129d3e035208bf427887f1f54e
MD5 ec7c427da01c015c0de20d0f78b1b3d9
BLAKE2b-256 4ba801ea7826aaa68d9ebfce2f2c9b8a3c507a9543ee13ad8654bc2b7d52c9be

See more details on using hashes here.

Provenance

The following attestation bundles were made for stsmfa_cli-1.4.2.tar.gz:

Publisher: ci.yml on browniebroke/stsmfa-cli

Attestations:

File details

Details for the file stsmfa_cli-1.4.2-py3-none-any.whl.

File metadata

  • Download URL: stsmfa_cli-1.4.2-py3-none-any.whl
  • Upload date:
  • Size: 5.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for stsmfa_cli-1.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b1f882089bfbae58c2e163bdaf7e2c5e6018242b8c089be645e33da05f971381
MD5 fbef637003f0f9067fe24332b6748e95
BLAKE2b-256 9d976b74ba55a8b8b9008e131dd2a81edf1db21be7f27bb1ac7781c4b48c13ba

See more details on using hashes here.

Provenance

The following attestation bundles were made for stsmfa_cli-1.4.2-py3-none-any.whl:

Publisher: ci.yml on browniebroke/stsmfa-cli

Attestations:

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page