UniFi RADIUS (Legacy) — configurar a controladora

Antes de começar

Este guia é para o modelo UniFi RADIUS (Legacy), para controladoras UniFi da versão 4 a 7. A liberação é feita pelo navegador do visitante, dentro da sua rede: o servidor não precisa alcançar a sua controladora. Os modelos UniFi só aparecem na lista quando a opção UniFi está ligada no sistema.

Controladora versão 8 ou superior? A partir da 8.0.24 a interface Legacy saiu e não dá mais para enviar os arquivos do portal. Use o modelo UniFi API (artigo UniFi na sua controladora — modo API).

Você vai precisar de:

acesso de administrador à controladora;
um programa de FTP/SFTP, como WinSCP (Windows) ou FileZilla;
o MAC do ponto de acesso (etiqueta).

No painel

Em Hotspots, clique em Configurar Novo Hotspot.
Preencha Nome Fantasia e Local.
Em Modelo, escolha UniFi RADIUS (pode aparecer como UniFi RADIUS (Legacy)).
Site: o nome do site na controladora (geralmente default).
Tempo de Conexão (minutos): o tempo padrão do visitante.
MAC Address: o MAC do ponto de acesso.
Clique em Criar Hotspot.

Depois, abra o hotspot em Editar e pegue os dados:

Servidor e senha do RADIUS: aba Configuração, quadro Configuração RADIUS. A linha Authentication traz IP, porta e senha do servidor de autenticação; a linha Account, os de accounting.
Arquivos do portal e lista de endereços: aba Guia de Instalação, botão Gerar Script. O texto aparece na tela, em Instruções de Instalação, com a lista de endereços para liberar. O botão Baixar Passo a Passo + HTMLs baixa o index.html e o auth.html, já com o endereço deste hotspot.

No equipamento

1. Habilitar a interface Legacy

Na versão 6 ou superior, em Settings, ative a opção de interface legada (Legacy). Sem isso os menus abaixo não aparecem.

2. Criar a rede sem fio

Redes sem fio → Criar nova rede sem fio: Name/SSID = o nome que o visitante verá; Enabled ligado; Security = Open; Guest Policy ligado. Salve.

Guest Policy é obrigatório. Sem ele o portal nunca aparece.

3. Guest Control

Enable Guest Portal: ligado. Authentication: Hotspot.
Default Expiration: 8 horas. Landing Page: default.
Use Secure Portal, Redirect using hostname, Enable HTTPS Redirection e Enable encrypted redirect URL: desligados.
Template Engine: AngularJS. Override Default Templates: ligado.
Em Hotspot, habilite a autorização por RADIUS.

4. Perfil RADIUS

Em Guest Control → RADIUS, tipo de autenticação CHAP, crie um perfil:

Auth Server, Auth Server Port (1812) e Password: o IP, a porta e a senha da linha Authentication do painel.
Accounting: ligado. Accounting Server e Accounting Port (1813): os da linha Account.

Depois, selecione o perfil no Guest Control.

5. Liberar os endereços (Access Control)

Em Access Control (ou Pre-Authorization Access), inclua todos os endereços das Instruções de Instalação do painel. Inclua também captive.apple.com e connectivitycheck.gstatic.com: sem eles, o portal não abre sozinho no iPhone e no Android.

6. Enviar os arquivos do portal

Envie index.html e auth.html por FTP/SFTP para a pasta do portal:

Windows:   C:\Users\SEU_USUARIO\Ubiquiti UniFi\data\sites\default\app-unifi-hotspot-portal
macOS:     ~/Library/Application Support/UniFi/data/sites/default/app-unifi-hotspot-portal
Linux:     /usr/lib/unifi/data/sites/default/app-unifi-hotspot-portal
UDM Pro:   /data/unifi/data/sites/default/app-unifi-hotspot-portal
CloudKey:  /srv/unifi/data/sites/default/app-unifi-hotspot-portal

Com mais de um site, troque default pelo nome do site. Se a pasta sites não aparece, entre como superusuário do sistema.

Testar

Conecte um celular na rede criada.
O portal deve abrir sozinho. Faça o login.
A navegação deve liberar.

Problemas comuns

Sintoma	O que fazer
O portal não abre sozinho	Libere `captive.apple.com` e `connectivitycheck.gstatic.com` (passo 5)
Abre o portal padrão da UniFi	Override Default Templates desligado, ou arquivos no site errado
Nada acontece ao conectar	Guest Policy desligado na rede
Login aceito, internet não libera	Perfil RADIUS não selecionado, porta errada ou senha diferente da do painel
Os menus deste guia não aparecem	Interface Legacy desligada (passo 1), ou controladora versão 8 ou superior