Ubiquiti UniFi and Purple WiFi: Guia de Integração

Resumo Executivo

O Ubiquiti UniFi é uma das plataformas de WiFi empresarial mais amplamente implementadas no mundo, na qual confiam hotéis, cadeias de retalho, estádios e organizações do setor público pelo seu desempenho, escalabilidade e relação custo-benefício. No entanto, as suas capacidades nativas de portal de convidados são limitadas. A plataforma de inteligência de WiFi da Purple resolve esta lacuna integrando-se diretamente com o UniFi Network Controller através da sua funcionalidade External Portal Server, proporcionando uma experiência de Captive Portal totalmente personalizada com a marca e rica em análises, sem necessidade de qualquer hardware adicional.

Este guia fornece uma referência técnica completa para essa integração. Abrange a arquitetura subjacente, um processo de configuração passo a passo para as versões UniFi atuais (v7.4+) e legadas (v7.3 e anteriores), boas práticas de segurança e conformidade, e uma estrutura de resolução de problemas estruturada. As organizações que concluem esta integração ganham acesso a análises de visitantes em tempo real, recolha de dados em conformidade com o GDPR, integração com CRM e a capacidade de fornecer comunicações de marketing direcionadas — transformando o WiFi de convidados de um centro de custos num ativo de negócio mensurável.

Análise Técnica Detalhada

A integração entre o Ubiquiti UniFi e a Purple baseia-se na funcionalidade External Portal Server do UniFi. Esta funcionalidade redireciona os utilizadores convidados do controlador UniFi local para um Captive Portal de terceiros designado — neste caso, a plataforma Purple. O mecanismo subjacente baseia-se numa série de redirecionamentos HTTP e chamadas de API que gerem o ciclo de vida de autorização de convidados.

Quando um convidado se liga ao SSID de autenticação aberta designado, o controlador UniFi coloca o seu dispositivo num estado "pendente". Neste estado, todo o tráfego HTTP é intercetado e redirecionado para o URL da página de splash da Purple, com parâmetros-chave anexados à query string do URL: o endereço MAC do convidado, o endereço MAC do AP e o identificador do site. A plataforma Purple captura estes parâmetros, apresenta a experiência de início de sessão adequada e, após a autenticação bem-sucedida do utilizador — seja através de login social, formulário de e-mail ou voucher —, faz uma chamada de API HTTPS segura de volta ao UniFi Network Controller para autorizar o endereço MAC do convidado por uma duração de sessão especificada. Esta autorização move o dispositivo do estado "pendente" para o estado "autorizado", concedendo-lhe acesso à internet.

Um componente crítico desta arquitetura é o Walled Garden — uma lista de permissões (whitelist) de endereços IP e domínios que os dispositivos dos convidados têm permissão para aceder antes da autenticação. Isto é essencial para permitir o acesso aos domínios do próprio Purple, fornecedores de login social (Facebook, Google), endpoints de deteção de CNA da Apple e quaisquer outros serviços externos necessários. Sem um Walled Garden configurado corretamente, o Captive Portal não será carregado de todo.

Para implementações mais avançadas, a funcionalidade PurpleConnex do Purple introduz suporte para Passpoint (IEEE 802.11u), utilizando um servidor RADIUS para uma nova ligação contínua e sem credenciais para utilizadores que regressam. Isto requer a configuração de um perfil RADIUS no UniFi que aponte para o servidor de autenticação do Purple no IP 34.150.158.147, nas portas 1812 (autenticação) e 1813 (accounting).

Guia de Implementação

Esta secção fornece um guia passo a passo para configurar o seu UniFi Network Controller para se integrar com o Purple. As instruções seguintes aplicam-se à versão 7.4 ou mais recente da UniFi Network Application. Para versões antigas (v7.3 e anteriores), os princípios de configuração são idênticos, mas o caminho de navegação difere ligeiramente, utilizando Perfis > Hotspot de Convidados em vez do Gestor de Hotspot.

Passo 1: Verificar e Estabelecer a Acessibilidade do Controlador. Antes de iniciar qualquer configuração, confirme que o seu UniFi Network Controller está acessível a partir da internet pública. A plataforma cloud do Purple deve ser capaz de comunicar com a API do seu controlador para autorizar sessões de convidados. Para controladores UniFi baseados em software, isto requer uma regra de reencaminhamento de portas (port forward) no seu firewall que mapeie a porta TCP 8443 para o endereço IP da LAN interna do controlador. Para implementações baseadas em hardware — incluindo o UniFi Dream Machine Pro (UDM Pro), UDM Special Edition, UDR e CloudKey Gen2+ — a porta relevante é a TCP 443.

