django-allauth-2f2a 0.8.1

Adds two factor authentication to django-allauth.

django-allauth-2f2a is a port of django-allauth-2fa that adds two-factor authentication to django-allauth and intends to continue active development of the code. The current goals include generating SVG codes as files to allow stricter content security policies, configuration of form classes used by the app to allow subclassing forms for use with django-crispy-forms, and improved CI and testing.

Features

• Add two-factor authentication views and workflow to django-allauth.

• Support Authenticator apps via a QR code when enabling 2FA.

• Support single-use back-up codes.

Compatibility

django-allauth-2f2a will only maintain compatibility with supported versions of Django and python and recent, secure versions of django-allauth, and django-otp, currently:

• Python 3.6-3.9.

• Django 2.2, 3.2.

• django-allauth 0.44.0 and newer.

• django-otp 1.0.0 and newer.

Running Tests

Currently, tests can be run using the standard Django testing facility:

python manage.py test

Project tests will be moved to pytest in the future.

Running the Test Project

The test project can also be used as a minimal example using the following:

# Migrate the SQLite database first.
DJANGO_SETTINGS_MODULE=tests.run_settings python manage.py migrate
# Run the server with debug.
DJANGO_SETTINGS_MODULE=tests.run_settings python manage.py runserver_plus
# Run the shell.
DJANGO_SETTINGS_MODULE=tests.run_settings python manage.py shell_plus

Author

django-allauth-2fa was originally created by Víðir Valberg Guðmundsson (@valberg) of Percipient Networks. All modifications after the port to django-allauth-2f2a are created and maintained by Jeremy A Gray at FQS.