Metadata-Version: 2.1
Name: aws-sso-credential-provider
Version: 0.0.5
Summary: Session credential provider for AWS SSO roles
Home-page: https://github.com/kcerdena/aws_sso
Author: Kacey Cerdena
Author-email: 6180729+kcerdena@users.noreply.github.com
License: UNKNOWN
Description: # aws-sso-credential-provider
        
        Retrieves temporary credentials for programmatic access using AWS SSO roles.
        
        [![build](https://img.shields.io/github/workflow/status/kcerdena/aws_sso/build?style=plastic)](https://github.com/kcerdena/aws_sso/actions?query=workflow%3Abuild)
        [![Codecov](https://img.shields.io/codecov/c/github/kcerdena/aws_sso?style=plastic&token=91b2881bcee24aeda75bf2f9ad4b0f59)](https://codecov.io/gh/kcerdena/aws_sso)
        
        [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=kcerdena_aws_sso&metric=alert_status)](https://sonarcloud.io/dashboard?id=kcerdena_aws_sso)
        [![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=kcerdena_aws_sso&metric=reliability_rating)](https://sonarcloud.io/dashboard?id=kcerdena_aws_sso)
        [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=kcerdena_aws_sso&metric=security_rating)](https://sonarcloud.io/dashboard?id=kcerdena_aws_sso)
        [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=kcerdena_aws_sso&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=kcerdena_aws_sso)
        
        
        ## Installation
        
        Requires installation of [AWS CLI version 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) for SSO support.
        
        Use the package manager [pip](https://pip.pypa.io/en/stable/) to install aws-sso-credential-provider.
        
        ```bash
        pip install aws-sso-credential-provider
        ```
        
        ## Usage
        ```bash
        usage: python -m aws_sso [-h] -p PROFILE [-r ROLEARN] [-ns] [-env | -ext]
        
        optional arguments:
          -h, --help            show this help message and exit
          -p PROFILE, --profile PROFILE
                                Named profile for AWS SSO login
          -r ROLEARN, --rolearn ROLEARN
                                RoleArn for session credentials
          -ns, --no-store-creds
                                Disable output of session credential to AWS_SHARED_CREDENTIALS_FILE
          -env, --env_vars      Output session credential environment variable export strings
          -ext, --external-source
                                Use as external credential provider. Implies -ns option
        
        ```
        
        
        ## Contributing
        Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
        
        Please make sure to update tests as appropriate.
        
        ## License
        [GNU GPLv3](https://choosealicense.com/licenses/gpl-3.0/)
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.6
Description-Content-Type: text/markdown
