django-suap-auth 1.0.1

Django OAuth2 authentication backend for SUAP (IFRN academic management system)

django-suap-auth

Backend de autenticação OAuth2 do Django para SUAP (Sistema Unificado de Administração Pública), o sistema de gestão acadêmica do IFRN, hospedado em suap.ifrn.edu.br.

Instalação

pip install django-suap-auth

Início Rápido

# settings.py
INSTALLED_APPS = [
    ...
    "django_suap_auth",
]

AUTHENTICATION_BACKENDS = [
    "django_suap_auth.backends.SuapAuthBackend",
    "django.contrib.auth.backends.ModelBackend",
]

SUAP_CLIENT_ID = "your-client-id"
SUAP_CLIENT_SECRET = "your-client-secret"
SUAP_REDIRECT_URI = "https://yourapp.example.com/auth/suap/callback/"
SUAP_AUTH_SCOPES = ["identificacao", "email"]  # opcional
LOGIN_REDIRECT_URL = "/dashboard/"
LOGIN_URL = "/login/"

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

urlpatterns = [
    path("auth/suap/", include("django_suap_auth.urls")),
    ...
]

<!-- template -->
<a href="{% url 'suap_auth:login' %}">Login com SUAP</a>

Escopos Disponíveis

Escopo	Descrição
identificacao	Identificação básica (matricula, nome, campus)
email	Endereço de email
documentos_pessoais	Documentos pessoais (CPF, RG)
dados_academicos	Dados acadêmicos (curso, notas, situação)
dados_pessoais	Dados pessoais (data de nascimento, nacionalidade)
reitoria	Dados de nível institucional

Documentação

Documentação completa disponível no diretório docs/ e nas GitHub Pages do projeto.

Licença

MIT © 2026 kelsoncm