WISPr e Captive Portal Auto-Login: O Que Ainda Funciona em 2026

Este guia de referência técnica e autoritário examina o estado atual do protocolo WISPr e dos mecanismos de auto-login de Captive Portal em 2026, cobrindo quais plataformas de SO ainda respeitam a especificação, como o iOS e o Android lidam com a deteção de Captive Portal, e porque as implementações empresariais estão a migrar para Passpoint e OpenRoaming. Fornece a arquitetos de rede e gestores de TI orientação de implementação acionável, estratégias de migração e estruturas de mitigação de riscos para implementações de Wi-Fi legadas e modernas.

📖 8 min de leitura📝 1,962 palavras🔧 2 exemplos❓ 3 perguntas📚 10 termos-chave

🎧 Ouça este Guia

Ver Transcrição

Welcome to this executive briefing from Purple. I'm your host, and today we're diving into a critical architectural shift in enterprise networking: the state of WISPr and captive portal auto-login in 2026. If you're an IT manager, network architect, or venue operations director managing Wi-Fi across hospitality, retail, or large public venues, this session is designed for you. We'll cut through the marketing noise and look at what actually works today, what's broken, and how you should be planning your migration to Passpoint and OpenRoaming.

Let's start with some context. For over a decade, the Wireless Internet Service Provider roaming protocol — or WISPr — was the backbone of captive portal deployments. The core idea was elegant: a smart client on the device would detect a captive portal, read an XML challenge hidden in the redirect, and automatically submit credentials via RADIUS. No user interaction required. It was the standard for carrier offload and enterprise roaming.

But here we are in 2026, and the landscape has completely changed. The reality is that the WISPr XML auto-login mechanism is effectively dead on modern mobile devices. Apple's iOS never natively supported it, relying instead on its Captive Network Assistant. Android has deprecated its support. You might see some legacy Windows deployments or specific MDM-managed devices still using it, but for general public or guest Wi-Fi, relying on WISPr XML is a failing strategy.

So, what does work? How do modern devices handle captive portals today?

It all comes down to the Captive Network Assistant, or CNA, and HTTP connectivity probes. When an iOS 17 or 18 device connects to an open network, it fires off an HTTP GET request to a specific Apple endpoint — usually captive.apple.com. It's looking for a very specific Success response. If your wireless controller intercepts that request and returns an HTTP 302 redirect, the iPhone knows it's behind a captive portal. It then launches the CNA — that sandboxed mini-browser we're all familiar with — to render your login page.

Android does something very similar, probing gstatic.com endpoints.

This brings us to a critical implementation pitfall. I see network engineers trying to enforce strict HTTPS-only policies across their entire infrastructure. They try to redirect that initial HTTPS traffic to the portal. This will break your deployment every time. Why? Because your wireless controller doesn't own the TLS certificate for google.com or apple.com. When it intercepts that HTTPS request, the device sees a Man-in-the-Middle attack, throws a massive security warning, and the CNA never launches. The golden rule here is: HTTP to detect, HTTPS to protect. The initial redirect must be HTTP. Once the user is directed to your portal, that page must be secured with HTTPS.

Another common issue we see, particularly with iOS 17 and 18, is overly aggressive pre-authentication ACLs. If your walled garden blocks DNS resolution, or blocks access to those specific probe URLs entirely, the OS assumes the network is just dead. The CNA won't trigger, and the user is left connected to the Wi-Fi with no internet access. You must ensure those probe domains are allowed to resolve and be intercepted.

Now, while the XML auto-login part of WISPr is deprecated, it's vital to understand that WISPr RADIUS attributes are very much alive and well. If you're using WISPr-Bandwidth-Max-Down to throttle guest traffic, or WISPr-Location-ID for analytics, those Vendor-Specific Attributes are still heavily supported by Cisco, Aruba, Ruckus, and others. You don't need to rewrite your entire RADIUS policy engine just yet.

But let's look at the bigger picture. Captive portals on open networks are fundamentally insecure. The traffic is unencrypted until the user logs in, leaving them vulnerable to evil twin attacks and credential harvesting. With stricter compliance frameworks like PCI DSS 4.0, maintaining these open networks is becoming a liability.

This is why the industry is aggressively moving toward Passpoint, also known as Hotspot 2.0, and the OpenRoaming federation managed by the Wireless Broadband Alliance.

