django-sabia-auth 1.1.0

Django OAuth2 authentication backend for Sabiá (Brazil's SUS identity provider)

django-sabia-auth

Django OAuth2 authentication backend for Sabiá, Brazil's SUS (Sistema Único de Saúde) identity provider, hosted at login.sabia.ufrn.br.

Installation

pip install django-sabia-auth

Configuration

Add to INSTALLED_APPS and configure settings:

INSTALLED_APPS = [
    ...
    "django_sabia_auth",
]

AUTHENTICATION_BACKENDS = [
    "django_sabia_auth.backends.SabiaAuthBackend",
    "django.contrib.auth.backends.ModelBackend",
]

SABIA_CLIENT_ID = "your-client-id"
SABIA_CLIENT_SECRET = "your-client-secret"
SABIA_REDIRECT_URI = "https://yourapp.example.com/auth/sabia/callback/"
SABIA_SCOPES = ["cpf", "email"]  # optional, these are the defaults
LOGIN_REDIRECT_URL = "/dashboard/"
LOGIN_URL = "/login/"

URL Setup

# urls.py
from django.urls import path, include

urlpatterns = [
    path("auth/sabia/", include("django_sabia_auth.urls")),
    ...
]

Usage

Add a login button to your template:

<a href="{% url 'sabia_auth:login' %}">Login with Sabiá</a>

Documentation

Full documentation is available in the docs/ directory.

Sabiá Developer Portal

For API credentials, visit the Sabiá developer page.

License

MIT © 2026 kelsoncm