ibm-sso

IBM SSO Self-Service Provisioner


Keywords
sso, fastapi, oidc
License
BSD-3-Clause
Install
pip install ibm-sso==0.0.1

Documentation

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

Usage

  1. Add ibm-sso to requirements.txt

    ibm-sso==0.1.1

    For versions above 0.1.0, code and state are returned after successful authentication. You need to use the code and state to obtain token information.

    For versions lower than 0.1.0, the token is returned directly after successful authentication. Since the token is returned as the query param of the callback, there are security risks. Versions higher than 0.1.0 are recommended.

  2. Install ibm-sso from requirements.txt file

    pipenv install -r requirements.txt
  3. Set environment variables

    Refer to the .env.template in the sample directory.

  4. Import ibm-sso in startup file

    Refer to the app.py in the sample directory.

  5. Protect your API

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

Sample

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(memo for developer)

  1. Deploy project

    # https://test.pypi.org/
    expect interactive_deploy_test.expect
    
    # https://pypi.org/
    # expect interactive_deploy.expect
  2. Use test.pypi.org

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