Passpoint changes the paradigm. Instead of connecting to an open network and dealing with a portal, the device uses 802.11u ANQP queries to discover the network's capabilities before connecting. It then authenticates automatically using EAP-TLS or EAP-TTLS. The critical advantage here is that the connection is encrypted with WPA2 or WPA3 Enterprise from the very first packet. It's mutual authentication — the device verifies the network, and the network verifies the device.

For the user, the experience is identical to cellular roaming. They walk into your venue, and they are securely online. No friction, no portal, no complaints.

So, what is the migration strategy? You can't just flip a switch and turn off your captive portal tomorrow. You have legacy devices, IoT hardware, and users who aren't enrolled in an OpenRoaming profile.

The recommended approach is a dual-SSID deployment. You maintain your legacy open SSID with the captive portal. Alongside it, you broadcast a new Passpoint-enabled SSID. You then integrate with an identity provider. Purple, for example, acts as a free identity provider for OpenRoaming under the Connect license.

As users with valid profiles — perhaps from their cellular carrier, a loyalty app, or a previous OpenRoaming enrollment — enter your venue, they will automatically attach to the secure Passpoint SSID. You use your analytics platform to monitor this adoption. Over time, as Passpoint traffic grows, you can begin to restrict the legacy captive portal to specific use cases, eventually phasing it out entirely.

Let's wrap up with a quick rapid-fire Q and A based on common client questions.

Question one: Do users need to install an app for OpenRoaming? Not necessarily. While you can provision profiles via an app, native support is built into modern iOS, Android, Windows, and macOS devices. Many users are already provisioned through their cellular carriers or device manufacturers.

Question two: Can OpenRoaming run alongside my existing captive portal? Yes, absolutely. The dual-SSID strategy is the standard migration path, allowing you to support legacy devices while upgrading the experience for modern clients.

Question three: Does moving to Passpoint mean I lose my bandwidth control? No. Your RADIUS server can still return those legacy WISPr bandwidth attributes upon successful 802.1X authentication, and your wireless controller will enforce them just as it did for the captive portal.

To summarize: The WISPr XML auto-login is a relic of the past. Ensure your captive portals are optimized for modern OS Captive Network Assistants, always use HTTP for the initial redirect, and begin your strategic migration to Passpoint and OpenRoaming to secure your infrastructure and eliminate user friction.

Thank you for listening. For more detailed implementation guides and architecture diagrams, refer to the full technical reference guide provided by Purple.

Principais Conclusões

✓WISPr XML auto-login is effectively deprecated on all modern mobile operating systems (iOS 17+, Android 14+); do not rely on it for general guest Wi-Fi deployments.
✓Modern devices rely on OS-level Captive Network Assistants (CNA) triggered by specific HTTP connectivity probes — the initial captive portal redirect must always occur over HTTP to avoid TLS certificate errors.
✓WISPr RADIUS attributes (WISPr-Bandwidth-Max-Down, WISPr-Location-ID, etc.) remain fully functional and are still the standard mechanism for bandwidth control and session management across enterprise WLCs.
✓Passpoint (Hotspot 2.0) and OpenRoaming are the necessary architectural upgrade for secure, seamless enterprise Wi-Fi, providing WPA3 encryption from the first packet and eliminating the unencrypted open network window.
✓A dual-SSID migration strategy — maintaining the legacy captive portal alongside a new Passpoint SSID — is the recommended approach to ensure backwards compatibility for legacy and IoT devices during the transition.
✓Misconfigured pre-authentication ACLs that block OS probe URLs are the most common cause of captive portal failures, particularly for iOS devices where captive.apple.com must be interceptable.
✓81% of Wi-Fi executives plan OpenRoaming deployments, driven by PCI DSS 4.0 compliance requirements and the security vulnerabilities inherent in open unencrypted networks.

Resumo Executivo

Durante mais de uma década, o protocolo de roaming do Provedor de Serviços de Internet Sem Fios (WISPr) serviu como o padrão de facto para o auto-login de Captive Portal e federação de roaming. Em 2026, o panorama mudou fundamentalmente. Embora os Captive Portals permaneçam ubíquos em ambientes de Hotelaria e Retalho , a dependência do WISPr XML para autenticação contínua foi largamente substituída pelos modernos Assistentes de Rede Cativa (CNA) ao nível do SO e pela rápida adoção do Passpoint (Hotspot 2.0).

