Metadata-Version: 2.1
Name: aws-ssooidc
Version: 2022.10.1.2
Summary: Create temporary credentials for AWS SSO-OIDC.
Home-page: https://github.com/fer1035/pypi-ssooidc
License: GPL-2.0-only
Keywords: AWS,SSO,OIDC
Author: Ahmad Ferdaus Abd Razak
Author-email: ahmad.ferdaus.abd.razak@ni.com
Requires-Python: >=3.6,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: boto3 (>=1.17.78,<2.0.0)
Project-URL: Repository, https://github.com/fer1035/pypi-ssooidc
Description-Content-Type: text/x-rst

===============
**aws_ssooidc**
===============

Overview
--------

Create temporary credentials with AWS SSO-OIDC access tokens.

Prerequisites
-------------

- *Python >= 3.6*
- *boto3 (https://pypi.org/project/boto3/) >= 1.17.78*

Required (Positional) Arguments
-------------------------------

- Position 1: start_url (the start URL for your AWS SSO login)

Optional (Keyword) Arguments
----------------------------

- client_name
    - Description: Arbitrary name of the SSO client to create.
    - Type: String
    - Default: 'ssoclient'
- region
    - Description: Your AWS region.
    - Type: String
    - Default: 'us-east-1'
- timeout
    - Description: Number of tries before giving up.
    - Type: Integer
    - Default: 30

Usage
-----

Installation:

.. code-block:: BASH

   pip3 install aws-ssooidc
   # or
   python3 -m pip install aws-ssooidc

In Python3:

.. code-block:: BASH

   import aws_ssooidc as sso

   response = sso.gettoken('<start_url>')
   access_token = response['accessToken']

In BASH:

.. code-block:: BASH

   python [/path/to/]aws_ssooidc \
   -u <sso_url>

