# Google SAML Auth
This is a utility to obtain temporary Amazon Web Services (AWS) Security Token Service (STS) credentials for use on the local Command Line Interface (CLI).
This is an enhancement on the popular [AWS Google Auth](https://github.com/cevoaustralia/aws-google-auth) application, which uses a requests library to authenticate to Google before authenticating to AWS via SAML.
This application works similarly, however bypasses the need to authenticate into Google by using the user's existing Google web browser session to post the SAML assertion used for AWS authentication back to this application via local HTTP callback.
## Getting Started
This project relies on Python (specifically, we've only tested on `Python 3`). Please first install Python3 using Brew
```sh
brew install python
```
You'll then need to configure profiles to use in your `~/.aws/config` file. An example below:
```conf
[profile profile-name]
region = ap-southeast-2
account = 123456789012
google_config.google_idp_id = ABCDE1234
google_config.role_name = production-engineer
google_config.google_sp_id = 000000000000
```
### Running the application
Ready? Start the app with the following command
```sh
python3 google-saml-auth.py --profile profile-name
```
### Administrator Instructions
// TODO: How to setup application in Google SAML Console
Raw data
{
"_id": null,
"home_page": "https://github.com/bengieeee/aws-google-saml",
"name": "aws-google-saml",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "aws, aws-cli, saml, google, google-saml, google-saml-aws",
"author": "bengieeee",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/3e/89/8382720147070e0e2e5be8e8b1aab1204debb27e19bcf72481c5dfeed9b0/aws_google_saml-2024.716.3.tar.gz",
"platform": null,
"description": "# Google SAML Auth\n\nThis is a utility to obtain temporary Amazon Web Services (AWS) Security Token Service (STS) credentials for use on the local Command Line Interface (CLI).\n\nThis is an enhancement on the popular [AWS Google Auth](https://github.com/cevoaustralia/aws-google-auth) application, which uses a requests library to authenticate to Google before authenticating to AWS via SAML.\n\nThis application works similarly, however bypasses the need to authenticate into Google by using the user's existing Google web browser session to post the SAML assertion used for AWS authentication back to this application via local HTTP callback.\n\n## Getting Started\n\nThis project relies on Python (specifically, we've only tested on `Python 3`). Please first install Python3 using Brew\n\n```sh\nbrew install python\n```\n\nYou'll then need to configure profiles to use in your `~/.aws/config` file. An example below:\n\n```conf\n\n[profile profile-name]\nregion = ap-southeast-2\naccount = 123456789012\ngoogle_config.google_idp_id = ABCDE1234\ngoogle_config.role_name = production-engineer\ngoogle_config.google_sp_id = 000000000000\n\n```\n\n### Running the application\n\nReady? Start the app with the following command\n\n```sh\npython3 google-saml-auth.py --profile profile-name\n```\n\n### Administrator Instructions\n\n// TODO: How to setup application in Google SAML Console\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A user-browser driven SAML authentication tool for AWS",
"version": "2024.716.3",
"project_urls": {
"Download": "https://github.com/bengieeee/aws-google-saml/archive/refs/tags/0.7.1.tar.gz",
"Homepage": "https://github.com/bengieeee/aws-google-saml"
},
"split_keywords": [
"aws",
" aws-cli",
" saml",
" google",
" google-saml",
" google-saml-aws"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3e898382720147070e0e2e5be8e8b1aab1204debb27e19bcf72481c5dfeed9b0",
"md5": "11952e037074aef0471a50af4556edcf",
"sha256": "da31c6d13c83485b6c92027f56d4df8532263fd1749ea10cba1778b15877f784"
},
"downloads": -1,
"filename": "aws_google_saml-2024.716.3.tar.gz",
"has_sig": false,
"md5_digest": "11952e037074aef0471a50af4556edcf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7505,
"upload_time": "2024-07-16T09:39:33",
"upload_time_iso_8601": "2024-07-16T09:39:33.696081Z",
"url": "https://files.pythonhosted.org/packages/3e/89/8382720147070e0e2e5be8e8b1aab1204debb27e19bcf72481c5dfeed9b0/aws_google_saml-2024.716.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-16 09:39:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bengieeee",
"github_project": "aws-google-saml",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "aws-google-saml"
}
JSON