Este guia fornece aos decisores de TI seniores uma análise pragmática do que ainda funciona em relação ao WISPr e à deteção de Captive Portal. Exploramos como o iOS 17/18 e as versões modernas do Android lidam com o redirecionamento de portal, porque os clientes inteligentes tradicionais estão a falhar e como os arquitetos de rede empresariais devem planear a sua transição para arquiteturas OpenRoaming. Ao compreender as limitações técnicas dos fluxos UAM (Universal Access Method) legados, os diretores de operações de locais podem mitigar problemas de conectividade de convidados enquanto preparam o terreno para acesso Wi-Fi seguro e encriptado desde o primeiro pacote.

Análise Técnica Aprofundada: O Estado do WISPr em 2026

O Legado do WISPr XML

Originalmente submetido como um rascunho de protocolo à Wi-Fi Alliance, o WISPr foi concebido para permitir que os utilizadores fizessem roaming entre diferentes provedores de serviços de internet sem fios. A inovação central foi o Protocolo de Interface Cliente Inteligente para Gateway de Acesso, definido no Apêndice D da especificação. Este protocolo baseado em XML permitia que o software cliente inteligente detetasse um Captive Portal, analisasse o desafio XML incorporado no redirecionamento HTML e submetesse automaticamente as credenciais RADIUS via HTTPS POST sem exigir que o utilizador interagisse com um navegador.

Em 2026, este mecanismo está efetivamente obsoleto nos sistemas operativos móveis modernos. O iOS da Apple nunca suportou nativamente o auto-login WISPr XML, dependendo em vez disso do seu Captive Network Assistant. O Android descontinuou de forma semelhante o suporte em favor das suas próprias verificações de conectividade. Apenas dispositivos específicos geridos por MDM empresariais e implementações legadas do Windows (via WLAN AutoConfig) retêm capacidades parciais de análise de WISPr XML. No entanto, os atributos RADIUS definidos pelo WISPr — como WISPr-Bandwidth-Max-Up e WISPr-Location-ID — continuam a ser amplamente utilizados por grandes fornecedores de rede para modelagem de tráfego e aplicação de políticas.

Mecanismos Modernos de Deteção de Captive Portal

Quando um cliente se conecta a um SSID aberto, deve determinar se tem acesso direto à internet ou se está atrás de um Captive Portal. Isso é conseguido através de sondas HTTP específicas que diferem por sistema operativo.

iOS e macOS (Captive Network Assistant): Os dispositivos Apple realizam um pedido HTTP GET para endpoints específicos, principalmente http://captive.apple.com/hotspot-detect.html. Se a rede intercetar este pedido e retornar um redirecionamento HTTP 302 ou um HTTP 200 OK com um payload que não corresponde à string esperada de "Sucesso", o SO sinaliza a rede como cativa. Em seguida, lança o Captive Network Assistant (CNA) — um mini-navegador em sandbox — para renderizar a página do portal. Crucialmente, no iOS 17 e 18, a aplicação rigorosa significa que se a rede usar HTTPS para o redirecionamento inicial ou bloquear totalmente o acesso ao URL da sonda, o CNA falhará ao iniciar, deixando o utilizador conectado ao Wi-Fi mas sem acesso à internet.

Android e ChromeOS: Os dispositivos Android utilizam verificações de conectividade semelhantes, sondando endpoints como http://connectivitycheck.gstatic.com/generate_204. Se uma resposta 204 No Content não for recebida, o Android solicita ao utilizador para "Iniciar sessão na rede". Ao contrário do iOS, as versões mais recentes do Android podem realizar estas verificações via HTTPS, embora o HTTP permaneça o padrão de fallback para compatibilidade com pontos de acesso legados.

Windows 10/11: O serviço WLAN AutoConfig da Microsoft sonda http://www.msftconnecttest.com/connecttest.txt. O Windows retém capacidade limitada de análise de WISPr XML no seu serviço WLAN AutoConfig, mas isso só é acionado para SSIDs com um perfil WISPr pré-configurado, tipicamente implementado via MDM ou Política de Grupo. Para Wi-Fi de convidado geral, o Windows comporta-se de forma semelhante aos SOs móveis, apresentando uma notificação ao utilizador.

