Passar para o conteúdo principal

Manual de integração - Omada Controller - API

Atualizado há mais de uma semana

Em cenários mais complexos com firewalls mais restritivos, podem haver problemas com a liberação via RADIUS do TP-Link Omada. Para contornar essa situação, implementamos um modelo de integração com a controladora via API, em que o WiFeed realiza a liberação diretamente na controller Omada, sem que o cliente precise enviar login e senha para autenticação via RADIUS.

Para configurar a integração da controladora Omada via API, siga os passos abaixo:



Etapa 01 - Configuração da rede Wireless

Já logado em sua controladora Omada e dentro do site que deseja configurar, acesse o menu "Configurações", localizado no canto inferior esquerdo e em seguida a opção "Wirelless Network > WLAN" para acessar o menu de configuração de redes WiFi.

Selecione o botão "Create New Wirelless Network" para adicionar uma nova rede, conforme ilustra a imagem abaixo:

Defina um nome de SSID, selecione as frequências que deseja operar essa rede, habilite a opção "Guest Network" e altere o "Security" para "None".


Aplique as configurações e avance para próxima etapa.

Etapa 02 - Configuração do Captive Portal

Ainda dentro do menu "Configurações" acesse a opção "Authentication > Portal" para acessar o menu de configuração do perfil de portal.

Em seguida, selecione a opção "Create New Portal" para adicionar um novo perfil de portal cativo, conforme ilustrado abaixo:


Preencha os campos solicitados:

  1. Portal Name: informe um nome de sua preferência para identificar esta configuração;

  2. Portal: deixe a opção habilitada;

  3. SSID & Network: selecione o SSID que os clientes irão utilizar (configurada na Etapa 01 );

  4. Authentication Type: selecione a opção External Portal Server;

  5. Custom portal Server: selecione a opção URL e informe o seguinte endereço:

    bigbox.wifeed.com.br/api/redirect/hs-omada-api

  6. HTTPS Redirection: deixe a opção habilitada;

  7. Landing Page: selecione a opção The Original URL.

Observação: A opção Authentication Timeout é irrelevante para a configuração, pois este parâmetro será definido dentro da plataforma WiFeed.


Etapa 03 - Configuração do Walled Garden

Nesta etapa é necessário liberar alguns domínios e subdomínios que o captive portal irá utilizar antes de liberar o cliente.

Para realizar essa configuração, no menu de configurações, clique no item Authentication > Portal e posteriormente na aba superior Access Control. Então habilite a opção Pre-Authentication Access e clique em "Add" para adicionar entradas a tabela.

Altere para URL e insira os domínios do WiFeed.


Domínios do WiFeed para pré liberação

  • bigbox.wifeed.com.br

  • api.wifeed.com.br

  • hs.portalwifeed.com.br


Etapa 4 - Configuração do usuário Omada para o uso da API

Como essa integração é realizada via API, é necessário criar um usuário na controladora para que o WiFeed consiga se comunicar.

Acesse a opção "Organization > Hotspot Manager" localizada no canto superior direito da tela:

Em seguida, selecione a opção "Operators > Create Operator" para criar um novo usuário.


Preencha os dados solicitados e clique em "Salvar" para seguir para a próxima etapa.


Etapa 05 - Cadastrando a controladora no WiFeed

Logado em sua conta do WiFeed, acesse o menu "Configurações > Locais" localizado no menu lateral ao lado esquerdo de sua tela.

Selecione a opção "Controladoras" localizada na parte superior de sua tela.

Observação: a opção de controladoras só está disponível para o usuário Master da conta.

Selecione a opção "Cadastrar nova controladora".

Selecione a opção "Omada Controller".


Preencha com os dados solicitados:

  1. Nome: Um nome apenas para identificação;

  2. Login: O usuário criado na controladora Omada;

  3. Senha: A senha gerada para o usuário da API na controladora Omada;

  4. Domínio: A URL que você usa para acessar a controladora, pode ser um IP também, caso não tenha um domínio configurado;

  5. Porta: A porta usada para acesso;

  6. Controller Site ID: Id de identificação da Controladora. ele pode ser Encontrado após o Domínio como no exemplo;

https://omada.wifeed.com.br/93ddecxxxxxca9xxxee15c8c0f868e015/login#hotspot



Sua configuração deve ficar dessa forma:



Por fim, utilize o botão "Testar" para validar se o WiFeed consegue se comunicar com sua controladora.









Respondeu à sua pergunta?