Passo 2: Criar uma Conta de Administrador Local Dedicada. Por motivos de higiene de segurança, nunca utilize as credenciais da sua conta principal de super-administrador ou de cloud da Ubiquiti para a integração da API do Purple. Crie uma nova conta de administrador local dedicada no seu controlador UniFi especificamente para este fim. Esta conta deve ter privilégios administrativos totais para o site relevante. A utilização de uma conta dedicada limita o impacto de qualquer potencial comprometimento de credenciais e garante que a integração não seja interrompida por alterações na sua conta principal. Passo 3: Criar o SSID de WiFi de Convidados. Na UniFi Network Application, navegue até Settings > WiFi e clique em Create New. Atribua um nome público (ex. 'Hotel Guest WiFi'). Defina o Security Protocol como Open — isto é obrigatório para que o mecanismo de redirecionamento do Captive Portal funcione. Atribua o SSID à sua VLAN de Convidados designada. Ative a opção Hotspot Portal.

Passo 4: Configurar o Hotspot Portal e o Servidor Externo. Navegue até Hotspot Manager > Landing Page. Em Authentication, selecione External Portal Server e introduza o endereço IP do Portal Externo fornecido pela Purple. Em Settings, configure da seguinte forma: ative Secure Portal, ative Redirect using Hostname e introduza o Access Domain fornecido pela Purple, e certifique-se de que o HTTPS Redirection está definido como Disabled. O campo Default Expiration da sessão deve ser definido para 8 horas.

Passo 5: Configurar o Walled Garden. Nas definições do Hotspot Manager, localize a secção Pre-Authorization Access. Adicione todos os domínios da lista fornecida pela Purple. Esta lista inclui normalmente os domínios da própria plataforma da Purple, domínios de fornecedores de login social (facebook.com, google.com, accounts.google.com), endpoints de deteção do Captive Network Assistant (CNA) da Apple e quaisquer outros serviços de terceiros utilizados na sua splash page. Este passo é a fonte mais comum de falhas de implementação e deve ser concluído com precisão.

Passo 6: Introduzir os Detalhes do Controlador no Portal da Purple. Inicie sessão na sua conta Purple e navegue até às definições do Venue relevante. Introduza o endereço IP público ou hostname do seu UniFi Controller e as credenciais da conta de administrador local dedicada criada no Passo 2. Guarde a configuração. A Purple tentará validar a ligação.

Passo 7: Testar e Validar. Utilizando um dispositivo móvel que não tenha sido ligado anteriormente à rede, ligue-se ao novo SSID de convidados. Deverá ser redirecionado automaticamente para o Captive Portal da Purple. Autentique-se utilizando um dos métodos configurados. Após o sucesso, deverá ser-lhe concedido acesso à internet. Se o redirecionamento falhar ou se o acesso à internet não for concedido após a autenticação, consulte a secção de Resolução de Problemas abaixo.

Boas Práticas

A segmentação de rede é o requisito de segurança fundamental para qualquer implementação de WiFi de convidados. O SSID de convidados deve ser atribuído a uma VLAN dedicada que esteja protegida por firewall de todas as redes corporativas e administrativas. Isto impede que os dispositivos dos convidados acedam a recursos internos, cumpre os requisitos de isolamento de rede PCI DSS e limita o impacto de qualquer incidente de segurança na rede de convidados.

A gestão de largura de banda é igualmente importante em ambientes de alta densidade. A funcionalidade de limitação de taxa por utilizador da UniFi deve ser configurada para definir limites razoáveis de upload e download para utilizadores convidados. Isto evita que um pequeno número de utilizadores de elevada largura de banda degrade a experiência de todos os convidados, o que é particularmente relevante em implementações de hotéis e centros de conferências.

O Walled Garden requer manutenção contínua. Os fornecedores de login social e outros serviços de terceiros atualizam periodicamente as suas estruturas de domínio. Uma revisão trimestral da configuração do Walled Garden, cruzada com a lista de domínios mais recente recomendada pela Purple, é uma prática operacional recomendada. A falha na manutenção desta lista é a principal causa de falhas no portal pós-implantação.

Para a integração da API, utilize sempre uma conta de administrador local dedicada em vez de uma conta associada à nuvem. Esta é tanto uma prática recomendada de segurança como uma medida de fiabilidade — as credenciais de contas na nuvem estão sujeitas a fluxos de autenticação multifator que podem interromper as chamadas de API automatizadas que a Purple realiza para autorizar convidados.