Sistema Operativo	WISPr XML Auto-Login	Deteção de Captive Portal	Passpoint / OpenRoaming Nativo
iOS 17 / 18	Não suportado	Sim (sonda HTTP para captive.apple.com)	Sim (nativo)
Android 14 / 15	Não suportado	Sim (sonda HTTP para gstatic.com)	Sim (nativo)
Windows 10 / 11	Parcial (apenas provisionado por MDM)	Sim (sonda HTTP para msftconnecttest.com)	Parcial (requer perfil)
macOS Sonoma / Sequoia	Apenas legado	Sim (CNA, igual ao iOS)	Sim (nativo)
ChromeOS	Limitado	Sim	Sim

Os Atributos RADIUS WISPr Que Ainda Importam

Embora o handshake de autenticação XML seja obsoleto para a maioria das implementações, os Atributos Específicos do Fornecedor (VSAs) RADIUS definidos pela especificação WISPr permanecem uma parte ativa da política de rede empresarial. Fornecedores incluindo Aruba (HPE), Cisco, Ruckus, Fortinet e Extreme Networks suportam todos estes atributos nos seus pipelines de processamento RADIUS.

Atributo	Função	Ainda Relevante em 2026
`WISPr-Bandwidth-Max-Up`	Limite de largura de banda de upstream	Sim — usado para limitação de convidados
`WISPr-Bandwidth-Max-Down`	Limite de largura de banda de downstream	Sim — usado para limitação de convidados
`WISPr-Location-ID`	Identifica a localização do hotspot	Sim — usado para análises e faturação
`WISPr-Location-Name`	Localização legível por humanos	Sim — usado para relatórios
`WISPr-Session-Terminate-Time`	Carimbo de data/hora de expiração da sessão	Sim — usado para acesso com tempo limitado
`WISPr-Logoff-URL`	Ponto final de terminação de sessão	Em declínio — substituído por CoA
`WISPr-Redirection-URL`	Alvo de redirecionamento pós-autenticação	Sim — usado para páginas de marketing splash

Guia de Implementação: Transição para Passpoint

À medida que a indústria se afasta das redes abertas não encriptadas, o Passpoint (Hotspot 2.0) e o OpenRoaming representam a evolução necessária para implementações empresariais. Construído sobre o padrão IEEE 802.11u, o Passpoint permite que os dispositivos descubram e autentiquem-se em redes automaticamente usando EAP-TLS ou EAP-TTLS, fornecendo encriptação WPA2/WPA3 Enterprise desde o momento da ligação.

De acordo com o Relatório da Indústria WBA 2025, 81% dos executivos de Wi-Fi planeiam implementar o OpenRoaming na sua infraestrutura. Para centros de Transporte , instalações de Saúde e grandes ambientes de retalho, esta transição é cada vez mais um requisito de conformidade do que uma atualização discricionária.

Estratégia de Migração Passo a Passo

Passo 1 — Auditoria dos Atributos RADIUS Atuais: Reveja as suas configurações de servidor RADIUS existentes. Identifique quais os Atributos Específicos do Fornecedor WISPr que estão atualmente em uso para limitação de taxa de largura de banda, tempos limite de sessão ou relatórios de localização. Estas políticas devem ser mapeadas para atributos equivalentes na sua nova implementação Passpoint antes que o SSID legado seja desativado.

Passo 2 — Implementar SSIDs Duplos: Durante a fase de transição, configure os seus pontos de acesso para transmitir tanto o SSID aberto legado (com o Captive Portal) quanto um novo SSID habilitado para Passpoint. Isso garante compatibilidade retroativa para dispositivos legados e hardware IoT sem interface que não podem participar na autenticação EAP.

Passo 3 — Configurar o Fornecedor de Identidade: Para habilitar o OpenRoaming, deve integrar-se com um fornecedor de identidade estabelecido. A Purple oferece um serviço gratuito de fornecedor de identidade para OpenRoaming sob a licença Connect, facilitando a autenticação contínua para utilizadores com perfis válidos de operadoras e fornecedores de serviços participantes.

Passo 4 — Atualizar Equipamento de Rede: Certifique-se de que os seus Controladores de Rede Local Sem Fios (WLC) e pontos de acesso estão a executar firmware que suporta Passpoint Release 2 ou superior. Os principais fornecedores, incluindo Cisco, Aruba e Ruckus, fornecem suporte abrangente. Para ambientes SMB, consulte o guia TP-Link Omada and Purple WiFi for SMB Deployments para um passo a passo de implementação prática.

