Manual de integração — Omada via API

O modo OMADA_CLOUD integra o CaptiveWeb com o TP-Link Omada Cloud (openapi.tplinkcloud.com), permitindo gerenciar equipamentos remotamente sem acesso direto à rede local do controller.

Pré-requisitos

• Conta de desenvolvedor TP-Link em developer.tp-link.com
• Aplicação OAuth2 criada com permissão de escrita no site Omada
• Client ID e Client Secret da aplicação
• Site ID do Omada Cloud (visível no painel cloud.tplinkcloud.com)

Configurando a credencial Omada Cloud

1. Acesse Equipamentos → Nova controladora

   No painel CaptiveWeb, vá em Equipamentos → Nova controladora e selecione tipo TP-Link Omada (Cloud API).

2. Informe as credenciais OAuth2

   Cole o Client ID, Client Secret e o Site ID do Omada Cloud nos campos correspondentes.

3. Salve e vincule o equipamento

   Ao cadastrar o equipamento em Equipamentos → Novo equipamento, selecione tipo OMADA_CLOUD e vincule à credencial criada.

Alternativa: OMADA_RADIUS

Se não quiser configurar a API cloud, use o tipo OMADA_RADIUS: a autenticação funciona via RADIUS puro e o redirect do portal é configurado diretamente no Omada Controller (Settings → Profiles → RADIUS). A autorização pós-pagamento usa RADIUS CoA.

Controller → Settings → Profiles → RADIUS:
  Auth Server: 45.234.216.27
  Auth Port: 1812
  Acct Server: 45.234.216.27
  Acct Port: 1813
  Shared Secret: <copie do painel CaptiveWeb>

SSID → Portal → External:
  Portal URL: https://portal.captiveweb.com.br?key=SUA_CHAVE

Modelos compatíveis