---
id: grafana-django-saml2-auth
version: "3.21.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# grafana-django-saml2-auth — Deprecated compatibility package. Install django-saml2-auth-community instead.

License: permissive · Maintenance: active · Downloads: 126.8K/mo

## What it is and what it does

This package is a deprecated compatibility layer that was originally maintained by Grafana but is now a redirect to django-saml2-auth-community, the actively maintained fork. It integrates SAML2 authentication into Django applications, supporting both IdP-initiated and SP-initiated single sign-on flows. The underlying library handles SAML2 assertion validation, user creation, and attribute mapping according to your configuration.

The package depends on django-saml2-auth-community for all actual functionality. Installing grafana-django-saml2-auth will pull in that community package, so you get the same SAML2 authentication capabilities but through the maintained line. The only reason to use this shim is if you have existing code or lock files that reference the old package name; new projects should install django-saml2-auth-community directly.

Use it for:

- Migrating from the original grafana-django-saml2-auth to the community fork without changing import statements.
- Updating lock files or requirements.txt that still reference grafana-django-saml2-auth without breaking existing deployments.
- Adding SAML2 SSO to a Django app that needs to work with Okta or other SAML2 identity providers.
- Enabling both IdP-initiated and SP-initiated authentication flows in a Django application.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A compatibility shim that redirects to django-saml2-auth-community, the community-maintained SAML2 authentication library for Django applications.

No—install django-saml2-auth-community directly instead. This package is a deprecated compatibility shim; it exists only to redirect old references to the maintained fork. Using it adds an unnecessary layer of indirection. If you have existing code referencing grafana-django-saml2-auth, the shim will work, but new projects and migrations should use django-saml2-auth-community.

## Install

pip install grafana-django-saml2-auth
uv add grafana-django-saml2-auth
poetry add grafana-django-saml2-auth

## Installing grafana-django-saml2-auth

Before you install: Low install friction; the package is a pure Python wheel with a single runtime dependency. Maintenance is active, with the last commit on 2026-08-06 and a release on 2026-04-11. However, the package itself is deprecated—it exists only as a compatibility shim redirecting users to django-saml2-auth-community.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions. No notable licensing constraints for typical deployment.

Quickstart:

pip install grafana-django-saml2-auth

import django_saml2_auth.views

# In urls.py:
re_path(r'^sso/', include('django_saml2_auth.urls'))

Requires xmlsec1 system library; install via package manager (apt-get install xmlsec1 on Debian/Ubuntu, yum install xmlsec1 on RPM-based systems, or brew install xmlsec1 on macOS).

Verify before relying:

- Whether the compatibility shim maintains full API parity with the original grafana-django-saml2-auth package.
- Performance or behavioral differences between the shim and direct use of django-saml2-auth-community.
- Whether xmlsec1 system dependency is automatically installed or requires manual setup.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 126.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django saml2 authentication, saml sso django, django saml2 auth, saml identity provider django, django single sign-on, saml2 django integration, django okta saml, saml2-sso, authentication, deprecated-shim

[View on SkillFed](https://skillfed.io/packages/grafana-django-saml2-auth) · [View on PyPI](https://pypi.org/project/grafana-django-saml2-auth/)