This SDK allows a web developer to quickly add Duo's interactive, self-service, two-factor authentication to any Python3 web login form. Only Python 3 is supported.
What's here:
duo_universal
- The Python Duo SDK for interacting with the Duo Universal Promptdemo
- An example web application with Duo integratedtests
- Test cases
To use the SDK in your existing development environment, install it from pypi (https://pypi.org/project/duo_universal).
pip3 install duo_universal
Once it's installed, see our developer documentation at https://duo.com/docs/duoweb and demo/app.py
in this repo for guidance on integrating Duo 2FA into your web application.
To contribute, fork this repo and make a pull request with your changes when they're ready.
If you're not already working from a dedicated development environment, it's recommended a virtual environment is used. Assuming a virtual environment named env
, create and activate the environment:
python3 -m venv env
source env/bin/activate
Build and install the SDK from source:
pip3 install -r requirements.txt
pip3 install .
Install the test requirements:
cd tests
pip3 install -r requirements.txt
Then run tests from the test
directory:
# Run an individual test file
python3 <test_name>.py
# Run all tests with unittest
python3 -m unittest
flake8
Please report any bugs, feature requests, or issues to us directly at support@duosecurity.com.
Thank you for using Duo!