Manual de integração — TP-Link Omada

Integração do CaptiveWeb com o TP-Link Omada Controller (software, hardware ou cloud). Existem dois modos principais de integração:

• Omada API Local (OMADA_API) — o CaptiveWeb acessa a API do controller para autorizar convidados. Não usa RADIUS. Requer controller cadastrado no painel.
• Omada RADIUS (OMADA_RADIUS) — usa RADIUS padrão para autenticação. Requer configuração de servidor RADIUS no Omada Controller.

Modo 1 — Omada API Local (OMADA_API)

Neste modo, o CaptiveWeb autoriza o convidado via API local do controller após confirmação de autenticação ou pagamento. Não configure RADIUS neste modo — a autorização é inteiramente via API.

1.1 Cadastrar o controller no painel CaptiveWeb

1. Acesse Equipamentos → Nova controladora

   No painel CaptiveWeb, vá em Equipamentos → Nova controladora e selecione o tipo Omada Controller (API local).

2. Informe os dados do controller

   Digite o endereço IP ou hostname do controller Omada, a porta (padrão 8043 ou 443) e as credenciais de administrador.

3. Salve e selecione o controller ao criar o equipamento

   Ao cadastrar o equipamento na localização, selecione esta controladora no dropdown correspondente.

1.2 Configurar External Portal no Omada (modo API)

1. Acesse Settings → Authentication → Portal

   No Omada Controller, vá em Settings → Authentication → Portal.

2. Selecione External Web Portal

   Em Portal Customization, escolha External Web Portal.

3. Informe a URL do portal

   Use a URL exibida no painel em Equipamentos → seu equipamento → URL do Portal: https://portal.captiveweb.com.br?key=SUA_CHAVE

Modo 2 — Omada RADIUS (OMADA_RADIUS)

Neste modo, o Omada usa RADIUS para autenticação. Use quando não for possível usar a API local (ex.: controller sem acesso de rede pelo CaptiveWeb).

2.1 Configurar RADIUS no Omada Controller

Em Settings → Profiles → RADIUS, crie um perfil com os seguintes valores do painel em Equipamentos → Configuração RADIUS:

2.2 Configurar portal e vincular perfil RADIUS

1. Acesse Settings → Authentication → Portal

   Em Settings → Authentication → Portal, configure External Web Portal.

2. Informe a URL do portal

   URL: https://portal.captiveweb.com.br?key=SUA_CHAVE

3. Vincule o perfil RADIUS

   Em Authentication Type → RADIUS, selecione o perfil RADIUS criado no passo anterior.

Walled Garden (ambos os modos)

Em Portal → Walled Garden, adicione:

portal.captiveweb.com.br
*.captiveweb.com.br
fonts.googleapis.com
fonts.gstatic.com
*.mercadopago.com
*.mercadolibre.com
*.asaas.com

Modelos compatíveis