O CaptiveWeb é compatível com qualquer equipamento de rede que suporte autenticação RADIUS padrão (RFC 2865) com portal captive externo. Use este guia se o seu fabricante não tem manual específico.

ℹ️
Como funcionaO equipamento redireciona o usuário para a URL do portal, o usuário se autentica, e o CaptiveWeb envia um RADIUS Access-Accept ao equipamento liberando o acesso. O equipamento deve enviar o MAC do cliente no atributo Calling-Station-Id e incluir mac= na URL de redirect.

1. Parâmetros RADIUS

Use estes valores ao configurar o servidor RADIUS no seu equipamento. O Shared Secret é gerado individualmente por equipamento no painel em Equipamentos → seu equipamento → Configuração RADIUS:

ParâmetroValor
Servidor RADIUS (Auth)45.234.216.27
Porta Auth1812
Porta Accounting1813
Shared SecretGerado automaticamente — copie do painel em Equipamentos → Configuração RADIUS
NAS IdentifierChave captive do equipamento (campo key da URL do portal)
CoA Port3799 (UDP, para reativação após pagamento)

2. URL do portal captive

Configure no equipamento a URL de redirecionamento para o portal. A URL do portal é exibida no painel em Equipamentos → seu equipamento → Captive Link:

https://portal.captiveweb.com.br?key=SUA_CHAVE
⚠️
Parâmetro mac= obrigatórioO equipamento deve acrescentar o endereço MAC do cliente na URL de redirect como parâmetro mac=. Exemplo de URL final: https://portal.captiveweb.com.br?key=SUA_CHAVE&mac=AA:BB:CC:DD:EE:FF. Sem esse parâmetro o CaptiveWeb não consegue autenticar a sessão RADIUS corretamente.

3. Atributos RADIUS esperados

O equipamento deve enviar os seguintes atributos RADIUS no Access-Request:

Atributo RADIUSDescriçãoObrigatório
Calling-Station-IdMAC address do cliente (formato AA:BB:CC:DD:EE:FF ou AA-BB-CC-DD-EE-FF)Sim
NAS-IP-AddressIP do equipamento (NAS)Sim
NAS-IdentifierIdentificador do NAS (geralmente o hostname ou a chave captive)Recomendado
Acct-Session-IdID da sessão (para Accounting)Sim (Accounting)

4. Walled Garden

Configure o Walled Garden do equipamento para permitir acesso HTTP/HTTPS aos domínios do CaptiveWeb antes da autenticação:

portal.captiveweb.com.br
*.captiveweb.com.br
fonts.googleapis.com
fonts.gstatic.com
*.mercadopago.com
*.mercadolibre.com
*.asaas.com
⚠️
RADIUS não vai no Walled GardenO IP do servidor RADIUS (45.234.216.27) não deve ser adicionado ao Walled Garden. O RADIUS usa protocolo UDP nas portas 1812/1813, não HTTP — o equipamento se comunica com ele automaticamente.

5. CoA — Reativação automática após pagamento

Para que o CaptiveWeb possa reativar o acesso do usuário automaticamente após pagamento (sem reconexão manual), configure o equipamento para aceitar pacotes CoA:

  • Protocolo: UDP
  • Porta: 3799
  • Origem: 45.234.216.27
  • Shared Secret: o mesmo configurado para RADIUS
✅
Pronto para usoCom os parâmetros acima configurados, o CaptiveWeb consegue autenticar, registrar sessões e reativar acessos em qualquer equipamento RADIUS-compatível.