AWS SSO Config Builder
Table of Contents
The Gist
This tool generates AWS CLI configuration blocks for use with AWS IAM Identity Center (formerly AWS SSO):
Why
...would someone use this?
If they:
- Have access to a large or shifting set of accounts and roles through AWS SSO
- Don't already have tools in place to generate and maintain their named profiles
- There are a few of these, I remember aws-sso-util in particular
- Want to automatically generate/regenerate templatized blocks without interfering with manually-defined sections
...did I publish this?
- After https://github.com/99designs/aws-vault/pull/1088 got merged, I wanted to update the script I use to update my AWS CLI config
- Cog wasn't on my radar when I started doing this stuff, but is just what I want to maintain the cleaner bits of my frankenconfig
- I wanted an excuse to try Hatch on something
...the focus on aws-vault?
From the user experience perspective, the biggest win is that when using my aws-vault profiles, they just work:
- If I don't have an active SSO session, it pops open a browser to login without me having to manually type
aws sso login - If my session credentials are missing or expired, aws-vault refreshes them behind the scenes without killing running commands
But to be fair, a lot of why I use aws-vault is habit. If you're not already using it, I'm not here to sell it to you.
Installation
Into the Active Python Environment
pip install aws-sso-config-builder
With Pipx
pipx install aws-sso-config-builder
With Pipx Alongside Cog
Useful to support Usage with Cog.
pipx install cogapp
pipx inject cogapp aws-sso-config-builder
Usage
Generate AWS CLI sso-session and profile blocks based on the accounts
and roles granted by your AWS SSO login(s).
Use as a CLI tool or from Python.
CLI
Quickstart with Defaults
generate-sso-profiles -s my-sso-directory-name
This will generate sso-session and profile blocks
More Options
Usage: generate-sso-profiles [OPTIONS]
Options:
-s, --sso-directories TEXT SSO directory names, which will be used:
- To define "sso-session" config blocks
- To build an SSO start URL [required]
-t, --profile-template TEXT An AWS CLI profile block template with
{placeholders} for profile values
Supported placeholder variables:
- profile_name
- account_name
- account_id
- role_name
- sso_session
...and any other "key" provided in --extra-
vars
-e, --extra-vars TEXT Custom variables in the form "key=value" that
can be referenced with {placeholders} in a
profile template.
-r, --regex-replacements TEXT Regex replacements to perform on generated
profile names, in the form
'pattern,replacement'
--help Show this message and exit.
Python
Quickstart with Defaults
from aws_sso_config_builder.gen_config import generate_config_blocks
print(generate_config_blocks(sso_directories=["my-sso-directory-name"]))
Usage with Cog
Use Cog to dynamically generate or replace specific sections inside an ~/.aws/config file without touching manually-maintained blocks.
This invocation specifies:
- A custom profile template, including:
credential_processprofiles for use with aws-vault- additional settings defined for each profile
- Some regex replacements to adjust the generated profile name
Add this Cog block to a new or existing ~/.aws/config file:
# [[[cog
# import cog
# from aws_sso_config_builder.gen_config import generate_config_blocks
#
# cog.outl(generate_config_blocks(
# sso_directories=["home", "work"],
# profile_template="""
# [profile {profile_name}-sso]
# sso_session = {sso_session}
# sso_account_id = {account_id}
# sso_role_name = {role_name}
# output = json
# region = us-east-2
#
# [profile {profile_name}]
# credential_process = {aws_vault_path} exec --json {profile_name}-sso
# output = json
# region = us-east-2
# """,
# regex_replacements={
# "Production": "prod",
# "Sandbox": "sbx"
# },
# aws_vault_path="/home/aj/go/bin/aws-vault",
# ))
# ]]]
# [[[end]]]
And then run:
cog -r ~/.aws/config
Note that this depends on having Cog and aws-sso-config-builder installed in the same Python environment. See also Installation with Pipx Alongside Cog above.
Extras
Fish Convenience Functions
These are probably specific to my environment, but sharing them because someone else might find them useful.
I use a fish convenience function (asp) to search or switch among AWS profiles. I'm reasonably sure that it was inspired at some point by a function of the same name in the aws plugin for oh-my-zsh.
Invoking asp with no arguments opens an fzf search of available profiles. But the command also supports tab completion with this completion script.
License
aws-sso-config-builder is distributed under the terms of the MIT license.
Metadata
Release files for aws-sso-config-builder 0.0.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aws_sso_config_builder-0.0.4.tar.gz | 18.1 kB | Without provenance | Details for aws_sso_config_builder-0.0.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aws_sso_config_builder-0.0.4-py3-none-any.whl | Python 3 | none | any | Details for aws_sso_config_builder-0.0.4-py3-none-any.whl |
Total release size: 27.0 kB
Release files / aws_sso_config_builder-0.0.4.tar.gz
| Download URL | aws_sso_config_builder-0.0.4.tar.gz |
|---|---|
| Size | 18.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e290956796787590b7b8aca0d2c6498e5f66cc509dc79f4dd6596675dde50a6f
|
|
BLAKE2b-256 checksum How to use checksums |
de8f28f6f261a58424a7c995a91d6a86617e279287247e531a0a90ce48464a36
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-httpx/0.27.2
|
Release files / aws_sso_config_builder-0.0.4-py3-none-any.whl
| Download URL | aws_sso_config_builder-0.0.4-py3-none-any.whl |
|---|---|
| Size | 8.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
14810b3240a41288e8795b68c31823b1fd0a688fc80110f5453673ac42e48c86
|
|
BLAKE2b-256 checksum How to use checksums |
0b283b3f1f745627bd7dcaea12e3d5bd25966745e7c3970598cf91c10667224c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-httpx/0.27.2
|
Security for aws-sso-config-builder 0.0.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.