Documentação · UniFi
Configurar o UniFi
O UniFi envia os visitantes para o portal do Alpha HotSpot pelo recurso External Portal Server. Depois do cadastro, a liberação é feita pela API do seu controlador. O painel mostra os valores exatos para preencher.
Os nomes dos menus podem variar entre versões do UniFi Network. Os valores (hostname, IP e lista de liberação) aparecem no painel em Rede › UniFi › Configurações do portal.
1. Antes de Começar
- Acesso de administrador ao controlador UniFi Network (console, Cloud Key ou servidor próprio).
- No painel do Alpha HotSpot, cadastre o controlador e o site UniFi, com um usuário de API dedicado. É por ele que o Alpha HotSpot autoriza os visitantes após o cadastro.
2. Rede de Convidados e VLAN
Crie uma rede de convidados com VLAN própria, separada da rede interna, e um SSID de visitantes associado a ela.
- Em Networks: nova rede com VLAN dedicada (por exemplo, VLAN 50) e isolamento de convidados ativado.
- Em WiFi: SSID de visitantes usando essa rede, com Hotspot (ou Guest Hotspot) habilitado.
3. DHCP e DNS
Use DHCP na rede de convidados com lease curto (por exemplo, 1 hora) e um DNS que resolva o hostname do portal. O redirecionamento depende de o visitante conseguir resolver esse nome antes do login.
4. External Portal Server
Nas configurações do Hotspot (Hotspot Manager / Portal), escolha autenticação por External Portal Server e preencha com os dados do painel:
- Endereço do portal: o hostname (ou IP) informado pelo painel. O endereço segue o formato
https://<host>/guest/s/<site>/. - Use Secure Portal: ative para o portal abrir em HTTPS.
- Redirect using hostname: ative e informe o mesmo hostname.
Com domínio próprio verificado no painel, a empresa é identificada pelo endereço do portal, sem depender apenas do MAC do AP.
5. Liberação Antes do Login
Em Pre-Authorization Allowance, adicione os endereços listados no painel. Eles são o equivalente ao walled garden: o portal e os serviços necessários ao cadastro ficam acessíveis antes da autenticação.
6. Sincronizar APs
No painel do Alpha HotSpot, use Sincronizar APs para importar os access points do controlador e vinculá-los às unidades. Assim cada conexão é atribuída à empresa e unidade corretas.
7. Teste
- Conecte um celular ao SSID de visitantes: o portal do Alpha HotSpot deve abrir.
- Faça um cadastro de teste. Após o envio, o Alpha HotSpot autoriza o dispositivo pela API do controlador e a internet é liberada.
- Confira no painel a sessão registrada e, no UniFi, o cliente autorizado na lista de convidados.
Se o portal não abrir, verifique o DNS da rede de convidados, a lista de liberação antes do login e se o HTTPS do portal está acessível a partir da VLAN de visitantes.
Pronto para Configurar?
Crie sua conta: o painel gera a configuração com os dados reais da sua rede.