auth_suap

auth_suap é um plugin de autenticação para o Moodle que implementa Single Sign-On (SSO) via OAuth2 contra o SUAP (Sistema Unificado de Administração Pública), usado no Instituto Federal do Rio Grande do Norte (IFRN) e em outras instituições federais brasileiras. Além de autenticar, o plugin sincroniza dados institucionais do usuário (nome, e-mail, CPF, vínculo, curso, campus, foto, entre outros) em campos de perfil customizados do Moodle a cada login.

Conteúdo

• Visão geral
  • O que o plugin faz
  • Requisitos
  • Dependência opcional
  • Idiomas
  • Estrutura do repositório
  • Organização
• Instalação
  • 1. Configuração no SUAP
  • 2. Configuração no Moodle
  • 3. Configuração do SUAP no Moodle
  • 4. Testando o acesso
• Fluxo de autenticação
  • Resumo
  • Endpoints do plugin
  • Passo 1 — login()
  • Passo 2 — troca do código por token
  • Passo 3 — coleta de dados do usuário
  • Passo 4 — criação/atualização do usuário
  • Passo 5 — conclusão do login
  • Logout
• Sincronização de usuário
  • Campos de perfil criados automaticamente
  • Campos alterados no primeiro login vs. logins seguintes
  • Atualização da foto do usuário
  • Tarefa agendada: preenchimento retroativo de fotos
  • Ação em massa: atualizar foto pela listagem de usuários
  • Configuração do nome de exibição (nome social)
  • Tarefa agendada: sincronização retroativa de nomes
  • Notas
• Privacidade
  • O que o provider declara
• Desenvolvimento
  • Versionamento
  • Pre-commit (obrigatório)
  • Executando os testes localmente com act
  • CI/CD
  • Documentação
  • Empacotamento manual