Tutorial de Configuração do Captive Portal do WiFeed no RouterOS

Manual de Integração Versões Compatíveis Todas as versões acima da versão 6450 Introdução O WiFeed possibilita que os clientes que acessarem os pontos de acesso de determinada rede WiFi 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 WiFi com o WiFeed configurado deverá passar pelos seguintes passos 1 Cadastro no WiFeed 2 Aceite dos Termos de Uso 3 Execução da Campanha se habilitada 4 Liberação do acesso Este tutorial irá mostrar como realizar a configuração da solução de captive portal do WiFeed no RouterOS o sistema operacional da Mikrotik Essa configuração deverá ser realizada em 4 etapas 1 Registro do RouterOS na plataforma WiFeed que autoriza o RouterOS a fazer parte da solução e mostra para o WiFeed de onde estão vindo os acessos 2 Geração do Script de Instalação onde deverão ser informados quais os parâmetros para a execução do script como interfaces e endereço IP 3 Execução da Instalação é a etapa onde o script gerado no passo anterior é executado habilitando o hotspot no RouterOS e alterando algumas configurações para que o mesmo funcione corretamente com a plataforma WiFeed 4 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 Também será apresentada uma listagem com os erros mais comuns que podem acontecer durante o processo de instalação do WiFeed no RouterOS IMPORTANTE Antes de seguir as etapas deste tutorial você deverá ter acesso a plataforma WiFeed A plataforma se encontra disponível no seguinte endereço httpssystemwifeedcombr 2 Etapa 1 Registro do RouterOS na plataforma WiFeed Ao logar na plataforma clique no seu avatar no canto superior direito da tela e posteriormente clique em Configurações Na próxima tela clique no botão Locais Tela de Configurações Na tela de configuração 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 É importante entender que a integração com o RouterOS é diferente das demais pois não será necessário realizar o cadastro de todos os Pontos de Acesso de sua rede mas sim apenas do RouterOS que irá gerenciar seus clientes do hotspot em determinado local O ponto negativo da integração via Mikrotik é que ela não permite a segmentação das campanhas em nível de Ponto de Acesso apenas a segmentação por locais Isso porque o RouterOS irá funcionar como um concentrador para todas as conexões vindas dos Pontos de Acesso Então para registrar o RouterOS será necessário cadastrar um local e posteriormente um Ponto de Acesso Aparelho que irá representar o RouterOS dentro da plataforma WiFeed 3 11 Cadastro do Local Um local é um ambiente físico onde os pontos de acesso serão instalados No caso da integração com o RouterOS haverá apenas um Ponto de Acesso dentro do Local O Local pode ser um hotel um supermercado ou um restaurante por exemplo Ao cadastrálo podemos definir um nome que identifique este local dentro da plataforma 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 e informar os dados referentes ao endereço Para criar um local 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 4 12 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 como foi mencionado anteriormente neste caso o Ponto de Acesso será o Mikrotik que irá centralizar as conexões dos pontos de acesso Também é importante lembrar que nesse cenário onde o Mikrotik atua como um concentrador para o hotspot os Pontos de Acesso devem estar configurados em modo Bridge 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 Mikrotik no campo Tipo de Aparelho e clique no botão Salvar Tela de cadastro de Aparelho O próximo passo é informar as configurações de rede nas configurações avançadas do aparelho para que o sistema consiga gerar o script de instalação 5 Etapa 2 Gerando o script de instalação Para facilitar o processo de instalação a plataforma irá gerar um script que poderá ser importado e executado pelo RouterOS 21 Configurações Avançadas Antes de gerar o script é necessário informar os dados da rede onde os clientes do hotspot irão conectar Para isso na tela de Gerenciamento de Locais no registro do Aparelho clique no botão Configurações Avançadas Botão Configurações Avançadas Todos os dados obrigatórios nas configurações avançadas serão utilizados para a geração do script de instalação qualquer erro no preenchimento pode resultar em um script inválido Porém sempre é possível a correção das informações e a geração de um novo script de instalação A tabela abaixo mostra todas as informações necessárias para o preenchimento das configurações avançadas Os dados obrigatórios estão com o asterisco vermelho e o restante são informações utilizadas para fins de suporte ou funcionalidades extras da plataforma Seção Conexão Limite de Banda UploadDownload Define um limite de consumo de banda por usuário Seção Rede Endereço IP É o IP que será atribuído na interface LAN que será a interface por onde os clientes irão se conectar ao RouterOS Máscara de Rede É a máscara de rede que será atribuída ao endereço IP configurado no parâmetro anterior Faixa de IP É a faixa que será atribuída ao pool de IPs do DHCP server Servidores DNS São os servidores DNS que serão setados nos clientes através do DHCP 6 Seção Mikrotik Porta da API Porta utilizada para comunicação com a API Porta do SSH Porta utilizada para comunicação SSH Porta do Winbox Porta utilizada para acesso via Winbox Usuário Suporte Usuário utilizado para acesso de suporte pela equipe do WiFeed Senha Suporte Senha utilizada para acesso de suporte pela equipe do WiFeed Interface WAN Interface de saída para a Internet Interface LAN Interface por onde os clientes irão se conectar ao RouterOS Virtual LAN Número da VLAN utilizada na interface LAN informação para suporte Possui DHCP Client Define se a Interface WAN obter IP através de um DHCP Client ativo ou IP Estático desativado A imagem abaixo mostra um exemplo de como os campos das configurações avançadas são preenchidos Configurações Avançadas Aparelho Salve as configurações e vá para o próximo passo 7 22 Baixando o script de instalação No registro de Aparelho clique no botão Baixar arquivos de configuração Botão Baixar arquivos de configuração Após baixar o arquivo zip descompacte o mesmo em um diretório de sua preferência O arquivo descompactado deve ter os seguintes arquivos Arquivo configuracao compactado Arquivo configuracao descompactado 23 Entendendo os scripts Cada arquivo do configuracaozip tem uma função na instalação setup É um script que irá Criar o acesso de suporte para a equipe WiFeed com o usuário e senha informados nas configurações avançadas Criar a regra de default NAT Masquerade para a interface informada no parâmetro Interface WAN Alterar a identificação do RouterOS para o nome do Aparelho informado na plataforma Criar o DHCP Client na interface informada no parâmetro Interface WAN caso o parâmetro Possui DHCP Client for habilitado E por fim irá criar um VPN Client do tipo OVPN para a rede de suporte do WiFeed O script de setup é utilizado normalmente quando o roteador Mikrotik não possui nenhuma configuração ou para criar a VPN de suporte se necessário 8 autoconfig É o principal script da configuração pois irá Criar o Radius Client que auxiliará no processo de liberação do cliente Atribuir o IP na interface LAN Criar o servidor de DHCP para a interface LAN Criar o Hotspot Server com os parâmetros corretos para executar o captive portal Configurar o Walled Garden para permitir que os clientes bloqueados alcancem a plataforma WiFeed e consigam realizar o cadastro e visualizar as campanhas Criar alguns scripts para monitorar alguns serviços da solução WiFeed revertconfig Este script irá reverter todas as configurações criadas pelo script autoconfig com exceção do registro de RADIUS Client Caso seja necessário remover a RADIUS Client essa remoção deverá ser feita manualmente wifeed diretório Este diretório contém alguns arquivos do hotspot e também o arquivo que será responsável por direcionar o cliente para a plataforma WiFeed após o mesmo obter um IP do DHCP Server Etapa 3 Executando a instalação Antes de executar o script recomendamos ativar o Safe Mode Isso irá garantir que você não perca o acesso ao roteador em caso de execução do script com parâmetros incorretos Para ativar o Safe Mode no RouterOS clique no botão Safe Mode no canto superior esquerdo Safe Mode Desativado Safe Mode Ativado 9 Ainda no RouterOS clique no item Files e copie o arquivo autoconfig para dentro da pasta flash Caso não exista a pasta flash podese copiar diretamente para o File List File List do RouterOS Agora para executar o arquivo clique em New Terminal e utilize o comando import A sintaxe do comando import é a seguinte import localondeestaoscript Exemplo do comando import Dica Use a tecla tab para autocompletar o comando Após executar o script você deverá visualizar a seguinte mensagem Observação Para executar os script revert ou setup o procedimento é o mesmo 10 O próximo passo é copiar a pasta wifeed que estava dentro do arquivo zip baixado da plataforma para dentro da pasta flash do RouterOS Lembrando novamente que caso não exista a pasta flash podese copiar diretamente para o File List Configuração da pasta wifeed no File List IMPORTANTE Caso você tenha ativado o Safe Mode desative o mesmo para que as configurações sejam salvas após você sair do RouterOS caso contrário o RouterOS irá voltar para as configurações anteriores ao momento que você ativou o Safe Mode 11 Etapa 4 Testando a solução Com a controladora configurada e os pontos de acesso registrados na plataforma é hora de conectar no WiFi 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 É importante lembrar aqui que caso você opte por realizar o login ou cadastro via Facebook e ocorra algum problema no carregamento da página é possível que você tenha esquecido de liberar algum domínio no Access Control da Etapa 4 12 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 você 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 13 Também é possível visualizar os usuários liberados no RouterOS clicando em IP Hotspot e depois indo na aba Active RouterOS Listagem de usuários liberados no Hotspot Erros comuns A seguir são apresentados alguns erros que podem ocorrer durante o processo de instalação 1 Nome errado das interfaces Na Etapa 2 na seção 21 o nome da interface deve ter o mesmo nome da interface existente no RouterOS respeitando letras maiúsculas e minúsculas case sensitive Por exemplo na imagem abaixo o nome da interface informada no parâmetro Interface LAN das configurações avançadas do aparelho é diferente do nome que está na listagem de interfaces do RouterOS Parâmetro informado incorretamente vlanClientes vlanclientes 14 Caso o script seja executado com o nome da interface errado será visualizado o seguinte erro na Etapa 3 Resolução Corrija o nome da interface no RouterOS e execute o script novamente Ou então altere o nome da interface na plataforma WiFeed e gere novamente o script 2 IP já atribuído na interface LAN Caso a interface LAN já tenha o endereço IP atribuído será visualizado o seguinte erro na Etapa 3 Resolução Remova o IP da interface e se caso existir um DHCP Server vinculado a interface também removao 3 Network já existente no DHCP Server Caso já exista a mesma rede que será utilizada pelos cliente na aba Networks do DHCP Server o seguinte erro será visualizado ao executar o autoconfig Resolução Remova o registro da listagem de Networks do DHCP Server 4 Pasta wifeed fora da pasta flash Se no File List do RouterOS existir a pasta flash é importante que a pasta wifeed seja movida para dentro dela Lembrando que a pasta wifeed é aquela que vem dentro do arquivo configuracaozip baixado na Etapa 2 na seção 22 Caso a pasta wifeed não esteja no local correto no File List a seguinte tela será exibida na Etapa 4 15 Tela padrão do hotspot do RouterOS Resolução Mova a pasta wifeed para dentro da pasta flash como ilustrado abaixo Configuração errada Configuração correta 5 Falta da regra de NAT masquerade para a rede dos clientes ou bloqueio dos domínios do WiFeed por um firewall externo É importante que os clientes bloqueados tenham acesso aos servidores do WiFeed para que os mesmos consigam visualizar o captive e passem pelo processo de liberação Então qualquer regra que limite ou bloqueie esse acesso fará com que o captive não seja exibido corretamente Caso isso aconteça o cliente ficará preso na seguinte tela 16 Normalmente o que ocasiona o erro é a falta da regra de NAT masquerade para a rede dos clientes mas também pode ser um firewall bloqueando algum domínio que a plataforma utiliza Resolução Criar a regra de NAT masquerade com o comando abaixo ip firewall nat add chainsrcnat srcaddress101010024 outinterfaceether1 actionmasquerade Nota No exemplo acima a rede dos cliente é 101010024 e a Interface WAN é ether1 Liberar no Firewall os seguintes domínios bigboxwifeedcombr apiwifeedcombr hsportalwifeedcombr graphfacebookcom connectfacebooknet wwwfacebookcom staticxxfbcdnnet radiusbr1wifeedcombr Nota Os domínios do Facebook devem ser liberados para que o login via Facebook funcione corretamente 17 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 WiFi 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 que neste caso é o RouterOS 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 18