https://github.com/duosecurity/duo_universal_python
Duo OIDC-based two-factor authentication for Python web applications
https://github.com/duosecurity/duo_universal_python
duo mfa python
Last synced: 17 days ago
JSON representation
Duo OIDC-based two-factor authentication for Python web applications
- Host: GitHub
- URL: https://github.com/duosecurity/duo_universal_python
- Owner: duosecurity
- License: other
- Created: 2020-10-16T00:45:23.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-20T20:55:18.000Z (about 1 month ago)
- Last Synced: 2025-03-29T07:02:59.321Z (25 days ago)
- Topics: duo, mfa, python
- Language: Python
- Homepage: https://duo.com/docs/duoweb
- Size: 108 KB
- Stars: 25
- Watchers: 31
- Forks: 22
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Duo Universal Python SDK
[](https://github.com/duosecurity/duo_universal_python/actions)
[](https://github.com/duosecurity/duo_universal_python/issues)
[](https://github.com/duosecurity/duo_universal_python/network/members)
[](https://github.com/duosecurity/duo_universal_python/stargazers)
[](https://github.com/duosecurity/duo_universal_python/blob/master/LICENSE)
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.
## Tested Against Python Versions:
- 3.7
- 3.8
- 3.9
- 3.10
- 3.11
## TLS 1.2 and 1.3 Support
Duo_universal_python uses Python's ssl module and OpenSSL for TLS operations. Python versions 2.7 (and higher) and 3.5 (and higher) have both TLS 1.2 and TLS 1.3 support.
## What's here:
* `duo_universal` - The Python Duo SDK for interacting with the Duo Universal Prompt
* `demo` - An example web application with Duo integrated
* `tests` - Test cases
## Getting Started
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.
## Contribute
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 .
```
## Tests
Install the test requirements:
```
cd tests
pip3 install -r requirements.txt
```
Then run tests from the `test` directory:
```
# Run an individual test file
python3 .py
# Run all tests with unittest
python3 -m unittest
```
## Lint
```
flake8
```
## Support
Please report any bugs, feature requests, or issues to us directly at [email protected].
Thank you for using Duo!
https://duo.com/