Antes de começar
Este guia é para quem tem a própria controladora UniFi, versão 8 ou superior (UniFi Network 8+, UDM, UDM-Pro, CloudKey ou controladora em nuvem), no modelo UniFi API. A configuração é manual: aqui não há autoconfiguração.
Controladora versão 4 a 7? Use o artigo UniFi RADIUS (Legacy) — configurar a controladora. Não tem controladora? Veja Controladora UniFi da plataforma — passo a passo.
Como funciona: o visitante faz login no portal e o servidor libera a internet chamando a sua controladora. Por isso ela precisa estar alcançável pela internet: IP público com a porta liberada, ou controladora hospedada em nuvem. Os modelos UniFi só aparecem na lista quando a opção UniFi está ligada no sistema.
Tenha em mãos:
- o endereço da controladora, com a porta (exemplo:
https://controladora.exemplo.com:8443); - um usuário com permissão de administrador do site e a senha dele;
- o nome do site (geralmente
default) e a versão da controladora.
No painel
- Em Hotspots, clique em Configurar Novo Hotspot.
- Preencha Nome Fantasia e Local.
- Em Modelo, escolha UniFi API (pode aparecer como UniFi Controller (API)).
- Site: o nome do site na controladora.
- Tempo de Conexão (minutos): quanto tempo o visitante fica liberado.
- Debug: deixe em Desabilitar, salvo se o suporte pedir.
- URL, Usuário e Senha: os da controladora.
- Versão: a versão da controladora (exemplo:
8.0.24). - Velocidade Download e Velocidade Upload (kbps) e Limite de Usuário (MB): opcionais.
- Clique em Testar Conexão UniFi API. Só siga se der certo.
- Clique em Criar Hotspot.
Depois, abra o hotspot em Editar → aba Guia de Instalação e clique em Gerar Instruções. O texto traz a URL do portal deste hotspot e a lista de endereços para liberar antes do login. Não há arquivo para enviar à controladora. Baixar Instruções salva o texto.
No equipamento
Na sua controladora UniFi:
- Vá em Settings → WiFi e selecione a rede dos visitantes (ou crie uma, aberta).
- Em Guest Hotspot, ative Guest Portal.
- Tipo: External Portal Server. Informe a URL das instruções.
- Ainda em Guest Hotspot, em Pre-Authorization Access, inclua todos os endereços da lista das instruções. O domínio de login é obrigatório: sem ele o portal não abre.
- Salve e aplique.
Confira que o servidor alcança a controladora: é ele quem libera o visitante. Se a controladora está só na rede local, ela precisa ficar acessível de fora (porta liberada ou VPN), ou use o modelo UniFi via Conector, quando ele aparecer na lista.
Testar
- Conecte um celular na rede dos visitantes.
- O portal deve abrir sozinho. Faça o login.
- A internet deve liberar pelo tempo configurado.
Problemas comuns
| Sintoma | O que fazer |
|---|---|
| O modelo UniFi não aparece na lista | A opção UniFi está desligada no sistema: fale com o suporte |
| O teste de conexão falha | Confira URL com porta, usuário, senha e se a controladora é alcançável pela internet |
| O portal não abre | Guest Portal desligado, rede errada, ou domínio de login fora do Pre-Authorization Access |
| Login aceito, internet não libera | O servidor não alcança a controladora, o usuário não é administrador do site, ou o Site está errado |
| Controladora versão 7 ou anterior | Use o modelo UniFi RADIUS (Legacy) |