Registry / auth-security / edx-auth-backends

edx-auth-backends

library5.0.0pypypiunverified

Custom authentication backends and pipeline steps for Open edX. Version 5.0.0 adds Django 5.2 support and drops Python 3.8 and 3.11. Release cadence is irregular; maintained by the Open edX community.

auth-security web-framework

pip install edx-auth-backends

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · EDX-AUTH-BACKENDS

edx-auth-backends

auth-securitypythonv5.0.0

Install

7.1s avg

Import

—

Disk

107MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v5.0.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 105.9MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 7.1s · import 0.000s · 107MB

107MB installed

● package 107MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

EdXOpenIdConnect

✓ from auth_backends.open_id_connect import EdXOpenIdConnect

✗ from edx_auth_backends.open_id_connect import EdXOpenIdConnect

Basic configuration for Open edX SSO using OpenID Connect.

# settings.py INSTALLED_APPS = [ ... 'social_django', 'edx_auth_backends', ] AUTHENTICATION_BACKENDS = [ 'edx_auth_backends.backends.EdXOpenIdConnect', 'django.contrib.auth.backends.ModelBackend', ] SOCIAL_AUTH_EDX_OAUTH2_KEY = os.environ.get('EDX_OAUTH2_KEY', '') SOCIAL_AUTH_EDX_OAUTH2_SECRET = os.environ.get('EDX_OAUTH2_SECRET', '') # See docs for full pipeline settings.

Debug

Known issues

breakingPython 3.8 and 3.11 support dropped in v5.0.0.

fix

Use Python 3.9, 3.10, or 3.12+.

affects: >=5.0.0

breakingDjango 5.2 is supported; older Django versions may not work.

fix

Ensure Django 5.2+ is installed.

affects: >=5.0.0

breakingRemovedInDjango40Warning: django.conf.urls.url and include deprecated. Fixed in v4.0.1 but may reappear if using older versions.

fix

Upgrade to v4.0.1+ or replace with django.urls.path/re_path.

affects: <4.0.1

breakingSocial auth pipeline steps changed in v4.0. Backends no longer inherit from deprecated classes.

fix

Update custom pipeline steps to use current social-auth-core API.

affects: >=4.0.0

Upgrade

Version history

5.0.0latest on PyPI · released Mar 11, 2026

Audit

Dependencies

DjangorequiredBackends require Django settings and middleware

social-auth-corerequiredUsed by backends for OAuth2/OpenID Connect flows

social-auth-app-djangorequiredDjango integration for social_auth

Agent activity

25 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/openedx/auth-backends ↗

packagehttps://pypi.org/project/edx-auth-backends/ ↗

homepagehttps://edx.org ↗