Como instalar o Hotspot Social na Controller UniFi - 7.3.83 ou inferior

Este material procura orientar de forma clara e prática a instalação do Hotspot Social no UniFi Controller, garantindo que todos os passos sejam executados corretamente para o funcionamento da solução.

Antes de iniciar, destacamos alguns pontos importantes sobre compatibilidade, permissões e limitações específicas do ambiente UniFi. A partir daqui, você terá um guia completo para configurar sua rede com segurança e aproveitar todos os recursos do Hotspot Social.

IMPORTANTE:

• Ao usar o Hotspot Social com o UniFi Controller NÃO é gerado o LOG do Marco Civil. 
• Recomendamos que faça o backup das configurações do UniFi Controller antes de configurar o Hotspot Social.
• É necessário ter um servidor DHCP na rede.
• A revenda deve ter acesso completo (root ou administrador) ao servidor do UniFi Controller, pois será necessário inserir arquivos de configuração nos diretórios do UniFi Controller. 
• Os APs UniFi devem estar sempre conectados ao mesmo UniFi Controller que foi configurado o Hotspot Social.
• Não há bloqueio das redes sociais antes do usuário finalizar a conexão.
• Não é possível realizar a troca do SSID dos APs pelo painel do Hotspot Social, a troca deve ser realizada diretamente pelo UniFi Controller.
• Não é possível desconectar o usuário pelo Dashboard do painel do Hotspot Social.
• A autenticação dos usuários do Hotspot Social é realizada externamente em nossos servidores Radius.
• Para alterar a velocidade de conexão, é necessário configurar pela UniFi Network Controller, no menu "User Groups" e designar o uso dele em "Wireless Network".

Nas imagens do material foi utilizado a Unifi Network Controller versão 5.12.66.0, atualmente o Hotspot está homologado para funcionamento até a versão 7.3.83, instalado tanto em servidor Windows quanto em servidor Linux. 

Acesse o Controller e clique em Configurações (ícone de engrenagem na parte inferior do lado esquerdo)

Configuração do Sítio (Site)

1. Clique em Sítio
2. Insira o nome do Sítio, selecione o País e o Fuso Horário

Configuração da Rede Sem Fio

1. Clique em Rede Sem fio
2. Clique em + CRIAR NOVA REDE SEM FIO

Nas seções Editar Redes Sem Fio e Opções Avançadas.

1. Insira o nome do SSID
2. Ative a Rede sem fio
3. Em segurança selecione Aberto
4. Habilite Política de Convidado
5. Desabilite o Filtro Multicast e Broadcast

Configurar RADIUS

1. Clique em Perfis
2. Clique em + CRIAR NOVO PERFIL RADIUS

Na seção Editar Perfil Radius

1. Digite o Nome do Perfil
2. Insira os seguintes dados => IP: 40.70.60.221    Porta: 1812      Senha/Código Compartilhado: wmngr2761a3301
3. Habilite Contas ativas
4. Habilite Atualização provisória
5. Em Intervalo de atualização provisória insira o valor 60
6. Insira os seguintes dados => IP: 40.70.60.221    Porta: 1813      Senha/Código Compartilhado: wmngr2761a3301

Configuração do Controle de Convidados 

Na seção Políticas de Convidado

1. Selecionar o item, Control de convidados
2. Ativar Portal de Convidados
3. Escolher Hotspot como forma de Autenticação
4. O tempo de Expiração Padrão será o tempo de Sessão do Perfil de Conexão Padrão 
5. Selecionar a opção Redirecionar para o URL original
6. NÃO selecionar nenhuma opção de Redirecionamento

Na seção Personalização do Portal

1. Selecione AngularJS
2. Selecione Substituir modelos com alterações personalizadas

Nas seções Hotspot e Radius

1. Selecione Ativar a autorização baseada em RADIUS
2. Selecione o Perfil do Radius que foi criado anteriormente
3. Selecione CHAP

Na seção Controle de Acesso 

Adicione os endereços abaixo (um de cada vez) em Acesso Pré-Autorizado:

