Resolução de problemas do captive portal Ruckus: redirecionamento WISPr, hotspot e checklist de walled garden

A maioria das falhas de captive portal Ruckus deve-se a cinco pontos: o URL de início de sessão e a página inicial do hotspot (WISPr), entradas em falta no walled garden para o portal e os seus recursos, uma palavra-passe incorreta na interface do portal northbound, falhas de autenticação ou contabilidade RADIUS, e avisos de certificado no redirecionamento HTTPS. Verifique-os por essa ordem, utilizando o histórico de eventos do cliente no SmartZone, Ruckus One ou Unleashed.

Como se identifica um captive portal Ruckus com falhas?

Um serviço de hotspot Ruckus utiliza WISPr (Wireless Internet Service Provider roaming). Este é um framework no qual o controlador mantém um utilizador convidado não autenticado atrás de um captive portal até que um sistema externo o aprove. Um captive portal é a splash page que um convidado preenche antes de aceder à internet. Quando esta cadeia falha, o convidado depara-se com um de seis sintomas:

• Sem qualquer redirecionamento. O dispositivo associa-se ao SSID e recebe um endereço IP, mas não surge nenhuma mensagem de início de sessão e o navegador expira o tempo limite.
• Uma splash page em branco ou parcialmente carregada. O ecrã abre, mas os logótipos, fontes, scripts ou botões de início de sessão social não carregam.
• Um aviso de certificado antes do portal. O navegador mostra "A sua ligação não é privada" ou semelhante, e o convidado tem de clicar para prosseguir.
• Um ciclo infinito de início de sessão. O convidado preenche o formulário e volta a cair na splash page, continuando offline.
• Sem mensagem de início de sessão, mas sem internet. O dispositivo indica que está online, pelo que o Captive Network Assistant nunca abre.
• Online, mas sem dados de sessão. Os convidados navegam normalmente, mas os inícios de sessão e a duração das sessões nunca chegam aos seus relatórios.

Os dois últimos sintomas são fáceis de ignorar, pois ninguém contacta o suporte técnico. Só os nota mais tarde, quando os seus dados de convidados param de crescer.

O que costuma causar falhas no captive portal Ruckus?

É útil conhecer a sequência primeiro. O artigo de suporte sobre Captive Portal da Purple explica este processo. O controlador faz a gestão da interação WiFi com os servidores de splash page da Purple. Esses servidores recolhem os dados do convidado e emitem um início de sessão de utilização única. O controlador envia depois esse início de sessão para o servidor RADIUS da Purple para concluir o acesso. O RADIUS (Remote Authentication Dial-In User Service, RFC 2865) é o protocolo que autentica a sessão. A contabilidade RADIUS (RFC 2866) regista a sessão posteriormente.

Cada etapa tem o seu próprio modo de falha.

Definições de redirecionamento e página inicial do serviço de hotspot

O serviço de hotspot contém o URL de início de sessão externo e a página inicial. O URL de início de sessão é para onde os convidados não autenticados são enviados. A página inicial é onde acedem após o início de sessão. Um erro de digitação, um URL desatualizado após uma alteração de portal, ou o serviço de hotspot incorreto associado à WLAN impedem o redirecionamento. Uma página inicial que aponte para um URL bloqueado ou descontinuado faz com que um início de sessão bem-sucedido pareça uma falha.

Falhas de configuração no walled garden

O walled garden é a lista de destinos que um convidado não autenticado pode aceder antes do início de sessão. Deve incluir o hostname do portal e todos os hosts a partir dos quais a splash page carrega elementos. Deve também incluir os domínios de qualquer fornecedor de identidade de rede social ou single sign-on que disponibilize. Se adicionar uma opção de início de sessão, leia how to enable single sign-on e adicione os domínios desse fornecedor. Um único host de elementos em falta resulta numa página parcialmente carregada.

O erro oposto também causa problemas. Os dispositivos testam a conectividade verificando um nome de domínio predefinido, de acordo com o artigo de suporte da Purple. Se esse domínio de teste estiver no walled garden, o dispositivo assume que está online. O aviso nunca aparece e o convidado fica sem acesso.

