django-allauth-2fa 0.12.0

Adds two factor authentication to django-allauth

django-allauth-2fa adds two-factor authentication to versions of django-allauth older than 0.58.0.

For newer versions, you should use django-allauth’s built-in MFA support. Please see issue #189 for more information.

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 is _not_ compatible with django-allauth versions newer than 0.58.0.

django-allauth has a built-in MFA implementation since version 0.56.0, which is likely preferable to this one.

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.57.2	1.2	3.8, 3.9, 3.10, 3.11
4.2	0.57.2	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 finally by Valohai.

Please feel free to contribute if you find django-allauth-2fa useful, but do note that you should likely be using allauth.mfa instead.

1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.

2. If you feel uncomfortable or uncertain about an issue or your changes, feel free to email [e-mail] and we will happily help you.

3. Fork the repository on GitHub to start making your changes to the main branch (or branch off of it).

4. Write a test which shows that the bug was fixed or that the feature works as expected.

5. 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 tests

Tests can be run using pytest

hatch run pytest

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