Este manual cobre a integração completa do CaptiveWeb com roteadores e APs Mikrotik rodando RouterOS via Hotspot com RADIUS.

⚠️
Pré-requisitosRouterOS versão 6.49 ou superior. Acesso administrativo ao equipamento via WinBox ou SSH. O equipamento deve estar cadastrado no painel do CaptiveWeb e o Shared Secret copiado de Equipamentos → seu equipamento → Configuração RADIUS.

1. Parâmetros RADIUS

No painel do CaptiveWeb, acesse Equipamentos → seu equipamento → Configuração RADIUS e copie os valores:

ParâmetroValor
Servidor RADIUS (Auth)45.234.216.27
Porta Auth1812
Porta Accounting1813
Shared SecretGerado automaticamente — copie do painel em Equipamentos → Configuração RADIUS
Porta CoA3799 (UDP, aceitar pacotes de entrada)
ℹ️
Chave do portalA URL do portal (com a chave key=) é exibida no painel em Equipamentos → seu equipamento → Captive Link após salvar o equipamento. Copie diretamente de lá.

2. Configurar RADIUS no RouterOS

Substitua SEU_SECRET pelo valor copiado do painel:

/radius
add address=45.234.216.27 secret=SEU_SECRET service=hotspot     authentication-port=1812 accounting-port=1813 timeout=3s

/ip hotspot user profile
set default rate-limit="" use-radius=yes

/ip hotspot
set [find] use-radius=yes accounting=yes

3. Configurar redirect do portal

Substitua SUA_CHAVE pela chave captive exibida em Equipamentos → seu equipamento → Captive Link:

/ip hotspot
set [find] login-by=http-chap,mac-cookie login-page=https://portal.captiveweb.com.br?key=SUA_CHAVE

4. Configurar Walled Garden

Libere os domínios do CaptiveWeb antes da autenticação. O Walled Garden usa apenas domínios HTTP/HTTPS — não inclua o IP do RADIUS (que trafega via UDP, não HTTP):

/ip hotspot walled-garden
add dst-host=portal.captiveweb.com.br
add dst-host=*.captiveweb.com.br
add dst-host=fonts.googleapis.com
add dst-host=fonts.gstatic.com
add dst-host=*.mercadopago.com
add dst-host=*.mercadolibre.com
add dst-host=*.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 UDP nas portas 1812/1813 e não é tráfego HTTP — o Hotspot já se comunica com ele automaticamente sem necessidade de liberação via Walled Garden.

5. Habilitar CoA (Change of Authorization)

O CoA permite que o CaptiveWeb reative o acesso do usuário automaticamente após confirmação de pagamento, sem necessidade de reconexão:

/ip hotspot
set [find] radius-default-domain="" radius-mac-format=XX:XX:XX:XX:XX:XX

/radius incoming
set accept=yes port=3799

6. Testar a integração

  1. Conectar ao Wi-Fi

    Com um celular, conecte ao SSID configurado no Mikrotik.

  2. Verificar redirect

    O navegador deve abrir automaticamente o portal do CaptiveWeb.

  3. Autenticar

    Complete o cadastro ou use um voucher para testar a autenticação.

  4. Verificar acesso

    Após autenticar, o acesso à internet deve ser liberado imediatamente.

✅
Integração concluídaSe o redirect funcionou e o acesso foi liberado após autenticação, a integração está completa. Verifique no painel se o usuário aparece em Relatórios → Cadastros.

Modelos compatíveis

Série / ModeloDescrição
hAP ac² (RBD52G-5HacD2HnD)Roteador Wi-Fi 5 dual-band, popular em escritórios
hAP ac³ (RBD53G-5HacD2HnD)Roteador Wi-Fi 5 com 5 portas PoE
hAP ax² (C52iG-5HaxD2HaxD)Roteador Wi-Fi 6 dual-band
hAP ax³ (C53UiG+5HPaxD2HPaxD)Roteador Wi-Fi 6 tri-band
RB750Gr3 / hEXRoteador sem Wi-Fi, 5 portas Gigabit — usado com AP externo
RB760iGS / hEX ShEX com SFP e PoE saída
RB960PGS / hEX PoEhEX com PoE nas 4 portas
RB4011iGS+5HacQ2HnDRoteador de alto desempenho Wi-Fi 5
CCR1009-7G-1C-1S+Cloud Core Router — provedor de pequeno porte
CCR2004-16G-2S+Cloud Core Router — provedor de médio porte
CCR2116-12G-4S+Cloud Core Router — provedor de grande porte
CHR (Cloud Hosted Router)Versão virtual do RouterOS (VM / VPS)
CRS series (com routing)Switch gerenciável com pacote routerOS
ℹ️
CompatibilidadeQualquer equipamento Mikrotik com RouterOS 6.49 ou superior e pacote hotspot instalado é compatível com a integração CaptiveWeb.