Credenciais da interface do portal northbound

No SmartZone, a interface do portal northbound é a forma como um portal externo indica ao controlador que um convidado iniciou sessão. O portal autentica-se nessa interface com uma palavra-passe definida no controlador. Se essa palavra-passe for alterada apenas de um dos lados, o portal não consegue autorizar ninguém. O convidado preenche o formulário e regressa num ciclo infinito à splash page.

Autenticação e contabilidade RADIUS

O controlador encaminha o início de sessão único para o RADIUS. A autenticação falha se o segredo partilhado for diferente, se o servidor RADIUS estiver inacessível ou se os pedidos provierem de um endereço que o servidor não reconhece. As falhas de contabilidade são mais silenciosas. Os convidados conseguem aceder à internet, mas os registos de início e fim de sessão nunca chegam.

Comportamento de redirecionamento HTTPS

Os browsers modernos esperam uma página de início de sessão através de HTTPS. O Cisco WLC certificate article da Purple descreve o efeito nos controladores Cisco. Um redirecionamento HTTP para um endereço do controlador gera um aviso de segurança e o convidado tem de clicar para prosseguir. A solução neste caso é um certificado fidedigno público cujo Common Name corresponda ao hostname de autenticação web do controlador. O mesmo princípio aplica-se ao ativar o redirecionamento HTTPS num controlador Ruckus. Um certificado expirado, ou uma incompatibilidade de nomes, faz com que o aviso reapareça.

Como identificar qual é a causa do seu problema?

Comece pelo sintoma, não pela configuração. A tabela mapeia cada sintoma à sua causa mais provável e ao primeiro local onde deve procurar.

Sintoma	Causa mais provável	Onde procurar primeiro	Primeira verificação
Sem aviso de início de sessão, tempo limite do browser esgotado	URL de início de sessão do hotspot incorreto, ou serviço de hotspot incorreto na WLAN	Definições do serviço de hotspot (WISPr) e da WLAN	Abra o neverssl.com num dispositivo de teste e verifique onde este vai parar
A splash page carrega sem imagens ou botões	Host de elementos ou do fornecedor de identidade em falta no walled garden	Lista do walled garden	Carregue o portal num portátil e liste todos os hosts bloqueados nas ferramentas de programador do browser
O dispositivo indica estar online, sem aviso, sem internet	Domínio de teste de conectividade no walled garden	Lista do walled garden	Remova entradas genéricas com asterisco e teste novamente
O formulário é concluído, o convidado volta ao início	Incompatibilidade de palavra-passe na interface de portal northbound	Definições de interface northbound e integração de portal	Confirme se a palavra-passe coincide em ambos os lados
Início de sessão rejeitado após o formulário	Segredo partilhado RADIUS ou incompatibilidade de endereço de origem	Serviço de autenticação RADIUS e eventos de cliente	Procure por tempos limite ou rejeições de autenticação
Convidados online, sem dados de sessão	RADIUS accounting desconfigurado ou não associado	Serviço de RADIUS accounting na WLAN	Confirme se o accounting está ativado e a apontar para o servidor correto

Reproduza o problema num dispositivo limpo

Esqueça o SSID num telemóvel e num portátil de teste e, em seguida, volte a ligar. Se o aviso não abrir, o artigo de suporte da Purple recomenda aceder a neverssl.com. Esse site evita problemas de redirecionamento SSL, mostrando se o redirecionamento em si funciona.

Leia os eventos do cliente

Cada plataforma Ruckus mantém um histórico de eventos de clientes. No SmartZone, utilize os registos de eventos e alarmes e o histórico de ligação do cliente. No Ruckus One, abra o cliente e analise os seus eventos. No Unleashed, verifique o registo de eventos para o endereço MAC do cliente. Procure por três coisas: se o cliente se associou, se foi redirecionado e se o RADIUS o aceitou ou rejeitou. Essa sequência indica qual o elo da cadeia que falhou.

Como resolver no SmartZone, Ruckus One e Unleashed?

As correções seguem a mesma ordem nas três plataformas. Os menus diferem, por isso siga a documentação da Ruckus para a sua versão e o artigo de suporte de Captive Portal para os valores da Purple.

