dj-two-factor-social-auth 1.0.1

App connecting django-two-factor-auth and django-social-auth. If user authenticates through social auth, he will be enforced to go through 2FA (if he has it enabled).

App connecting django-two-factor-auth and social-app-django. If user authenticates through social auth, he will be enforced to go through 2FA (if he has 2FA enabled).

Documentation

The full documentation is at https://dj-two-factor-social-auth.readthedocs.io.

Quickstart

We expect, that you have already installed and configured django-two-factor-auth and social-app-django according to their documentation.

Install Django two factor auth for Django social auth:

pip install dj-two-factor-social-auth

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    "two_factor",
    "social_django",
    "social_2fa",
    ...
)

Add Django two factor auth for Django social auth’s URL patterns:

from django.urls import path


urlpatterns = [
    ...
    path("", include("social_2fa.urls")),
    ...
]

Add social_2fa to your social pipeline in settings.py:

SOCIAL_AUTH_PIPELINE = (
    ...
    "social_2fa.social_pipeline.two_factor_auth",
)

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

Development commands

pip install -r requirements_dev.txt
invoke -l

History

1.0.1 (2025-05-19)

• Fix: session transfer of data

1.0.0 (2025-05-15)

• Use session to transfer data (safer, more reliable)

• Update support up to Django 5.2, Python 3.13 versions

• Drop support for Python 3.8, Django 4.0 and below

0.1.2 (2023-03-09)

• Try to rename package to be compatible with poetry (https://github.com/python-poetry/poetry/issues/6996)

0.1.1 (2023-03-08)

• Update testing and setup.py to support newest Django, Python and django-two-factor-auth

0.1.0 (2022-03-21)

• First release on PyPI.