Resolução de Problemas e Mitigação de Riscos

O modo de falha mais comum é um Captive Portal que não carrega. Quando um convidado se liga ao SSID mas não vê qualquer redirecionamento, ou a página do portal não é renderizada, a causa raiz é quase invariavelmente um Walled Garden incompleto. Inicie a resolução de problemas ligando um dispositivo de teste e tentando navegar para um URL HTTP conhecido. Se o redirecionamento ocorrer mas a página não carregar, adicione os domínios em falta ao Walled Garden. Verifique também se o DNS da rede de convidados está configurado corretamente para resolver nomes de anfitriões externos.

A segunda falha mais comum é um cenário em que o convidado se autentica com sucesso no portal Purple mas não lhe é concedido acesso à internet. Isto indica uma falha na comunicação da API entre a Purple e o controlador UniFi. Os passos de diagnóstico são: primeiro, confirmar se o controlador está acessível publicamente na porta correta, tentando aceder-lhe a partir de uma rede externa; segundo, verificar se as credenciais de administrador local introduzidas no portal Purple estão corretas e se a conta não foi bloqueada; terceiro, rever os registos de eventos do controlador UniFi para verificar se existem erros de autenticação da API.

Para implantações em produção, a disponibilidade do controlador é um fator de risco crítico. Se o controlador UniFi ficar offline, as novas autorizações de convidados irão falhar. As estratégias de mitigação incluem a implantação de um controlador UniFi alojado na nuvem (o que proporciona redundância inerente), a implementação de um par de controladores de alta disponibilidade ou a configuração de monitorização e alertas sobre a disponibilidade do controlador. A plataforma da Purple irá colocar as tentativas de autorização em fila e tentar novamente, mas um tempo de inatividade prolongado do controlador resultará numa experiência de convidado degradada.

Do ponto de vista da conformidade, os dados recolhidos através do Captive Portal estão sujeitos ao GDPR e a regulamentos de proteção de dados equivalentes. A plataforma da Purple está arquitetada para a conformidade, fornecendo gestão de consentimento, ferramentas de pedido de acesso do titular dos dados (DSAR) e políticas de retenção de dados configuráveis. No entanto, a responsabilidade legal pelo processamento lícito de dados permanece com o operador do local. Certifique-se de que a sua política de privacidade está claramente ligada na splash page, que possui uma base jurídica documentada para a recolha de dados e que as suas definições de retenção de dados estão alinhadas com a política da sua organização.

ROI e Impacto no Negócio

A integração do Purple com o UniFi não é apenas uma atualização técnica; é uma decisão de negócio estratégica que transforma o WiFi de convidados de um centro de custos num ativo poderoso. O retorno do investimento é mensurável em várias dimensões fundamentais.

A inteligência de negócio é o principal motor de valor. O Purple recolhe dados ricos e anonimizados sobre o comportamento dos visitantes — incluindo fluxo de pessoas, tempos de permanência, frequência de visitas e padrões de movimento. Para uma cadeia de retalho, estes dados podem influenciar diretamente as decisões de layout das lojas, os níveis de pessoal e o timing das promoções. Para um hotel, podem revelar quais as comodidades mais utilizadas e em que horários, permitindo um upselling mais direcionado e maior eficiência operacional.

As capacidades de marketing e envolvimento representam um benefício secundário significativo. Ao recolher os dados de contacto dos convidados com consentimento, as organizações podem construir uma base de dados de marketing de primeira parte que não está sujeita às limitações da depreciação de cookies de terceiros. Campanhas de e-mail pós-visita, inquéritos de satisfação e convites para programas de fidelização podem ser automatizados diretamente a partir da plataforma Purple, gerando melhorias mensuráveis nas taxas de visitas repetidas e no valor do tempo de vida do cliente.

Para grandes recintos, tais como estádios, centros de conferências e centros comerciais, a inteligência operacional derivada de análises de fluxo de pessoas em tempo real e mapas de calor pode gerar ganhos de eficiência significativos — otimizando as escalas de limpeza, a distribuição da segurança e a colocação de concessões de retalho com base em dados reais de movimento dos visitantes, em vez de suposições.

Em certos contextos, a própria infraestrutura de WiFi de convidados pode ser monetizada através de modelos de acesso em níveis, splash pages patrocinadas ou publicidade direcionada, criando uma fonte de receita direta que compensa o custo do investimento na infraestrutura.