# aws-sso-util
## Making life with Identity Center a little easier
[AWS IAM Identity Center](https://aws.amazon.com/single-sign-on/) (formerly AWS SSO) has some rough edges, and `aws-sso-util` is here to smooth them out, hopefully temporarily until AWS makes it better.
`aws-sso-util` contains utilities for the following:
* Configuring `.aws/config`
* Logging in/out
* AWS SDK support
* Looking up identifiers
* CloudFormation
The underlying Python library for Identity Center authentication is [`aws-sso-lib`](https://pypi.org/project/aws-sso-lib/), which has useful functions like interactive login, creating a boto3 session for specific a account and role, and the programmatic versions of the `lookup` functions in `aws-sso-util`.
`aws-sso-util` supersedes `aws-sso-credential-process`, which is still available in its original form [here](https://github.com/benkehoe/aws-sso-credential-process).
Read the updated docs for `aws-sso-util credential-process` [here](docs/credential-process.md).
## Quickstart
1. I recommend you install [`pipx`](https://pipxproject.github.io/pipx/), which installs the tool in an isolated virtualenv while linking the script you need.
Mac [and Linux](https://docs.brew.sh/Homebrew-on-Linux):
```bash
brew install pipx
pipx ensurepath
```
Other:
```bash
python3 -m pip install --user pipx
python3 -m pipx ensurepath
```
2. Install
```bash
pipx install aws-sso-util
```
3. Learn
```bash
aws-sso-util --help
```
## Documentation
See the full docs at [https://github.com/benkehoe/aws-sso-util](https://github.com/benkehoe/aws-sso-util)
Raw data
{
"_id": null,
"home_page": "https://github.com/benkehoe/aws-sso-util",
"name": "aws-sso-util",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "Ben Kehoe",
"author_email": "ben@kehoe.io",
"download_url": "https://files.pythonhosted.org/packages/6e/93/90d3753ac7ea3148c41c43929cace11d8fc1331c629497ab24a91a6c3724/aws_sso_util-4.32.0.tar.gz",
"platform": null,
"description": "# aws-sso-util\n## Making life with Identity Center a little easier\n\n[AWS IAM Identity Center](https://aws.amazon.com/single-sign-on/) (formerly AWS SSO) has some rough edges, and `aws-sso-util` is here to smooth them out, hopefully temporarily until AWS makes it better.\n\n`aws-sso-util` contains utilities for the following:\n* Configuring `.aws/config`\n* Logging in/out\n* AWS SDK support\n* Looking up identifiers\n* CloudFormation\n\nThe underlying Python library for Identity Center authentication is [`aws-sso-lib`](https://pypi.org/project/aws-sso-lib/), which has useful functions like interactive login, creating a boto3 session for specific a account and role, and the programmatic versions of the `lookup` functions in `aws-sso-util`.\n\n`aws-sso-util` supersedes `aws-sso-credential-process`, which is still available in its original form [here](https://github.com/benkehoe/aws-sso-credential-process).\nRead the updated docs for `aws-sso-util credential-process` [here](docs/credential-process.md).\n\n## Quickstart\n\n1. I recommend you install [`pipx`](https://pipxproject.github.io/pipx/), which installs the tool in an isolated virtualenv while linking the script you need.\n\nMac [and Linux](https://docs.brew.sh/Homebrew-on-Linux):\n```bash\nbrew install pipx\npipx ensurepath\n```\n\nOther:\n```bash\npython3 -m pip install --user pipx\npython3 -m pipx ensurepath\n```\n\n2. Install\n```bash\npipx install aws-sso-util\n```\n\n3. Learn\n```bash\naws-sso-util --help\n```\n\n## Documentation\n\nSee the full docs at [https://github.com/benkehoe/aws-sso-util](https://github.com/benkehoe/aws-sso-util)\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Utilities to make AWS SSO easier",
"version": "4.32.0",
"project_urls": {
"Homepage": "https://github.com/benkehoe/aws-sso-util",
"Repository": "https://github.com/benkehoe/aws-sso-util"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "19b74012b44f54e106e7da763e94ea3b6812240e875489f9512c0f9fb70daffa",
"md5": "e10cf24e5124559150abd69cd310f5df",
"sha256": "1fed25d12b03809c3252c3f499981747ef5fc33527712b9c631dcae9540ac32f"
},
"downloads": -1,
"filename": "aws_sso_util-4.32.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e10cf24e5124559150abd69cd310f5df",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7,<4.0",
"size": 62094,
"upload_time": "2023-07-19T20:13:48",
"upload_time_iso_8601": "2023-07-19T20:13:48.925217Z",
"url": "https://files.pythonhosted.org/packages/19/b7/4012b44f54e106e7da763e94ea3b6812240e875489f9512c0f9fb70daffa/aws_sso_util-4.32.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6e9390d3753ac7ea3148c41c43929cace11d8fc1331c629497ab24a91a6c3724",
"md5": "71717f12fbdb73d3dda83d7f8117d983",
"sha256": "2649dcf3c594851a0c55ed6ebf2df70205d1debd6e58e263738430d4703890ec"
},
"downloads": -1,
"filename": "aws_sso_util-4.32.0.tar.gz",
"has_sig": false,
"md5_digest": "71717f12fbdb73d3dda83d7f8117d983",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7,<4.0",
"size": 43731,
"upload_time": "2023-07-19T20:13:50",
"upload_time_iso_8601": "2023-07-19T20:13:50.481662Z",
"url": "https://files.pythonhosted.org/packages/6e/93/90d3753ac7ea3148c41c43929cace11d8fc1331c629497ab24a91a6c3724/aws_sso_util-4.32.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-19 20:13:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "benkehoe",
"github_project": "aws-sso-util",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "aws-sso-util"
}
JSON
