⚠️ ATENÇÃO ⚠️
Certifique-se que você atende todos os itens abaixo antes de iniciar.
|
Link para download da Controller: https://static.tp-link.com/upload/software/2024/202407/20240710/Omada_SDN_Controller_v5.14.26.1_Windows.zip
|
Estou pronto! Inicie aqui sua configuração ✅
Introdução
O WiFeed possibilita que os clientes que acessarem os pontos de acesso de determinada rede Wi-Fi passem por um processo de liberação antes de terem acesso à Internet. Esse processo irá identificar o cliente através de um cadastro e poderá apresentar um anúncio, propaganda ou questionamento antes da liberação do acesso. O conjunto de telas que o cliente irá visualizar referente a pesquisas e marketing é chamado de Campanha.
Então, em resumo, o cliente ao conectar em um Wi-Fi com o WiFeed configurado, deverá passar pelos seguintes passos:
Cadastro no WiFeed;
Aceite dos Termos de Uso;
Execução da Campanha (se habilitada);
Liberação do acesso.
Este tutorial irá mostrar como realizar a configuração da solução de captive portal do WiFeed no Omada Controller, a controladora da TP-Link. Essa configuração deverá ser realizada em 6 etapas:
Configuração da rede onde os clientes irão acessar o captive portal;
Configuração do servidor Radius que libera o usuário no final do processo de execução da Campanha;
Configuração do portal que direciona os clientes para o captive portal externo do WiFeed após conectarem no ponto de acesso;
Liberação dos domínios utilizados pela solução, que permite que os clientes ainda não liberados possam alcançar os serviços do WiFeed que estão na Internet;
Registro dos Pontos de Acesso na plataforma WiFeed, que autorizam os pontos de acesso a fazerem parte da solução e mostram para o WiFeed de onde estão vindo os acessos;
E por fim, o teste da solução, que descreve o passo a passo de um cliente ao conectar em um ponto de acesso configurado.
IMPORTANTE: Antes de seguir as etapas deste tutorial, você deverá ter acesso à plataforma WiFeed. A plataforma se encontra disponível no seguinte endereço:
https://system.wifeed.com.br
Resumo das configurações
Configuração da Wireless Network;
Configuração do Radius Server no Omada Controller;
Configuração do Captive Portal no Omada Controller;
Links de liberação (Walled Garden);
Entre na plataforma do WiFeed https://system.wifeed.com.br/locais;
Configurações > locais > Registrar um grupo > Adicionar Local >
Adicionar Aparelho do tipo TP-link Omada e inserir o Mac address da WAN no campo chave do aparelho;
Para testar você deve ser atentar somente ao teste na ponta, com um dispositivo celular ou notebook, você deve se conectar ao Wi-Fi e verificar a aplicação na tela.
Configuração completa
Etapa 1 - Configuração da Wireless Network
Primeiramente, é necessário definir uma rede wireless em que os clientes possam se conectar. Para isso, no menu de configurações, clique no item Wireless Networks e posteriormente no botão Create New Wireless Network.
No formulário de criação da Wireless Network será possível definir: o SSID, quais as frequências de Wi-Fi que serão utilizadas (2.4 e 5.8), o tipo de segurança no acesso e se a rede é ou não do tipo Guest.
Como a rede será aberta ao público, habilite a opção Guest Network e selecione None para a opção Security. A configuração ficará semelhante à imagem abaixo.
|
Aplique as configurações e vá para a próxima etapa.
Etapa 2 - Configuração do Radius Server no Omada Controller
No menu de configurações, clique no item Profiles > RADIUS Profile e posteriormente no botão Create New RADIUS Profile. Deixe a configuração como o exemplo abaixo:
|
Tabela com as informações necessárias:
Authentication Server IP: 52.67.22.243 |
Salve as configurações e vá para a próxima etapa.
Etapa 3 - Configuração do Captive Portal no Omada Controller
Na aba lateral, clique no item Authentication > Portal e posteriormente no botão Create New Portal. Altere os seguintes campos:
Portal Name: informe um nome de sua preferência para identificar esta configuração;
Portal: deixe a opção habilitada;
SSID & Network: selecione o SSID que os clientes irão utilizar (configurada na Etapa 1);
Authentication Type: selecione a opção RADIUS SERVER;
Radius Profile: selecione a configuração de Radius Server configurada na Etapa 2 deste tutorial;
Authentication Mode: CHAP
Portal Customization: selecione a opção External Web Portal e informe o seguinte endereço:
bigbox.wifeed.com.br/api/redirect?rt=hs-omada
|
HTTPS Redirection: deixe a opção habilitada;
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.
|
Exemplo da tela de configuração do captive portal
Etapa 4 - Liberação dos domínios de pré-liberação
Nesta etapa é necessário liberar alguns domínios e subdomínios que o captive portal irá utilizar antes de liberar o cliente. Caso esses domínios não sejam desbloqueados, haverá problemas no login via Facebook e também no acesso ao próprio captive portal do WiFeed.
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.
Observe que agora será possível incluir entradas na tabela de liberação clicando no botão Add.
Na janela que será apresentada, é necessário selecionar a primeira opção como URL e informar qual domínio será liberado como mostrado no exemplo abaixo.
|
Exemplo de inclusão de domínio no Access Control
Inclua os seguintes domínios:
⚠️Observação: O WiFeed funcionará com suas próprias URLs liberadas. No entanto, para que algumas funcionalidades adicionais funcionem corretamente, é necessário liberar também as URLs específicas desses serviços. |
URLs para liberação do WiFeed
|
URLs para liberação do Facebook
|
URLs para liberação do Linkedin
|
URLs para liberação do X (Twitter)
|
URLs para liberação do Yotube
Observações: caso seu equipamento não aceitar * (asterisco) você pode remove-lo! |
URLs para liberação do Google Workspace
|
URLs para liberação do Active Directory (Azure)
Observações: caso seu equipamento não aceitar * (asterisco) você pode remove-lo! |
Etapa 5 - Configuração dos pontos de acesso na plataforma WiFeed
Na tela de gerenciamento de Locais, será possível criar Locais, Grupos de Locais, Pontos de Acesso e Grupos de Pontos de Acesso, sendo que um Ponto de Acesso deverá sempre estar dentro de um Local. Já os grupos são uma forma de organizar todos esses registros.
5.1. Cadastro do Local
Um local é um ambiente físico onde os pontos de acesso serão instalados. Ele pode ser um hotel, um supermercado ou um restaurante por exemplo. Ao cadastrar um local podemos definir um nome para identificá-lo dentro da plataforma e definir o tempo de conexão, que será o tempo que o usuário poderá utilizar a internet após a liberação no captive portal, além disso deve-se informar os dados referentes ao endereço.
Para criar um local:
Entre na plataforma do WiFeed https://system.wifeed.com.br;
localize no menu a esquerda Configurações;
Clique em Configurações e em seguida locais https://system.wifeed.com.br/locais;
| 
|
4. Clique no botão Registrar Local na parte superior da tela.
Uma nova janela será aberta permitindo definirmos algumas informações sobre o local.
|
Tela de cadastro de Local
Preencha as informações, salve o registro e ative o local na listagem.
Tempo de conexão: É o tempo em que o usuário ficará conectado até encerrar o tempo programado, ao final deste tempo a conexão é interrompida e inicia-se um novo ciclo;
Tempo para próximo acesso: É o tempo em que o usuário ficará bloqueado até poder iniciar um novo acesso, utilize somente em casos que deseja bloquear os usuários por um tempo.
Fuso horário: Utilizado somente em casos onde o fuso é diferente;
Somente maiores de 18: Bloqueio de rede para menores de 18 anos;
Salve o registro e Ative o local na listagem.
5.2. Cadastro do Ponto de Acesso
O ponto de acesso é o equipamento que irá permitir os clientes acessarem o captive portal e visualizarem os anúncios veiculados para posteriormente terem acesso a Internet. Mas antes de realizar o teste de acesso é necessário registrar os pontos de acesso na plataforma. Ao registrar um ponto de acesso você está informando à plataforma WiFeed que este equipamento poderá realizar requisições para a plataforma. Então é importante registrar todos os pontos de acessos instalados.
Para cadastrar um ponto de acesso, ou Aparelho como é chamado dentro da plataforma WiFeed, vá até um registro de Local e clique no ícone de soma ( + ) e depois na opção Novo Aparelho, como mostrado na imagem abaixo:
Na janela do cadastro defina um nome para o Aparelho, selecione Omada Controller no campo Tipo de Aparelho e informe no campo Chave do Aparelho o MAC Address do Ponto de Acesso.
IMPORTANTE: Verifique se o MAC Address informado é realmente o MAC Address do Ponto de Acesso. É possível encontrar essa informação tanto no próprio equipamento, quanto na lista de Devices do Omada Controller. Lembrando que o MAC Address deve estar no formato 00:00:00:00:00:00.
Preencha as informações e salve o registro.
5.3. Configuração do Ponto de Acesso na Plataforma
Após cadastrar o aparelho, na listagem de aparelhos, clique no botão de Configurações Avançadas.
Na janela que irá aparecer, será necessário informar a porta de comunicação com a controladora e também desativar o SSL.
|
Provavelmente o SSL já estará ativo, portanto desative e verifique a porta que está sendo utilizada na controladora. Para obter essa informação, no menu de configurações da controladora, vá em Controller. Na seção Access Config, o número da porta está no campo HTTP Port for Portal.
|
Etapa 7 - Testando a solução
Com a controladora configurada e os pontos de acesso registrados na plataforma é hora de conectar no Wi-Fi e ver se está tudo funcionando corretamente.
Ao conectar, o ponto de acesso deverá direcionar você para o captive portal, apresentando a seguinte tela caso você não seja um usuário cadastrado:
|
Caso você não seja um usuário cadastrado ao se conectar ao ponto de acesso você deverá ser direcionado para o captive portal, apresentando tela de cadastrado ou tela de login, ao final do cadastro e do aceite do termo de uso você irá ser redirecionado para a sua primeira campanha.
Caso você seja um usuário cadastrado, você irá ser redirecionado para a sua primeira campanha.
Pontos importantes:
O cadastro é único na rede do WiFeed, independente do local;
A tela de cadastro é apresentada somente no primeiro acesso;
As campanhas aparecerão apenas após o cadastro;
Todos os acessos possuem um tempo de conexão, ele é definido em locais, clique aqui e veja como editar;
As telas de cadastro são personalizadas, clique aqui e veja como personalizar;
Caso queira visualizar o tempo restante de conexão, poderá ir até o menu Conexões, na plataforma WiFeed, para ver a lista de usuários liberados pela plataforma.
|
Principais Erros
A seguir são apresentados alguns erros que podem ocorrer durante o processo de instalação.
ERRO 1 - Code: 200 - Aparelho desativado no WiFeed
Registro de unidade AP não encontrado ou desativado
 |