Passo 5 — Monitorizar e Descontinuar: Utilize WiFi Analytics para acompanhar a taxa de adoção do SSID Passpoint versus o SSID Captive Portal legado. Uma vez atingido um limiar suficiente — tipicamente 70-80% das sessões — o Captive Portal legado pode ser restrito a casos de uso específicos ou desativado por completo.

Melhores Práticas para a Resiliência do Captive Portal

Para ambientes que devem manter um Captive Portal em 2026, aderir a rigorosas melhores práticas de configuração é fundamental para garantir que o CNA seja lançado de forma fiável em todos os dispositivos.

Não Bloqueie URLs de Sondagem: Certifique-se de que o seu walled garden ou ACLs de pré-autenticação permitem a resolução de DNS e o tráfego HTTP para captive.apple.com, connectivitycheck.gstatic.com e msftconnecttest.com. Bloquear estes domínios impedirá que o sistema operativo detete o portal e acione o CNA.

Use HTTP para o Redirecionamento Inicial: O redirecionamento inicial deve ocorrer via HTTP (Porta 80). Tentar redirecionar um pedido HTTPS resultará num aviso de certificado TLS, uma vez que o ponto de acesso não pode apresentar um certificado válido para o domínio que o utilizador solicitou originalmente. Esta é a falha de configuração mais comum encontrada em implementações de Captive Portal empresariais.

Proteja a Página do Portal com HTTPS: Uma vez que o redirecionamento ocorra, a página de destino real do Captive Portal deve ser alojada via HTTPS com um certificado SSL válido e publicamente confiável. Isso garante que as credenciais do utilizador e os dados de consentimento GDPR sejam transmitidos de forma segura e que a página do portal não seja sinalizada como insegura pelos navegadores modernos.

Otimize para o CNA: O Captive Network Assistant é um navegador limitado. Evite frameworks JavaScript complexos, pop-ups ou o download de grandes ativos. O portal deve carregar rapidamente e ser totalmente responsivo para acomodar vários tamanhos de ecrã. Um portal que demore mais de três segundos a carregar resultará numa taxa de abandono significativamente maior.

Implemente CoA para Gestão de Sessões: Em vez de depender do mecanismo legado WISPr-Logoff-URL, implemente o RADIUS Change of Authorisation (CoA) para gestão dinâmica de sessões. Isso proporciona terminações de sessão e acionadores de reautenticação mais fiáveis em todos os tipos de dispositivos.

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

Modos de Falha Comuns e Resoluções

Sintoma: Dispositivos iOS conectam-se ao Wi-Fi, mas o ecrã de login nunca aparece. Causa Raiz: A rede está a bloquear o acesso a captive.apple.com, a retornar uma resposta inválida à sondagem, ou a funcionalidade "Bypass Apple Captive Network Assistant" está inadvertidamente ativada no controlador sem fios. Resolução: Verifique as ACLs de pré-autenticação. Desative quaisquer funcionalidades de bypass do CNA no WLC. Confirme que o redirecionamento HTTP 302 está a ser entregue corretamente monitorizando os registos de estado do cliente WLC.

Sintoma: Os utilizadores recebem erros de certificado antes de verem o Captive Portal. Causa Raiz: A rede está a tentar intercetar e redirecionar o tráfego HTTPS. O WLC não possui a chave privada para o domínio solicitado, o que aciona um erro TLS do navegador. Resolução: CoConfigure o Captive Portal para intercetar e redirecionar apenas o tráfego HTTP na Port 80. Confie nas sondas de conectividade ao nível do OS para acionar o portal.

Sintoma: Os utilizadores Android são solicitados a iniciar sessão, mas a página do portal não carrega corretamente. Causa Raiz: A página do portal está a utilizar funcionalidades JavaScript ou CSS que não são suportadas pelo componente Android WebView usado para a renderização do Captive Portal. Resolução: Teste a página do portal num ambiente de navegador restrito. Certifique-se de que todos os ativos são carregados do próprio servidor do portal (sem dependências de CDN externas que são bloqueadas pela ACL de pré-autenticação).

