Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Two factor authentication for Wagtail

Project description

This Django app add’s two factor authentication to Wagtail. Behind the scenes it use django-otp which supports Time-based One-Time Passwords (TOTP). This allows you to use various apps like Authy, Google Authenticator, or 1Password.


pip install wagtail-2fa

Then add the following lines to the INSTALLED_APPS list in your Django settings:

    # ...
    # ...

Migrate your database:

python migrate

Next add the required middleware to the MIDDLEWARE. It should come after the AuthenticationMiddleware:

    # .. other middleware
    # 'django.contrib.auth.middleware.AuthenticationMiddleware',


    # 'wagtail.core.middleware.SiteMiddleware',
    # .. other middleware


The following settings are available (Set via your Django settings):

  • WAGTAIL_2FA_REQUIRED (default False): When set to True all staff, superuser and other users with access to the Wagtail Admin site are forced to login using two factor authentication.
  • WAGTAIL_MOUNT_PATH (default: ''): The uWSGI mount point that Wagtail is running at. Ex. /wagtail
  • WAGTAIL_2FA_OTP_TOTP_NAME (default: False): The issuer name to identify which site is which in your authenticator app. If not set and WAGTAIL_SITE_NAME is defined it uses this. sets OTP_TOTP_ISSUER under the hood.


First create a new virtualenv with Python 3.6.1 and activate it. Then run the following commands:

  • make sandbox

You can then visit http://localhost:8000/admin/ and login with the following credentials:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for wagtail-2fa, version 1.2.0
Filename, size File type Python version Upload date Hashes
Filename, size wagtail_2fa-1.2.0-py3-none-any.whl (19.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size wagtail-2fa-1.2.0.tar.gz (14.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page