Integração do Cisco WLC e Catalyst com a Purple WiFi: Guia de Acesso de Convidados Passo a Passo
Este guia de referência detalha a integração passo a passo de Cisco Catalyst 9800 WLCs com a Purple WiFi. Abrange a External Web Authentication para portais cativos de convidados, 802.1X EAP-TLS para acesso seguro de funcionários e Cisco iPSK for segmentação de VLAN dinâmica multi-tenant.
Ouça este guia
Ver transcrição do podcast
- Resumo Executivo
- Análise Técnica Detalhada: Arquitetura e Fluxos de Autenticação
- 1. Guest WiFi: External Web Authentication (EWA)
- 2. Staff WiFi: 802.1X EAP-TLS e PEAP
- 3. IoT e Multi-Tenant: Cisco Identity PSK (iPSK)
- Guia de Implementação
- Configurar o Redirecionamento do Captive Portal de Convidados
- Configurar a Atribuição Dinâmica de VLAN para iPSK
- Melhores Práticas
- Resolução de Problemas e Mitigação de Riscos
- ROI e Impacto no Negócio
- Referências

Resumo Executivo
A implementação de uma rede sem fios segura, em conformidade e escalável em ambientes empresariais exige uma integração estreita entre a infraestrutura e os fornecedores de identidade. Este guia detalha as decisões de arquitetura e os passos de configuração necessários para integrar os Cisco Catalyst 9800 Wireless LAN Controllers (WLC) com a plataforma de nuvem da Purple.
Para o acesso de convidados, exploramos a External Web Authentication (EWA) para redirecionamento do Captive Portal, permitindo a captura de dados originais e análise de Guest WiFi . Para o acesso de funcionários, detalhamos a autenticação 802.1X EAP-TLS e PEAP utilizando o Purple SecurePass como um proxy RADIUS para o Microsoft Entra ID ou Okta. Para ambientes de IoT e multi-tenant, delineamos a configuração do Cisco Identity PSK (iPSK), que permite a atribuição dinâmica de VLAN e a segmentação de rede num único SSID sem depender de implementações complexas de certificados.
A Purple opera em mais de 80.000 locais ativos globalmente, processando 440 milhões de inícios de sessão em 2024. Esta integração está comprovada em ambientes de alta densidade de Hospitality , Retail e Transport onde o tempo de atividade, a conformidade e a experiência de utilizador fluida são inegociáveis.
Análise Técnica Detalhada: Arquitetura e Fluxos de Autenticação
1. Guest WiFi: External Web Authentication (EWA)
Para disponibilizar um Captive Portal personalizado e recolher dados de utilizador para WiFi Analytics , o Cisco Catalyst 9800 WLC deve intercetar o tráfego HTTP não autenticado e redirecioná-lo para a página de boas-vindas alojada na nuvem da Purple. Este mecanismo é designado por External Web Authentication (EWA).