SmartZone

Confirme se a WLAN utiliza o serviço de hotspot (WISPr) que espera e se o URL de início de sessão corresponde à integração. Reconstrua o walled garden a partir da lista atual, não de memória. Verifique se a palavra-passe da interface de portal northbound corresponde à configurada para o portal. Em seguida, confirme se os serviços de autenticação e accounting RADIUS apontam para os servidores corretos com o segredo partilhado correto.

Ruckus One

O Ruckus One gere os mesmos elementos WISPr de forma centralizada. Verifique as definições do fornecedor do portal da rede de convidados, o walled garden e os serviços RADIUS. As sobreposições ao nível do espaço (venue) merecem atenção, porque um espaço pode desviar-se do modelo aplicado em todos os outros locais.

Unleashed

O Unleashed executa a função de controlador num ponto de acesso, por isso verifique o serviço de hotspot nesse AP principal. Preste atenção às definições de walled garden e RADIUS, e confirme se o serviço de hotspot está associado à WLAN de convidados.

Exclua falhas semelhantes

Algumas reclamações parecem falhas no portal, mas não o são. Se os convidados forem solicitados novamente a fazer login enquanto se deslocam entre pontos de acesso, leia como resolver problemas de roaming em WLANs corporativas. Se as sessões caírem aleatoriamente em canais de 5GHz, a lista de verificação de diagnóstico de eventos de radar DFS é o melhor ponto de partida.

Como é que isto se reflete num espaço físico real?

Os dois cenários abaixo são ilustrativos. Demonstram o método em vez de reportar uma implementação específica.

Cenário 1: um hotel de 200 quartos após a reformulação de uma splash page

Situação. A equipa de marketing relançou a splash page do hotel. Na manhã seguinte, a receção informou que os hóspedes viam uma página em branco com um único campo de formulário.

O que foi feito. O engenheiro carregou o portal num portátil e listou os pedidos bloqueados nas ferramentas de programador do navegador. O novo design carregava tipos de letra e imagens a partir de um domínio que não constava no walled garden do SmartZone. O engenheiro adicionou esse domínio, voltou a ligar um telemóvel e um portátil de teste, e confirmou que ambos carregavam a página completa.

Resultado. A splash page completa foi carregada em ambos os dispositivos de teste logo no primeiro teste. A correção consistiu numa única entrada no walled garden, e os eventos de clientes mostraram que os convidados voltaram a passar com sucesso pelo redirecionamento e pela aceitação do RADIUS. Para saber mais sobre a experiência dos hóspedes neste setor, consulte o Purple para Hotéis.

Cenário 2: uma cadeia de retalho de 40 lojas após uma migração de controlador

Situação. Um retalhista migrou as suas lojas para um novo cluster SmartZone. Os clientes continuavam a conseguir ligar-se à internet, mas os relatórios de convidados mostravam zero novas sessões em todas as 40 lojas.

O que foi feito. Os eventos de clientes mostravam aceitações de autenticação RADIUS, mas nenhum registo de contabilidade (accounting). O serviço de contabilidade não tinha sido associado à WLAN de convidados no novo cluster. O engenheiro associou-o e confirmou que o segredo partilhado correspondia.

Resultado. Os registos de sessão voltaram a aparecer em todas as 40 lojas. Os clientes não sofreram qualquer interrupção, pois apenas os relatórios tinham sido afetados. Consulte o Purple para Retalho para ver como estes dados de sessão alimentam o conhecimento sobre o comportamento dos consumidores.

Como evitar que as falhas no Captive Portal Ruckus voltem a acontecer?

A maioria das falhas recorrentes deve-se a alterações e não a avarias. Cinco hábitos ajudam a preveni-las:

