Manual de Integração — Mikrotik RouterOS

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

1. Parâmetros RADIUS

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

2. Configurar RADIUS no RouterOS

Execute no terminal do Mikrotik:

/radius
add address=radius.captiveweb.com.br 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 Walled Garden

Libere os domínios do CaptiveWeb antes da autenticação:

/ip hotspot walled-garden
add dst-host=portal.captiveweb.com.br
add dst-host=*.captiveweb.com.br
add dst-host=radius.captiveweb.com.br
add dst-host=*.mercadopago.com
add dst-host=*.mercadolibre.com
add dst-host=*.asaas.com
add dst-host=fonts.googleapis.com
add dst-host=fonts.gstatic.com

4. Configurar redirect do portal

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

5. Habilitar CoA (Change of Authorization)

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

# Habilitar CoA para reativação após pagamento
/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.