O processo segue uma sequência específica:
- O cliente associa-se ao SSID aberto ou com Opportunistic Wireless Encryption (OWE).
- O WLC coloca o cliente num estado
Webauth_reqde aplica uma Lista de Controlo de Acesso (ACL) de pré-autenticação. - O WLC interceta o pedido HTTP do cliente e emite um redirecionamento 302 para o URL da página de boas-vindas da Purple, anexando parâmetros como o endereço MAC do AP, o endereço MAC do cliente e o SSID da WLAN.
- O cliente conclui o processo de autenticação no portal da Purple (por exemplo, início de sessão social, recolha de e-mail ou aceitação de termos).
- O servidor RADIUS da Purple envia uma mensagem Access-Accept para o WLC.
- O WLC move o cliente para o estado
Run, concedendo acesso à internet com base na política pós-autenticação.
2. Staff WiFi: 802.1X EAP-TLS e PEAP
Para dispositivos corporativos, WPA2/WPA3 Enterprise com 802.1X fornece a postura de segurança mais robusta. Em vez de implementar um servidor RADIUS local como o Cisco ISE, o Purple SecurePass funciona como um proxy RADIUS na nuvem. Este termina o túnel Extensible Authentication Protocol (EAP) e encaminha a verificação de identidade para o seu fornecedor de identidade (IdP), como o Microsoft Entra ID ou Google Workspace.
- EAP-TLS: Recomendado para dispositivos corporativos geridos. Requer a implementação de certificados de cliente através de um MDM (ex. Microsoft Intune). A autenticação é silenciosa e altamente segura.
- PEAP-MSCHAPv2: Recomendado para ambientes BYOD onde a implementação de certificados não é prática. Os utilizadores autenticam-se com as suas credenciais corporativas.
3. IoT e Multi-Tenant: Cisco Identity PSK (iPSK)
Em ambientes como propriedades Build-to-Rent (BTR), alojamentos de estudantes ou lojas de retalho com inúmeros dispositivos IoT, a implementação de 802.1X é frequentemente impossível porque os dispositivos carecem de suporte a suplicantes. Criar um SSID separado para cada inquilino ou tipo de dispositivo causa congestionamento de RF.
O Cisco iPSK resolve este problema permitindo múltiplas chaves pré-partilhadas (PSKs) únicas num único SSID. Quando um dispositivo se associa, o WLC envia o seu endereço MAC para o servidor RADIUS da Purple. A Purple devolve a PSK específica para esse dispositivo, juntamente com atributos de atribuição dinâmica de VLAN, segmentando o tráfego na porta do switch.