Sintoma: Os limites de largura de banda WISPr não estão a ser aplicados após a migração para a autenticação Passpoint. Causa Raiz: O servidor RADIUS não está a devolver os VSAs de largura de banda WISPr para sessões autenticadas por 802.1X, apenas para sessões UAM. Resolução: Atualize a política RADIUS para devolver os atributos WISPr-Bandwidth-Max-Up e WISPr-Bandwidth-Max-Down para todas as sessões autenticadas, independentemente do método de autenticação utilizado.

ROI e Impacto no Negócio

A migração de Captive Portals WISPr legados para arquiteturas Passpoint/OpenRoaming oferece um valor de negócio significativo, particularmente em ambientes de alta densidade, como centros de transporte e implementações de retalho em larga escala.

De uma perspetiva de segurança e conformidade, a substituição de redes abertas por encriptação WPA3 Enterprise elimina a janela não encriptada que existe entre a ligação e a autenticação do portal. Isto aborda diretamente as vulnerabilidades destacadas no PCI DSS 4.0 e reduz o risco de ataques evil twin que são trivialmente fáceis de executar contra SSIDs abertos.

Operacionalmente, a eliminação do atrito do Captive Portal reduz os tickets de helpdesk relacionados com problemas de conectividade Wi-Fi. Numa propriedade hoteleira de 500 quartos, isto pode representar uma redução significativa nas chamadas para a receção durante os períodos de pico de check-in. Quando integrado com uma plataforma robusta de Guest WiFi , a maior taxa de adesão de conexões Passpoint contínuas traduz-se em análises mais ricas e serviços baseados na localização mais eficazes. Para mais informações sobre como o posicionamento interior se integra com estas arquiteturas, consulte o nosso Indoor Positioning System: UWB, BLE, & WiFi Guide .

Embora a implementação inicial do Passpoint exija atualizações de configuração e integração com o fornecedor de identidade, as eficiências operacionais a longo prazo e a experiência de utilizador melhorada proporcionam um retorno sobre o investimento convincente para os operadores de rede empresariais. A abordagem de migração de dual-SSID minimiza a interrupção, permitindo que as organizações façam a transição a um ritmo que se adapte às suas restrições operacionais.

Termos-Chave e Definições

WISPr (Wireless Internet Service Provider roaming)

A draft protocol originally submitted to the Wi-Fi Alliance that defined XML-based auto-login mechanisms and specific RADIUS attributes for captive portal environments. WISPr 2.0 was published by the Wireless Broadband Alliance in March 2010.

While the XML auto-login is largely deprecated in 2026, the WISPr RADIUS attributes are still heavily used for bandwidth control and session management across enterprise WLCs.

Captive Portal

A web page that a user of a public-access network is obliged to view and interact with before full internet access is granted. Typically implemented via HTTP redirection at the network access layer.

Used extensively in hospitality and retail to capture user consent and first-party data before granting internet access. GDPR Article 7 compliance requirements apply to the consent mechanism.

Captive Network Assistant (CNA)

A limited, sandboxed web browser built into operating systems (iOS, macOS, Android, Windows) specifically designed to render captive portal login pages when a network is detected as captive.

IT teams must ensure portal pages are optimised for the CNA, as it lacks the full feature set of a standard browser and cannot execute complex JavaScript frameworks reliably.

Passpoint (Hotspot 2.0)

An industry standard based on IEEE 802.11u that enables devices to automatically discover and securely connect to Wi-Fi networks using EAP-based authentication, providing WPA2/WPA3 Enterprise encryption from the first packet.

The primary upgrade path for enterprise networks looking to replace unencrypted captive portals with secure, seamless authentication. Supported natively on iOS, Android, Windows, and macOS.

OpenRoaming

A global roaming federation managed by the Wireless Broadband Alliance (WBA), built upon Passpoint technology, that allows seamless Wi-Fi onboarding across participating networks worldwide.

Enables users to automatically connect to participating networks without registering at each venue. Purple acts as a free identity provider for OpenRoaming under the Connect license.

UAM (Universal Access Method)

A standard method for browser-based login at a captive portal, utilizing HTTP redirection to a centralized authentication server. The underlying mechanism that powers traditional captive portal deployments.

Distinct from 802.1X authentication. UAM relies on the user's browser (or CNA) to render the portal page, making it dependent on the OS captive portal detection mechanism.

Pre-Authentication ACL (Walled Garden)

