Sistema de redirecionamento para integração entre clientes da Betha Sistemas e o Login Único do GovBR.
O Login Único do GovBR exige que todos os redirecionamentos OAuth2 sejam feitos através de domínios .gov.br da prefeitura. Isso significa que os sistemas da Betha não podem receber diretamente o retorno do login governamental.
O problema:
- GovBR só aceita URLs de retorno em domínios
.gov.br - Sistemas Betha estão em
betha.cloud(não é.gov.br) - Prefeituras precisam configurar redirecionamentos manualmente
A solução:
Este gateway permite que a prefeitura publique quatro páginas simples em seu domínio .gov.br. As páginas carregam um script da Betha que executa o redirecionamento no navegador.
- O servidor da prefeitura recebe uma rota como
/login. - Nginx ou Apache entrega o HTML correspondente com HTTP
200. - A página carrega o
app.jshospedado pela Betha. - O script identifica a rota e redireciona o navegador para o serviço Betha.
- Todos os parâmetros da URL original são propagados para o destino.
O servidor web não redireciona para a Betha. Ele apenas publica login.html,
beth.html, suite.html e logout.html. O redirecionamento externo acontece no
frontend, facilitando a instalação em ambientes gerenciados.
| Rota da Prefeitura | Destino Betha | Descrição |
|---|---|---|
/login |
Login Único GovBR | Portal de autenticação governamental |
/beth |
Beth Cloud | Sistema Beth da Betha |
/suite |
Betha Suite | Plataforma principal da Betha |
/logout |
Logout GovBR | Encerramento de sessão |
Importante: A prefeitura configura as rotas públicas em seu domínio. Os destinos Betha são mantidos no
app.jsremoto.
✅ Domínio .gov.br configurado - O gateway deve estar em um domínio oficial da prefeitura
✅ Servidor web disponível - Apache ou Nginx configurado e funcionando
✅ Acesso de administrador - Para configurar o servidor
Escolha o servidor web que sua prefeitura utiliza:
- Docker + Apache: Instalação isolada em container
- Apache tradicional: Integração com servidor existente
- XAMPP (Windows): Ambiente completo para desenvolvimento
- Apache nativo (Windows): Instalação direta
📖 Ver guia completo para Apache
- Docker + Nginx: Instalação isolada em container
- Nginx tradicional: Integração com servidor existente
- Windows: Instalação direta no Windows
📖 Ver guia completo para Nginx
Após instalar o gateway, você precisa configurar as URLs no portal do GovBR. Use estas informações:
📅 Data prevista para disponibilização à sociedade → Coloque uma data 1 semana após o preenchimento
👥 Quantidade atual de contas (Produção) → Informe o número de usuários da prefeitura
📊 Número de acessos por dia → Estimativa de logins diários dos funcionários
🌐 Lista de IPs do serviço
→ 18.228.71.37, 54.207.92.132, 52.67.237.89
URL de retorno Produção:
https://prefeitura.gov.br/govbr-gateway/login
https://prefeitura.gov.br/govbr-gateway/beth
URL página inicial do Sistema:
https://prefeitura.gov.br/govbr-gateway/suite
URL de logout de produção:
https://prefeitura.gov.br/govbr-gateway/logout
URL de retorno Produção:
https://prefeitura.gov.br/login
https://prefeitura.gov.br/beth
URL página inicial do Sistema:
https://prefeitura.gov.br/suite
URL de logout de produção:
https://prefeitura.gov.br/logout
URL de retorno Produção:
https://criciuma.sc.gov.br/govbr-gateway/login
https://criciuma.sc.gov.br/govbr-gateway/beth
URL página inicial do Sistema:
https://criciuma.sc.gov.br/govbr-gateway/suite
URL de logout de produção:
https://criciuma.sc.gov.br/govbr-gateway/logout
URL de retorno Produção:
https://criciuma.sc.gov.br/login
https://criciuma.sc.gov.br/beth
URL página inicial do Sistema:
https://criciuma.sc.gov.br/suite
URL de logout de produção:
https://criciuma.sc.gov.br/logout
⚠️ Importante: Substituacriciuma.sc.gov.brpelo domínio oficial da sua prefeitura.
O teste deve ser feito no navegador, pois ferramentas como curl não executam o
JavaScript responsável pelo redirecionamento.
Acesse uma rota incluindo parâmetros fáceis de identificar:
https://prefeitura.gov.br/login?teste=govbr&origem=manual
O navegador deve chegar ao Login GovBR com os mesmos parâmetros:
https://login.betha.cloud/servicelogin/govbr?teste=govbr&origem=manual
Repita o teste para /beth, /suite e /logout. Em instalações em subpasta,
teste também /govbr-gateway/login?teste=govbr.
O /suite pode encaminhar o usuário para a autenticação da Suite e encapsular a
URL original em continue. Esse comportamento ocorre depois do gateway.
- Erro 404 em rotas - Verificar se a rota entrega o HTML correspondente
- Permissões negadas - Ajustar permissões dos arquivos
- Porta em uso - Mudar porta ou parar serviço conflitante
- SSL/HTTPS - Certificado necessário para produção
- Guias específicos: Cada exemplo tem seção de solução de problemas
- Suporte Betha: Entre em contato com a equipe técnica
- Logs do servidor: Sempre consulte os logs de erro
- Escolha seu servidor web: Apache ou Nginx
- Acesse o guia específico: Links na seção "Guias de Instalação"
- Siga o passo a passo: Instalação Docker (5 min) ou tradicional (15-30 min)
- Configure no GovBR: Use os templates da seção "Configuração no Portal GovBR"
- Teste: Use uma query sentinela e confirme sua presença no destino
GovBR Gateway - Desenvolvido pela Betha Sistemas para facilitar a integração entre prefeituras brasileiras e o Login Único do Governo Federal, conforme exigências do padrão OAuth2 em domínios .gov.br.
Para suporte técnico, entre em contato com a equipe Betha Sistemas.
Este projeto é distribuído pela Betha Sistemas para uso exclusivo de clientes em integração com o Login Único do GovBR.