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 Unifi Controller, a controladora do Unifi da Ubiquiti Networks.
⚠️ ATENÇÃO ⚠️
Certifique-se que você atende todos os itens abaixo antes de iniciar.
👉 Acesso Plataforma do WiFeed system.wifeed.com.br;
👉 Você possui uma controladora Unifi, instalada em uma máquina virtual ou servidor dedicado, acessível externamente;
👉 Os Access Poins estão adotados e funcionais dentro da controladora;
Versões suportadas: 6.x, 7.x, 8.x, 9.x e 10.x
Etapa 1 - Configuração da comunicação entre WiFeed e controladora
Diferente do restante das integrações do WiFeed, a integração com Unifi é realizada via API, e para que ela funcione corretamente, é necessário que a plataforma do WiFeed se comunique diretamente com sua controladora, o primeiro passo que vamos executar para garantir essa comunicação, é a criação de um usuário local para o WiFeed na controladora.
Observação: Os diferentes modelos e versões de controladora, podem trazer a etapa de criação de usuário de formas diferentes, garanta que está criando um usuário com restrição de acesso local, o usuário via e-mail, que depende de duplo fator de autenticação NÃO vai funcionar, pois a API não consegue fazer validação de e-mail.
1.1 - Criação do usuário de acesso do WiFeed na controladora.
Ao acessar sua controladora, localize no menu lateral do lado esquerdo da tela, a opção (1)Admins, em seguida, selecione o botão de (2)+ localizado no canto superior direito de sua tela.
Desabilite a opção (1)Remote Acess e preencha as informações de (2)Username e (2)Password.
Logo após realizar a criação do usuário, clique para editá-lo novamente, e altere a permissão para Administrador, isso facilita, para o caso de existir mais de um site na controladora.
1.2 - Cadastro da controladora no WiFeed.
Depois de finalizara a criação do usuário, você precisa cadastrar a sua controladora dentro do portal do WiFeed, para realizar essa operação realize o login no sistema através do link https://system.wifeed.com.br.
Depois de logar no sistema, acesse o menu (1)Configurações > (2)Locais > (3)Controladoras > (4)Cadastrar nova controladora.
Selecione seu tipo de controladora:
Unifi Software: Controladoras software instaladas em máquinas virtuais ou servidores dedicados.
Unifi OS: Appliances físicos da Unifi como UDMs, USG, Cloud Key, etc.
Selecione de acordo com o modelo de controladora que você utiliza.
Preencha os campos conforme solicitado:
(1)Nome: Nome de identificação da sua controladora dentro do sistema, serve para se localizar caso tenha mais de uma.
(2)Login: usuário de acesso local criado na Etapa 01;
(3)Senha: senha de acesso criada na Etapa 01;
(4)Domínio: Endereço IP EXTERNO ou domínio de acesso a sua controladora;
(5)Porta: Porta de acesso de sua controladora, geralmente em controladora software porta 8443, controladora física 443;
(6)Domínio Failover: Endereço IP EXTERNO ou domínio de backup, é utilizado principalmente nos equipamentos físicos que recebem mais de um link em suas WANs;
(7)Porta Failover: Porta de acesso no IP ou domínio de backup.
Depois de preenchidos todos os campos, clique no botão (8)Testar para validar a comunicação entre WiFeed e controladora.
Se o teste for enviado com sucesso, pode seguir para os próximos passos, se o teste não funcionar, verifique:
As credenciais criadas para o WiFeed;
Se a porta de acesso a controladora está liberada para os IPS do WiFeed
Observação: Para que sua controladora se comunique com o sistema do WiFeed é obrigatório que você libere acesso externo ao equipamento, via IP público, redirecionamento de porta (NAT) ou DDNs.
Para garantir a segurança, você pode restringir esse acesso externo somente aos endereços do WiFeed, abaixo estão listados todos eles.
Faixas de IP da plataforma WiFeed:
20.206.88.5/32
20.226.59.142/32
20.206.107.132/32
144.22.239.52/32
167.234.243.166/32
167.234.237.18/32
144.22.198.172/32
146.235.50.104/32
129.148.27.103/32
167.234.238.167/32
164.152.63.13/32
167.234.232.193/32
152.67.48.34/32
FQDN:
bigbox.wifeed.com.br
api.wifeed.com.br
hs.portalwifeed.com.br
Etapa 2 - Configuração do perfil de captive portal na controladora Unifi
Depois de garantir que sua controladora está se comunicando com o WiFeed, é hora de configurar as informações necessárias para o funcionamento do redirecionamento para o portal.
Para isso, dentro de sua controladora Unifi, acesse o menu (1)Configurações > (2)WiFi e crie ou caso já exista (3)edite a sua rede WiFi.
Dentro da rede WiFi, habilite a opção (1)Hotspot e selecione o hotspot type (2)Captive portal e clique na opção (3)Hotspot Portal descrita em azul na mensagem de aviso.
Quando selecionar a opção (3)Hotspot Portal, caso ainda não tenha salvo, a controladora vai te trazer uma mensagem informando que você possui configurações não salvas, e se mudar de página elas serão perdidas, pode clicar em Sair sem salvar ou simplesmente salvar as configuração feita na rede antes de entrar no perfil de hotspot portal.
Dentro do perfil de portal, selecione o método External Portal server, e preencha com o endereço IP 167.234.243.166, em seguida, salve e avançe.
Seguindo a configuração preencha os seguintes campos:
Desmarque a opção HTTPs Redirection Support;
Desmarque a opção Encrypted URL;
Marque a opção Secure Portal;
Marque a opção Domain;
Preencha o domain com o domínio bigbox.wifeed.com.br;
Preencha o Pre-Authorization com os domínios do WiFeed;
Domínios para liberação do WiFeed
|
Preenchidos todos os campos, sua configuração de portal está concluída.
Observação: Essa configuração é realizada a nível de site, se mudar o site dentro da controladora ela deverá ser feita novamente no novo site.
Etapa 3 - Configuração dos pontos de acesso na plataforma WiFeed
Ao logar na plataforma, utilize o menu do lado esquerdo da tela para navegar nas opções.
Entre em Configurações > Locais.
Nessa tela você conseguirá visualizar suas segmentações de grupos de locais e locais dentro da plataforma.
3.1. Cadastro do Local
Os locais dentro do WiFeed referem-se aos ambientes físicos onde os pontos de acesso Wi-Fi serão instalados, como hotéis, praças, bares e restaurantes. Ao cadastrar um local, você deverá informar todas as informações de endereço desse ponto (CEP, rua, número, estado, cidade etc.).
Você também poderá personalizar as configurações de tempo de conexão e de bloqueio, dentre outras personalizações.
Para adicionar um novo local, você pode utilizar o botão Registrar Local no topo da página , ou do lado direito da tela, no grupo de locais, poderá utilizar o botão de ( + ) para adicionar um novo local dentro daquele grupo.
Uma nova janela será aberta permitindo definirmos algumas informações sobre o local.
Preencha as informações, salve o registro e ative o local na listagem.
3.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.
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 adição ( + ) e depois na opção Novo Aparelho, como mostrado na imagem abaixo.
Na janela do cadastro defina um nome para o aparelho, no campo Tipo de Aparelho selecione Unifi - API Ubiquiti e informe no campo Chave do Aparelho o MAC Address do dispositivo.
IMPORTANTE: Verifique se o MAC Address informado é realmente o MAC Address do Ponto de Acesso. É possível encontrar essa informação no próprio equipamento ou na lista de devices da controladora. Lembrando que o MAC Address deve estar no formato 00:00:00:00:00:00.
Preencha as informações e salve o registro.
Etapa 4 - 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:
O próximo passo é realizar o login no captive portal caso já possua um email cadastrado, ou caso contrário, realizar um novo cadastro.
Continue o teste realizando o cadastro e aceitando os Termos de Uso como mostrado nas telas abaixo:
Após o aceite dos Termos de Uso, caso exista uma campanha vinculada ao local, você deverá vê-la; caso contrário, será liberado no captive portal e poderá navegar na internet.
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.
Considerações Finais
A configuração da solução WiFeed é realizada tanto na plataforma quanto na rede do estabelecimento que oferece Wi-Fi aos clientes.
Em alguns ambientes, podem ocorrer problemas durante o processo de implantação, pois a solução do WiFeed depende do comportamento de outras soluções e componentes de rede (firewalls, proxies).
Caso você encontre problemas ou tenha dificuldades durante o seu processo de configuração, entre em contato com nossa central de atendimento.