An Access Control List applied to a client before successful authentication, defining what limited network resources they can access. Must allow DNS resolution and access to the portal server while blocking general internet access.

Misconfigured pre-auth ACLs are the most common cause of captive portal failures, particularly when probe URLs for iOS or Android are inadvertently blocked.

ANQP (Access Network Query Protocol)

A query and response protocol used by Passpoint (IEEE 802.11u) to allow devices to discover network capabilities, roaming consortium identifiers, and authentication requirements before associating.

ANQP queries replace the WISPr XML discovery mechanism in Passpoint deployments, enabling automatic and secure network selection without user interaction.

WISPr VSAs (Vendor-Specific Attributes)

RADIUS Vendor-Specific Attributes defined by the WISPr specification, including WISPr-Bandwidth-Max-Up, WISPr-Bandwidth-Max-Down, WISPr-Location-ID, and WISPr-Session-Terminate-Time.

These attributes remain fully functional in 2026 and are returned by RADIUS servers to enforce bandwidth policies and session management for both UAM and 802.1X authenticated sessions.

CoA (Change of Authorisation)

A RADIUS extension (RFC 5176) that allows the AAA server to dynamically modify or terminate an active session without requiring the client to re-authenticate.

The recommended replacement for the legacy WISPr-Logoff-URL mechanism for session management in modern enterprise deployments.

Estudos de Caso

A large conference centre with 3,000 concurrent users is experiencing a high volume of complaints from attendees using iOS 17 devices. Users report that they connect to the 'Conference_Guest' Wi-Fi SSID, but the captive portal login screen never appears, leaving them connected to the network but without internet access. Android users on the same SSID are not experiencing this issue. The network runs on Cisco Catalyst 9800 WLCs.

Step 1: Verify the Pre-Authentication ACLs on the Wireless LAN Controller. Navigate to the guest SSID policy and confirm that DNS resolution is permitted for all clients, and that HTTP traffic (Port 80) destined for any IP address is being intercepted and redirected to the portal URL — not dropped.

Step 2: Check the WLC configuration for any CNA Bypass settings. On Cisco 9800 WLCs, this is found under the WLAN security settings. If 'Captive Bypass Portal' is enabled, disable it immediately. This setting prevents the WLC from redirecting Apple's specific HTTP probe requests, assuming the user will open a full browser manually.

Step 3: Confirm the initial redirection is occurring on HTTP port 80, not HTTPS port 443. Use a packet capture on the WLC management interface to verify the 302 redirect is being sent in response to the iOS probe.

Step 4: Ensure the portal server's HTTPS certificate is valid and trusted. While the initial redirect is HTTP, the portal page itself must be HTTPS. An expired or self-signed certificate will cause the CNA to display a warning and prevent login.

Step 5: Test with an iOS device, monitoring the RADIUS logs and WLC client state to confirm the HTTP 302 redirect is successfully delivered and the CNA launches.

Notas de Implementação: This scenario highlights the specific requirements of the Apple Captive Network Assistant and why it behaves differently from Android. Android uses different probe URLs (gstatic.com), which explains why Android users were unaffected. The most common cause for this specific failure mode is either an overly restrictive pre-auth ACL or an improperly configured CNA bypass feature on the enterprise controller. The key diagnostic insight is that the issue is OS-specific, pointing directly to the CNA probe mechanism rather than a general network fault.

A national retail chain with 200 stores is planning to migrate from their legacy open SSID with a captive portal to a Passpoint-enabled network to improve security and reduce PCI DSS 4.0 compliance risk. However, their network operations team relies heavily on the WISPr-Bandwidth-Max-Down RADIUS attribute to throttle guest traffic to 5Mbps, and their RADIUS infrastructure is managed by a third-party provider. How should they approach this migration without losing bandwidth control?

Step 1: Deploy a dual-SSID strategy across all 200 stores simultaneously using a centralised WLC or cloud management platform. Keep the existing open SSID active while broadcasting the new Passpoint-enabled SSID with the same SSID name as the OpenRoaming profile.

Step 2: Work with the third-party RADIUS provider to update the RADIUS policy. The policy must be configured to return WISPr-Bandwidth-Max-Down (value: 5120 Kbps) and WISPr-Bandwidth-Max-Up attributes in the RADIUS Access-Accept message for all authenticated sessions — including 802.1X/EAP sessions from Passpoint clients, not just UAM sessions from the captive portal.