Possíveis Causas:
O Aparelho Intelbras não foi cadastrado no WiFeed (nome e mac address);
O local onde o aparelho está cadastrado no WiFeed está desativado;
|
Resolução: Ativar o local ou se o local não existe mais, refazer o processo de configuração;
ERRO 2 - Code: SD1 - Possível bloqueio de Firewall
O captive portal entra em loop e o cliente não é liberado, apresenta-se no canto inferior esquerdo o código SD1. Este erro pode estar associado a senha incorreta do Radius ou a alguma instabilidade da rede no momento da liberação.
 |
Possíveis Causas:
Senha do Radius incorreta, revise a configuração do Radius;
Bloqueio do IP do Radius por um firewall na rede;
Bloqueio das portas 7564 ou 4657 por um firewall na rede.
Resolução: Verificar se existe algum serviço de Radius bloqueando 7564 ou 4657 por um firewall na rede.
ERRO 3 - Tela branca - Falha de comunicação
| 
|
O captive portal entra em uma tela branca e não avança no processo de liberação.
Possíveis Causas:
Falha de comunicação entre controladora e WiFeed;
AP com problemas de comunicação;
Ausencia das URLs do Walled Garden;
Resolução: Verificar se existe alguma falha de comunicação na rede, sem internet ou algo relacionado a rede ou dispositivo que provê a internet ou DHCP.
Verificar no teste do WiFeed a comunicação entre Controladora e WiFeed.
Verifique as URLs de liberação.
Verificar em alguns versões se a comunicação entre AP e controller está correta em relação às configurações de acesso.
Desativar a atualização automática de IP
Inserir o hostname/IP e o nome do anfitrião do Portal com a mesma informação, o IP ou domínio da controladora.
Considerações Finais
Como foi visto, a configuração da solução WiFeed é realizada tanto na plataforma, quanto na rede do estabelecimento que irá disponibilizar Wi-Fi para seus clientes.
E é normal ocorrer alguns problemas até deixar a solução funcionando corretamente. Isso porque esta solução na verdade depende de outras soluções. Depende do ponto de acesso ser integrado, depende do smartphone permitir a identificação de um captive portal em uma rede pública, depende da rede do estabelecimento estar corretamente configurada, entre outros fatores que podem interferir na solução, como firewalls e proxies.
Mas caso você tenha problemas para realizar esta configuração, entre em contato com nossa central de atendimento que iremos ajudá-lo.