Welcome to django-allauth-2fa!¶
django-allauth-2fa adds two-factor authentication to django-allauth. django-allauth is a set of Django applications which help with authentication, registration, and other account management tasks.
- Source code
- http://github.com/percipient/django-allauth-2fa
- Documentation
- https://django-allauth-2fa.readthedocs.io/
Features¶
- Adds two-factor authentication views and workflow to django-allauth.
- Supports Authenticator apps via a QR code when enabling 2FA.
- Supports single-use back-up codes.
Compatibility¶
django-allauth-2fa attempts to maintain compatibility with supported versions of Django, django-allauth, and django-otp.
Current versions supported together is:
Django | django-allauth | django-otp | Python |
---|---|---|---|
4.1 | 0.53.0 | 1.2 | 3.8, 3.9, 3.10, 3.11 |
4.2 | 0.53.0 | 1.2 | 3.8, 3.9, 3.10, 3.11 |
Contributing¶
django-allauth-2fa was initially created by Víðir Valberg Guðmundsson (@valberg), was maintained by Percipient Networks for many years, and is now maintained by Valohai. Please feel free to contribute if you find django-allauth-2fa useful!
- Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
- If you feel uncomfortable or uncertain about an issue or your changes, feel free to email support@percipientnetworks.com and we will happily help you.
- Fork the repository on GitHub to start making your changes to the main branch (or branch off of it).
- Write a test which shows that the bug was fixed or that the feature works as expected.
- Send a pull request and bug the maintainer until it gets merged and published.
Start contributing¶
Start by cloning the project with:
git clone https://github.com/valohai/django-allauth-2fa.git
The project uses hatch for building and package management. If you don’t have hatch installed, you can do so by running:
pip install hatch
Setup you virtual environment with hatch:
hatch env create
Running the test project¶
The test project can also be used as a minimal example using the following:
hatch run python manage.py migrate
hatch run python manage.py runserver
- Installation
- Configuration
- Advanced Configuration
- Changelog
- 0.12.0 - Unreleased
- 0.11.1 - July 13, 2023
- 0.11.0 - July 4, 2023
- 0.10.0 - July 4, 2022
- 0.9 - April 11, 2022
- 0.8 February 3, 2020
- 0.7 September 10, 2019
- 0.6 February 13, 2018
- 0.5 December 21, 2017
- 0.4.4 March 24, 2017
- 0.4.3 January 18, 2017
- 0.4.2 December 15, 2016
- 0.4.1 December 14, 2016
- 0.4 November 7, 2016
- 0.3.2 October 26, 2016
- 0.3.1 October 5, 2016
- 0.3 October 5, 2016
- 0.2 September 9, 2016
- 0.1.4 May 2, 2016
- 0.1.3 January 20, 2016
- 0.1.2 November 23, 2015
- 0.1.1 October 21, 2015
- 0.1 April 4, 2015