104.41.3.13
138.118.173.207
187.45.181.29
191.232.199.45
191.238.219.216
20.186.155.118
45.32.160.174
akamaihd.net
connect.facebook.net
facebook.com
fbcdn.net
accounts.google.com
googleapis.com
ssl.gstatic.com
hotspotsocial.xyz
linkedin.com
licdn.net
licdn.com
instagram.com
twitter.com
api.twitter.com
x.com
api.x.com 
twimg.com
loginwifi.live 
akadns.net
alphacdn.net
msedge.net
trafficmanager.net
microsoftonline.com
viacep.com.br 
doubleclick.net
edgekey.net 
akamaitechnologies.com
akamaiedge.net
apple.com.edgekey.net
akamai.com
wifimanager.azurewebsites.net
40.75.27.221/32
52.225.216.128/32
40.70.60.221/32
52.67.255.165/32
170.82.175.0/24
187.16.245.192/29
201.148.101.24/29
200.189.173.48/28
200.98.28.70/32
187.85.159.176/29
170.84.29.208/29
34.95.168.58/32
45.63.104.13/32
140.82.27.226/32
45.77.97.241/32
207.246.123.237/32
207.148.26.195/32
186.211.161.0/29
45.238.96.152/29
34.95.213.225/32
34.95.209.169/32
35.247.222.78/32
34.95.253.129/32
34.95.148.131/32
34.95.164.249/32
129.159.48.87/32
200.25.56.64/28
wifimanager.online
170.82.173.10/32
170.82.174.10/32
170.82.173.30/32 
170.82.174.30/32 
209.126.0.53/32
20.49.97.15/32
200.25.49.64/26
144.22.216.139/32
150.230.84.126/32

Em Controle de Acesso adicione os endereços abaixo (um de cada vez) em Restrições Pós-Autorização:

192.168.0.0/16
172.16.0.0/12
10.0.0.0/8

Cópia dos arquivos de configuração do Hotspot Social

Para cada licença do Hotspot Social para Unifi serão enviados 03 arquivos que deverão ser adicionados no Controller. 

• index.html
• signin.html
• WM_unifi.js

Os arquivos deverão ser adicionados no diretório referente ao sítio (site) onde estão vinculados os APs do Hotspot Social. 

Para saber qual o diretório correto é só seguir o procedimento abaixo:

• Acessar o Unifi Network Controller e escolher o sítio (site) onde estão vinculados os APs do Hotspot Social; 
• No navegador a URL irá mostrar qual é o código do site: https://SEUIPouDOMINIO.COM:8443/manage/site/CÓDIGODOSITE/dashboard

Por padrão o código do site é: default.

No exemplo abaixo, o site onde estão os meus APs é o Wifi Manager e o código do meu site é: 7kajnw9n

Em servidores Windows:

Os arquivos deverão ser copiados e/ou substituídos no seguinte diretório:

"Diretório onde está instalado o UniFi Controller"\data\sites\7kajnw9n\app-unifi-hotspot-portal

Veja que o diretório 7kajnw9n é o código do Site (sítio) do UniFi Controller que estou usando neste exemplo.

Em servidores Linux:

Para acesso SSH e para fazer a cópia dos arquivos (SFTP) recomendamos o programa Bitvise.

No exemplo abaixo o código do Site (sítio) do UniFi Controller é 1c8mbqij. É possível localizar no endereço de acesso no navegador.

• Os arquivos deverão ser copiados e substituídos no seguinte diretório: 

/usr/lib/unifi/data/sites/1c8mbqij/app-unifi-hotspot-portal/

• Agora é necessário alterar o usuário e grupo desses arquivos para "unifi" usando o comando abaixo como root:

chown unifi:unifi /usr/lib/unifi/data/sites/1c8mbqij/app-unifi-hotspot-portal/*

Pronto, sua instalação está finalizada e já pode se conectar no seu Hotspot Social 😁💪🏻.

Em caso de dúvidas, entre em contato com nosso time de suporte pelos canais de atendimento.