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 black pre-commit

PyPI Version Supported Python versions License

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

Install this via pip (or your favourite 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-0.1.1.tar.gz (6.2 kB view details)

Uploaded Source

Built Distribution

stsmfa_cli-0.1.1-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: stsmfa_cli-0.1.1.tar.gz
  • Upload date:
  • Size: 6.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.9.2 readme-renderer/37.3 requests/2.28.1 requests-toolbelt/0.10.1 urllib3/1.26.13 tqdm/4.64.1 importlib-metadata/5.1.0 keyring/23.11.0 rfc3986/2.0.0 colorama/0.4.6 CPython/3.9.15

File hashes

Hashes for stsmfa_cli-0.1.1.tar.gz
Algorithm Hash digest
SHA256 3bcfbe5622910ae0b69c0a23dbb7ca99d8c56708e12e7a198e3e434545728344
MD5 c81f97c75e07ec4d88bc3c096e38011c
BLAKE2b-256 091b2a5a365a3d73d3b1118e0dd6c8d54fccaf4a77deb5e211af13403ded7ca4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: stsmfa_cli-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 6.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.9.2 readme-renderer/37.3 requests/2.28.1 requests-toolbelt/0.10.1 urllib3/1.26.13 tqdm/4.64.1 importlib-metadata/5.1.0 keyring/23.11.0 rfc3986/2.0.0 colorama/0.4.6 CPython/3.9.15

File hashes

Hashes for stsmfa_cli-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d84a9da62891edad98fabd2e93e89e4a63b190896b444836ae4fc4a32051ede5
MD5 d50fb2bc56828e8b018e968933726615
BLAKE2b-256 5553e0b10fae2d79ff8e4c7414ae4c7db63ed1698b7d02d0dbb338e18502d030

See more details on using hashes here.

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