GovBR Auth - Documentação

Autentique usuários com o Gov.br usando FastAPI, Flask, Django ou sua própria stack personalizada.

🧪 Novo! Modo fake integrado para desenvolvimento sem necessidade de cadastro no Gov.br!

📖 Guia de Início Rápido

• ⚡ Quick Start
  • Instalação
  • Exemplo Básico com FastAPI
  • Próximos Passos
  • Exemplos
• ⚙️ Configuração
  • Visão Geral
  • Variáveis de Ambiente
  • Carregando de .env
  • Configuração Explícita
  • Gerando cript_verifier_secret
  • Modo Fake (Desenvolvimento)
  • Validação de Configuração
  • Ambientes Suportados
  • Referência de Campos
• 🧩 Frameworks
  • FastAPI
  • Flask
  • Django
  • Stack Personalizada
  • Comparação de Frameworks
  • Callbacks de Sucesso
  • Tratamento de Erros

🔒 Segurança e Boas Práticas

• 🔒 Segurança e Boas Práticas
  • Fluxo de Autenticação Backend + Frontend
  • Proteção de State (CSRF)
  • Proteção do Code Verifier (PKCE)
  • Verificação JWT (ID Token)
  • Criptografia do Verifier Secret
  • Tokens Nunca no Navegador
  • Modo Fake (Desenvolvimento Apenas)
  • Checklist de Segurança
  • Referências Técnicas
  • Relatar Vulnerabilidades
• 🧪 Modo Fake Gov.br

📚 Referência API

• 📚 Core - Lógica Principal
  • GovBrConfig
  • GovBrAuthorize
  • GovBrIntegration
  • Exceções
• 🔌 Controller - Conectores para Frameworks
  • GovBrConnector
  • Métodos de Inicialização
• 🧪 Fake GovBr - Modo Desenvolvimento
  • FakeGovBrService
  • FakeUserData
  • Funções Auxiliares
• 🔨 Utils - Funções Auxiliares
  • generate_cript_verifier_secret()

📝 Adicional

• 🔧 Troubleshooting
• ❓ Perguntas Frequentes
• 📝 Changelog

Índice e Busca

• Index

• Search Page