1. Trate o walled garden como um documento controlado. Registe cada entrada, o respetivo proprietário e o motivo da sua existência. Reveja-o sempre que a splash page for alterada.
2. Rode os segredos em ambos os lados em simultâneo. Altere a palavra-passe da interface do portal northbound e o segredo partilhado do RADIUS numa única janela de manutenção, nunca apenas de um dos lados.
3. Acompanhe a expiração dos certificados. Agende a renovação com bastante antecedência antes de o certificado de redirecionamento HTTPS expirar, e verifique novamente a correspondência do nome após a renovação.
4. Teste após cada alteração. Execute o mesmo teste num iPhone, num telemóvel Android, num portátil Windows e num portátil macOS. Sistemas operativos diferentes gerem o Captive Network Assistant de formas distintas.
5. Acompanhe a contagem diária de sessões. Uma queda repentina para zero na sua análise de WiFi aponta para a contabilidade (accounting) antes que qualquer visitante se queixe.

Mantenha a rede de visitantes aberta, conforme recomendado no artigo de suporte da Purple. Uma rede aberta é a convenção padrão e o comportamento familiar reduz a fricção no início de sessão. Para operadores de transportes, onde os passageiros se ligam em movimento, aplicam-se as mesmas verificações; consulte a Purple para Trains.

Perguntas frequentes

A Purple funciona com o Ruckus SmartZone, Ruckus One e Unleashed?

Sim, o Purple Guest WiFi é executado nos serviços de hotspot Ruckus (WISPr) como um Captive Portal externo. A Purple é agnóstica em termos de hardware e também funciona com Cisco Meraki, HPE Aruba, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme e Fortinet. O controlador gere o redirecionamento e o RADIUS, enquanto a Purple aloja a splash page e autentica o visitante. Os valores e passos de configuração encontram-se no artigo de suporte do Captive Portal da Purple.

Precisamos de novos pontos de acesso para adicionar a Purple a uma rede Ruckus existente?

Não, a Purple funciona como uma sobreposição de nuvem nos pontos de acesso e controlador Ruckus que já possui. Configura um serviço de hotspot, walled garden e definições de RADIUS no controlador e, em seguida, aponta a WLAN de visitantes para a Purple. Nada é substituído no local. A maior parte do esforço reside em testar o redirecionamento em dispositivos iOS, Android, Windows e macOS antes de entrar em produção.

Podemos mudar do portal de visitantes integrado da Ruckus para a Purple sem perturbar os visitantes?

Sim, se criar primeiro a configuração da Purple numa WLAN de teste separada. Configure o serviço de hotspot, o walled garden e os serviços de RADIUS em paralelo com a sua rede de visitantes ativa e comprove o início de sessão completo em dispositivos de teste. Assim que funcionar, associe o novo serviço de hotspot à WLAN ativa num período de pouco movimento. Os visitantes verão uma nova splash page, não uma interrupção de serviço.

Como é que a Purple trata os dados dos visitantes recolhidos através de um Ruckus captive portal?

A Purple recolhe dados primários (first-party) através de consentimentos por escolha consciente na splash page. A Purple é certificada pelas normas ISO 27001 e Cyber Essentials, e opera em conformidade com o GDPR e a CCPA. O controlador Ruckus não retém dados de marketing. Este transmite um início de sessão único para o servidor RADIUS da Purple, pelo que os dados dos visitantes permanecem na plataforma certificada da Purple em vez de se espalharem pelos controladores individuais de cada local.

Quanto tempo demora uma implementação do Ruckus captive portal com a Purple?

Um único local é normalmente configurado numa única sessão de trabalho, uma vez que não há alterações de hardware. O controlador necessita de um serviço de hotspot, de um walled garden e de autenticação e contabilidade (accounting) RADIUS. Infraestruturas com vários locais demoram mais tempo, principalmente devido aos testes e ao controlo de alterações, e não propriamente pela configuração. No Ruckus One ou SmartZone, um modelo aplicado centralmente mantém a consistência em todos os locais e reduz o risco de desvios de configuração entre eles.

Para que escala está comprovada a plataforma de guest WiFi da Purple?

A Purple opera em mais de 80.000 locais ativos e registou 440 milhões de inícios de sessão em 2024, de acordo com os dados internos da própria Purple. Esses locais abrangem os setores da hotelaria, retalho, transportes, educação e setor público. A Purple opera desde 2012, e cada implementação utiliza a mesma página de login e fluxo RADIUS descritos neste guia, independentemente do fornecedor de hardware suportado que execute a rede subjacente.