ibm-sso

When using SSO Self-Service Provisioner for single sign-on, ibm-sso can make your work easier.

Currently only supports fastapi applications.

Getting Started

pip install ibm-sso

Add ibm-sso to requirements.txt
```
ibm-sso==0.2.1
```
For versions lower than 0.1.0, the token is returned directly after successful authentication.

For versions 0.1.x is experimental, please do not use it.

Starting from version 0.2.1, you need to create your own nonce on the client side and then pass that nonce along with the redirect_uri to the server side. code and state are returned after successful authentication. You need to use the code, state, nonce and redirect_uri to obtain token information.
Install ibm-sso from requirements.txt file
```
pipenv install -r requirements.txt
```
Set environment variables

Refer to the .env.template in the sample directory.
Import ibm-sso in startup file

Refer to the app.py in the sample directory.
Protect your API

If your API requires authentication to access, you can refer to sample.py

There is a full sample in the sample directory that can be run directly. You can start from the sample to learn how to use ibm-sso.

Deploy project

# https://test.pypi.org/
expect interactive_deploy_test.expect

# https://pypi.org/
# expect interactive_deploy.expect

Use test.pypi.org

pipenv install -i https://test.pypi.org/simple/ ibm-sso

How to mark a version as yanked

twine yank <package_name> --version <version> --reason "Reason this release was yanked: Yanked due to <reason>"