Manual de integração — Cisco Aironet / Catalyst 9800
Integração do CaptiveWeb com Cisco Aironet e Catalyst 9800 usando WebAuth externo com URL de bridge. O Cisco Aironet envia o parâmetro MAC do cliente como client_mac= — o CaptiveWeb normaliza automaticamente via URL de bridge antes de processar.
client_mac= em vez de mac= padrão. Por isso a integração exige a URL de bridge específica /public/portal-connect/cisco-redirect, que faz essa normalização automaticamente.1. Cadastrar o equipamento no painel CaptiveWeb
Acesse Equipamentos → Novo equipamento
No painel CaptiveWeb, vá em Equipamentos → Novo equipamento e selecione o tipo Cisco Aironet.
Salve e copie a bridge URL
Após salvar, copie a Bridge URL exibida no painel. O formato é:
https://portal.captiveweb.com.br/public/portal-connect/cisco-redirect?key=SUA_CHAVE
2. Parâmetros RADIUS
| Parâmetro | Valor |
|---|---|
| Servidor RADIUS Auth | 45.234.216.27 |
| Porta Auth | 1812 |
| Porta Accounting | 1813 |
| Shared Secret | Copiado do painel em Equipamentos → Configuração RADIUS |
| CoA Port | 3799 |
3. Configurar WebAuth externo no Cisco
Acesse Security → Web Auth
No controller Cisco (WLC ou Catalyst 9800), vá em Security → Web Auth → External.
Configure o Redirect URL
No campo Redirect URL, cole a bridge URL copiada do painel:
https://portal.captiveweb.com.br/public/portal-connect/cisco-redirect?key=SUA_CHAVEConfigure o servidor RADIUS
Em Security → AAA → RADIUS → Authentication, adicione o servidor
45.234.216.27porta1812com o Shared Secret do painel.Habilite Accounting
Em Security → AAA → RADIUS → Accounting, adicione o mesmo IP porta
1813.
4. Walled Garden
Libere os domínios necessários antes da autenticação:
portal.captiveweb.com.br
*.captiveweb.com.br
fonts.googleapis.com
fonts.gstatic.com
*.mercadopago.com
*.mercadolibre.com
*.asaas.com
Modelos compatíveis
| Série / Modelo | Descrição |
|---|---|
| Catalyst 9800-40 | WLC físico para até 2.000 APs |
| Catalyst 9800-80 | WLC físico para até 6.000 APs |
| Catalyst 9800-L | WLC compacto para pequenas redes |
| Catalyst 9800-CL | WLC virtual (VM / cloud) |
| Catalyst 9130AXI / 9130AXE | AP Wi-Fi 6 indoor / externo |
| Catalyst 9136AXI | AP Wi-Fi 6E indoor alta densidade |
| Catalyst 9162I / 9164I / 9166I | APs Wi-Fi 6E indoor — linha recente |
| Catalyst 9178I | AP Wi-Fi 6E multi-link indoor |
| Aironet 4800 (AIR-AP4800) | AP Wi-Fi 5 indoor, legado — ainda suportado |
| Aironet 3800 / 2800 / 1800 | APs Wi-Fi 5 legados — suportados via WebAuth |
client_mac= — use obrigatoriamente a URL de bridge gerada pelo CaptiveWeb.Esse artigo foi útil?
Obrigado pelo feedback! ✅