Step 3: Verify that the WLC firmware at each store supports applying WISPr VSAs to 802.1X-authenticated sessions. Most enterprise WLCs (Cisco, Aruba, Ruckus) support this, but it may require a firmware update on older hardware.

Step 4: Integrate with an OpenRoaming identity provider (such as Purple under the Connect license) to enable automatic onboarding for users whose devices carry valid roaming credentials.

Step 5: Use the WiFi Analytics platform to monitor per-store adoption of the Passpoint SSID. After 90 days, review adoption rates and plan the phased decommissioning of the legacy open SSID on a store-by-store basis.

Notas de Implementação: This example demonstrates a critical architectural insight: while the WISPr XML authentication mechanism is deprecated, the RADIUS attributes defined by the WISPr specification remain fully functional and essential for policy enforcement in both legacy and modern authentication contexts. Network architects must ensure these policy attributes are correctly mapped when transitioning authentication methods. The third-party RADIUS dependency is a common real-world constraint that requires explicit coordination rather than assumptions about default behaviour.

Análise de Cenários

Q1. Your deployment requires users to download a specific loyalty app before accessing the internet. You configure the pre-authentication ACL to allow access to the Apple App Store and Google Play Store IP ranges. However, users report they cannot access the stores. What is the most likely architectural limitation causing this, and what is the correct resolution?

💡 Dica:Consider how modern Content Delivery Networks (CDNs) and cloud services resolve IP addresses dynamically.

Mostrar Abordagem Recomendada

The App Store and Play Store utilise complex, dynamic CDNs (such as Akamai or CloudFront). Creating IP-based ACLs for these services is highly unreliable because the IP addresses change frequently based on geography and load balancing. The correct resolution is to use DNS-based ACLs (if supported by the WLC) to whitelist the specific domain names required by the app stores, rather than attempting to maintain a list of static IP ranges. Alternatively, configure the portal to provide a direct download link to the app hosted on your own portal server, bypassing the app store requirement entirely during the pre-auth phase.

Q2. A network engineer proposes implementing a strict HTTPS-only policy for all network traffic, including the initial captive portal redirect, to improve security. Why is this approach fundamentally flawed for captive portal environments, and what is the correct security architecture?

💡 Dica:Think about how TLS certificates are validated by a client browser and what happens when the WLC intercepts an HTTPS request.

Mostrar Abordagem Recomendada

When a client attempts to access a secure site (e.g., https://example.com ) and the WLC intercepts that traffic to redirect to the portal, the WLC must present a TLS certificate. Because the WLC does not possess the valid private key for 'example.com', the client browser correctly identifies the interception as a Man-in-the-Middle attack and displays a severe security warning, preventing the portal from loading. The correct architecture is: (1) allow the OS connectivity probe (HTTP) to be intercepted and redirected, triggering the CNA; (2) host the portal login page itself on HTTPS with a valid, publicly trusted certificate; (3) use WPA2/WPA3 Enterprise (Passpoint) for full encryption from connection, eliminating the need for the initial unencrypted phase entirely.

Q3. You are tasked with migrating a 60,000-seat stadium network from a legacy captive portal to OpenRoaming. The business requires that user bandwidth is still strictly limited to 5Mbps down / 2Mbps up, and the stadium hosts IoT devices (point-of-sale terminals, digital signage) that cannot participate in EAP authentication. How do you architect this migration?

💡 Dica:Consider both the bandwidth policy persistence challenge and the IoT device compatibility requirement.

Mostrar Abordagem Recomendada

This requires a three-SSID architecture: (1) A Passpoint/OpenRoaming SSID for modern guest devices, with the RADIUS server returning WISPr-Bandwidth-Max-Down (5120 Kbps) and WISPr-Bandwidth-Max-Up (2048 Kbps) VSAs upon successful EAP authentication — confirming that WISPr bandwidth attributes remain functional in 802.1X contexts. (2) A legacy open SSID with captive portal for transitional guest devices that do not yet have OpenRoaming profiles. (3) A separate WPA2-PSK SSID on a dedicated VLAN for IoT devices, with MAC address filtering and strict firewall rules to prevent lateral movement. The WISPr bandwidth attributes must be explicitly configured in the RADIUS policy for the Passpoint SSID, as they are not automatically inherited from the legacy UAM policy.