Guia de Implementação
Configurar o Redirecionamento do Captive Portal de Convidados
Para configurar a Autenticação Web Externa no Catalyst 9800 WLC, deve definir um mapa de parâmetros e um filtro de URL para permitir o tráfego de pré-autenticação para o portal da Purple [1].
Passo 1: Criar o Mapa de Parâmetros de Autenticação Web
Configure o WLC para redirecionar os clientes para o portal da Purple, passando as variáveis necessárias. Deve configurar o endereço IPv4 virtual (normalmente 192.0.2.1) globalmente.
parameter-map type webauth PURPLE-GUEST
type consent
timeout init-state sec 600
redirect for-login https://portal.purple.ai
redirect append ap-mac tag ap_mac
redirect append wlan-ssid tag wlan
redirect append client-mac tag client_mac
redirect portal ipv4
logout-window-disabled
success-window-disabled
Passo 2: Configurar o Filtro de URL de Pré-Autenticação
Os clientes devem conseguir aceder ao portal da Purple antes de serem autenticados. O 9800 WLC utiliza filtros de URL para abrir portas dinamicamente na ACL de interceção com base em DNS snooping.
urlfilter list PURPLE-PREAUTH
action permit
url portal.purple.ai
Aplique este filtro de URL ao perfil de política da sua WLAN nas definições de ACL de pré-autenticação.
Configurar a Atribuição Dinâmica de VLAN para iPSK
Para colocar utilizadores ou dispositivos em VLANs específicas de forma dinâmica, o servidor RADIUS do Purple deve enviar três atributos IETF específicos na resposta Access-Accept [2].
- IETF 64 (Tunnel-Type): Definido para
VLAN(valor 13). - IETF 65 (Tunnel-Medium-Type): Definido para
802(valor 6). - IETF 81 (Tunnel-Private-Group-ID): Definido para o ID da VLAN como uma string (ex.,
"10").
No Catalyst 9800 WLC, certifique-se de que o seguinte está configurado na WLAN iPSK:
- A Filtragem de MAC está ativada.
- O AAA Override está ativado (crucial para aceitar a atribuição de VLAN do RADIUS).
- A Segurança de Layer 2 está definida para WPA2-PSK (o PSK configurado funciona como fallback).
Melhores Práticas
- Verificação de VLAN: O ID da VLAN devolvido pelo servidor RADIUS no
Tunnel-Private-Group-IDDEVE existir como uma interface dinâmica no WLC. Se não existir, o WLC coloca o cliente na VLAN nativa, criando um risco de segurança grave. - Cadeias de Confiança de Certificados: Para implementações EAP-TLS, carregue a sua Root CA e quaisquer certificados de CA Intermédia no painel do Purple SecurePass antes de disponibilizar os certificados de cliente. Se o servidor RADIUS não conseguir validar a cadeia, a autenticação falha silenciosamente.
- RADIUS Redundante: Configure sempre servidores RADIUS secundários. Defina o timeout do servidor primário para 3 segundos com 2 tentativas para garantir um failover rápido sem frustrar o utilizador.
- Adoção de WPA3: Utilize WPA3-SAE para redes iPSK quando suportado pelos dispositivos clientes. Para redes de convidados abertas, implemente WPA3-OWE (Opportunistic Wireless Encryption) para encriptar o tráfego sem exigir uma palavra-passe.
Resolução de Problemas e Mitigação de Riscos
| Modo de Falha | Sintoma | Causa Raiz | Mitigação |
|---|---|---|---|
| Loop de Redirecionamento | O dispositivo do cliente atualiza constantemente a página do Captive Portal sem a carregar. | A ACL de pré-autenticação ou o filtro de URL não permite o acesso aos endereços IP do portal da Purple. O WLC redireciona o cliente, o cliente tenta carregar a página, o WLC bloqueia e redireciona novamente. | Verifique se o filtro de URL PURPLE-PREAUTH está aplicado ao perfil de política e se o domínio do portal está escrito corretamente. Certifique-se de que o tráfego de DNS é permitido na pré-autenticação. |
| Falha de Fallback de iPSK | O dispositivo IoT não registado liga-se à rede, mas recebe o endereço IP errado. | O endereço MAC do dispositivo não está na base de dados RADIUS da Purple. O WLC reverte para o PSK global configurado na WLAN e atribui a VLAN predefinida. | Audite o endereço MAC no painel da Purple. Certifique-se de que a VLAN predefinida atribuída ao perfil de política da WLAN é uma rede de quarentena restrita, e não a LAN corporativa. |
| Timeout do RADIUS | Os clientes experienciam longos atrasos ao ligar-se; os logs do WLC mostram o servidor RADIUS inacessível. | Os firewalls entre o WLC e os endpoints de cloud RADIUS da Purple estão a bloquear as portas UDP 1812 (Autenticação) ou 1813 (Accounting). | Verifique se as regras de firewall de saída permitem UDP 1812/1813 a partir da interface de gestão do WLC para os endereços IP de RADIUS publicados da Purple. |
ROI e Impacto no Negócio
A implementação de uma arquitetura unificada com a Cisco e a Purple proporciona um valor de negócio mensurável em três pilares:
- Eficiência Operacional: A substituição do provisionamento manual de VLAN e de múltiplos SSIDs por iPSK reduz o volume de pedidos de suporte de TI. A automatização da integração de IoT via API poupa horas de trabalho dos técnicos por local.
- Conformidade e Segurança: A atribuição dinâmica de VLAN garante a conformidade com o PCI DSS em ambientes de retalho, isolando de forma estrita os terminais de pagamento do tráfego de Guest WiFi (Requisito 1.3). O EAP-TLS elimina o risco de partilha de palavras-passe de funcionários.
- Geração de Receita: A integração de Captive Portal transforma um centro de custos (Guest WiFi) num ativo de marketing. A recolha de opt-ins por escolha consciente constrói uma base de dados primária (first-party) que impulsiona campanhas de fidelidade e visitas repetidas.
Referências
[1] Cisco Systems, "Configurar o Spaces Captive Portal com o Catalyst 9800 WLC," Maio de 2025. [2] Cisco Systems, "Configurar um Servidor RADIUS e WLC para Atribuição Dinâmica de VLAN," Setembro de 2012.
Definições Principais
External Web Authentication (EWA)
Um mecanismo onde o Cisco WLC intercepta o tráfego HTTP não autenticado e redireciona o cliente para um Captive Portal alojado externamente (como a Purple) para autenticação.
Utilizada para disponibilizar páginas de boas-vindas personalizadas com a marca e recolher dados primários sem depender do servidor web interno limitado do WLC.
Identity PSK (iPSK)
Uma funcionalidade da Cisco que permite a utilização de múltiplas Pre-Shared Keys exclusivas num único SSID, com cada chave associada a um endereço MAC de cliente e VLAN específicos via RADIUS.
Essencial para proteger dispositivos IoT e ambientes multi-tenant onde o 802.1X não é suportado, reduzindo a necessidade de múltiplos SSIDs.
AAA Override
Uma definição de WLAN no Cisco WLC que força o controlador a aceitar parâmetros de política (como IDs de VLAN ou ACLs) devolvidos pelo servidor RADIUS, sobrepondo-se à configuração local da WLAN.
Deve estar ativado para que a atribuição dinâmica de VLAN e o iPSK funcionem corretamente.
EAP-TLS
Extensible Authentication Protocol - Transport Layer Security. Um método de autenticação 802.1X altamente seguro que se baseia na troca mútua de certificados em vez de palavras-passe.
O padrão de excelência para a segurança de WiFi de funcionários, exigindo um MDM para implementar certificados de cliente em dispositivos corporativos.
PEAP-MSCHAPv2
Protected Extensible Authentication Protocol. Um método 802.1X que encripta o processo de autenticação dentro de um túnel TLS, permitindo aos utilizadores autenticarem-se em segurança com um nome de utilizador e palavra-passe.
Utilizado para redes BYOD de funcionários onde a implementação de certificados de cliente não é viável.
ACL de Pré-Autenticação
Uma Lista de Controlo de Acesso (ACL) aplicada a um cliente sem fios antes de este ser autenticado, definindo exatamente quais os recursos de rede que pode alcançar.
Crucial para portais cativos; deve permitir o tráfego de DNS e o acesso aos IPs da página de boas-vindas da Purple, bloqueando todo o restante tráfego.
Interface Dinâmica
Uma interface lógica criada no WLC mapeada para um ID de VLAN e porta física específicos.
Quando o RADIUS devolve um ID de VLAN para atribuição dinâmica, essa VLAN já deve existir como uma interface dinâmica no WLC, caso contrário o cliente será colocado na VLAN nativa.
WPA3-SAE
Simultaneous Authentication of Equals. O substituto moderno para WPA2-PSK, fornecendo forward secrecy e proteção contra ataques de dicionário offline.
Suportado pelo Cisco Catalyst 9800 e Purple RADIUS para proteger redes IoT e de convidados modernas.
Exemplos Práticos
Um hotel de 200 quartos necessita de segmentar o tráfego de rede entre convidados, funcionários e dispositivos IoT (fechaduras de portas, termóstatos) utilizando um único Cisco Catalyst 9800 WLC, sem criar múltiplos SSIDs que causem congestão de RF.
Implemente um único SSID utilizando Cisco iPSK. Registe o endereço MAC de cada dispositivo IoT no painel da Purple, atribuindo cada um à VLAN 30. Configure o WLAN do WLC com filtragem MAC, AAA Override e WPA2-PSK. Quando uma fechadura de porta se associa, o servidor RADIUS da Purple devolve a PSK exclusiva e os atributos IETF 64, 65 e 81 para direcionar dinamicamente o dispositivo para a VLAN 30. Os convidados utilizam um SSID aberto separado com External Web Authentication a apontar para o Captive Portal da Purple.
Uma cadeia de retalho com 80 lojas necessita de isolar o tráfego dos terminais de pagamento do tráfego de WiFi de convidados para manter a conformidade com a PCI DSS, gerida centralmente através do Cisco Catalyst Centre.
Configure o SSID de convidados com uma ACL de pré-autenticação que bloqueie explicitamente o tráfego destinado à sub-rede dos terminais de pagamento (VLAN 40). Utilize iPSK para autenticar os terminais de pagamento, atribuindo-os dinamicamente à VLAN 40 através do servidor RADIUS da Purple. O tráfego de convidados é autenticado através do Captive Portal da Purple e colocado na VLAN 10.
Perguntas de Prática
Q1. Está a implementar um captive portal num Catalyst 9800 WLC. Os clientes associam-se ao SSID, mas os seus browsers atualizam continuamente o URL da splash page sem nunca carregar o conteúdo. Qual é a causa arquitetural mais provável?
Dica: Considere o estado do cliente antes de a autenticação estar concluída e qual o tráfego que é permitido.
Ver resposta modelo
A ACL de pré-autenticação ou o filtro de URL está mal configurado. Está a bloquear o acesso aos endereços IP do portal da Purple. O WLC intercepta o tráfego e redireciona para o portal, mas o cliente não consegue aceder ao portal para o carregar, desencadeando um loop de redirecionamento infinito. Deve permitir explicitamente os endereços IP da Purple ou utilizar um filtro de URL para o domínio do portal.
Q2. Um dispositivo IoT autentica-se com sucesso via iPSK, e o servidor RADIUS da Purple devolve um Access-Accept com os atributos IETF 64, 65 e 81 especificando a VLAN 50. No entanto, o dispositivo é colocado na VLAN 10 (a VLAN de gestão). Por que razão isto aconteceu?
Dica: Pense nos pré-requisitos necessários no próprio WLC para aceitar e aplicar uma VLAN atribuída por RADIUS.
Ver resposta modelo
Ou o 'AAA Override' está desativado nas definições avançadas da WLAN, fazendo com que o WLC ignore os atributos RADIUS, OU a VLAN 50 não existe como uma interface dinâmica configurada no WLC. Se a VLAN atribuída não existir localmente, o WLC reverte para a VLAN nativa/de gestão.
Q3. Um espaço pretende implementar 802.1X para o WiFi dos funcionários utilizando o Microsoft Entra ID. Não possuem um servidor RADIUS local como o Cisco ISE. Como é que isto pode ser alcançado utilizando a plataforma Purple?
Dica: Considere como a Purple lida com o túnel EAP e a verificação de identidade.
Ver resposta modelo
Configure o WLC para utilizar o Purple SecurePass como o servidor RADIUS. A Purple atua como um proxy RADIUS na nuvem, terminando o túnel EAP-TLS ou PEAP do WLC e encaminhando de forma segura a pesquisa de identidade para o Microsoft Entra ID via API/SAML. Não é necessário nenhum servidor RADIUS local.
Continue a ler esta série
Integração do CommScope Ruckus com o Purple WiFi: Guia de Instalação e Configuração
Este guia de referência técnica fornece um manual de configuração autoritativo para integrar arquiteturas CommScope Ruckus com o Purple WiFi. Detalha implementações passo a passo para Captive Portals de Guest WiFi, WiFi seguro para funcionários via 802.1X e isolamento de rede multi-tenant utilizando Ruckus Dynamic PSK.
Integração de Access Points Allied Telesis com Purple WiFi
Este guia fornece um manual de configuração abrangente para integrar access points Allied Telesis da Série TQ com o Purple WiFi. Abrange o redirecionamento de Captive Portal externo, autenticação RADIUS 802.1X e direcionamento dinâmico de VLAN usando Private Pre-Shared Keys (PPSK) para implementações multi-tenant seguras.
Integração de Pontos de Acesso Grandstream GWN com o Purple WiFi
Este guia de referência técnica detalha como integrar os pontos de acesso Grandstream GWN com a plataforma de Guest WiFi e analítica da Purple. Abrange a configuração do Captive Portal da Grandstream, definições de RADIUS AAA, configuração de walled garden, autenticação segura de funcionários 802.1X com direcionamento dinâmico de VLAN e segmentação PPSK multi-tenant — fornecendo orientações práticas e passo a passo para MSPs e equipas de TI que implementam WiFi para convidados e funcionários em grande escala.