Integração do Cisco WLC e Catalyst com Purple WiFi: Guia Passo a Passo de Acesso de Visitantes
Este guia definitivo detalha a integração passo a passo dos Cisco Catalyst 9800 WLCs com o Purple WiFi. Ele abrange a Autenticação Web Externa para portais cativos de visitantes, 802.1X EAP-TLS para acesso seguro de funcionários e Cisco iPSK para segmentação dinâmica de VLAN multilocatário.
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: Autenticação Web Externa (EWA)
- 2. Staff WiFi: 802.1X EAP-TLS e PEAP
- 3. IoT e Multi-Tenant: Cisco Identity PSK (iPSK)
- Guia de Implementação
- Configurando o Redirecionamento do Captive Portal de Visitantes
- Configurando a Atribuição Dinâmica de VLAN para iPSK
- Melhores Práticas
- Resolução de Problemas e Mitigação de Riscos
- ROI e Impacto nos Negócios
- Referências

Resumo Executivo
Implantar uma rede sem fio segura, em conformidade e escalável em ambientes corporativos exige uma integração estreita entre a infraestrutura e os provedores de identidade. Este guia detalha as decisões de arquitetura e as etapas de configuração necessárias para integrar os Cisco Catalyst 9800 Wireless LAN Controllers (WLC) com a plataforma de nuvem da Purple.
Para o acesso de visitantes, exploramos a Autenticação Web Externa (EWA) para redirecionamento de Captive Portal, permitindo a captura de dados primários e análises de Guest WiFi . Para o acesso de funcionários, detalhamos a autenticação 802.1X EAP-TLS e PEAP usando o Purple SecurePass como um proxy RADIUS para o Microsoft Entra ID ou Okta. Para ambientes de IoT e multi-inquilino (multi-tenant), descrevemos a configuração do Cisco Identity PSK (iPSK), que permite a atribuição dinâmica de VLAN e a segmentação de rede em um único SSID sem depender de implantações complexas de certificados.
A Purple opera em mais de 80.000 locais ativos globalmente, processando 440 milhões de logins em 2024. Essa integração é comprovada em ambientes de alta densidade de Hospitalidade , Varejo e Transporte , onde o tempo de atividade, a conformidade e a experiência do usuário perfeita são inegociáveis.
Análise Técnica Detalhada: Arquitetura e Fluxos de Autenticação
1. Guest WiFi: Autenticação Web Externa (EWA)
Para entregar um Captive Portal personalizado e capturar dados de usuários para WiFi Analytics , o Cisco Catalyst 9800 WLC deve interceptar o tráfego HTTP não autenticado e redirecioná-lo para a splash page hospedada na nuvem da Purple. Esse mecanismo é chamado de Autenticação Web Externa (EWA).

O processo segue uma sequência específica:
- O cliente se associa ao SSID aberto ou Opportunistic Wireless Encryption (OWE).
- O WLC coloca o cliente em um estado
Webauth_reqde aplica uma Lista de Controle de Acesso (ACL) de pré-autenticação. - O WLC intercepta a solicitação HTTP do cliente e emite um redirecionamento 302 para a URL da splash page 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 fluxo de autenticação no portal da Purple (por exemplo, login social, captura de e-mail ou aceitação dos 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, o WPA2/WPA3 Enterprise com 802.1X fornece a postura de segurança mais robusta. Em vez de implantar um servidor RADIUS local como o Cisco ISE, o Purple SecurePass atua como um proxy RADIUS em nuvem. Ele finaliza o túnel Extensible Authentication Protocol (EAP) e encaminha a verificação de identidade para o seu Provedor de Identidade (IdP), como o Microsoft Entra ID ou Google Workspace.
- EAP-TLS: Recomendado para dispositivos corporativos gerenciados. Requer a implantação de certificados de cliente por meio de um MDM (por exemplo, Microsoft Intune). A autenticação é silenciosa e altamente segura.
- PEAP-MSCHAPv2: Recomendado para ambientes BYOD onde a implantação de certificados é inviável. Os usuários se autenticam com suas credenciais corporativas.
3. IoT e Multi-Tenant: Cisco Identity PSK (iPSK)
Em ambientes como propriedades Build-to-Rent (BTR), acomodações estudantis ou lojas de varejo com inúmeros dispositivos IoT, implantar o 802.1X é frequentemente impossível porque os dispositivos carecem de suporte a suplicantes. Criar um SSID separado para cada locatário ou tipo de dispositivo causa congestionamento de RF.
O Cisco iPSK resolve isso permitindo múltiplas chaves pré-compartilhadas (PSKs) exclusivas em um único SSID. Quando um dispositivo se associa, o WLC envia seu endereço MAC para o servidor RADIUS da Purple. A Purple retorna a PSK específica para aquele dispositivo junto com atributos de atribuição dinâmica de VLAN, segmentando o tráfego na porta do switch.

Guia de Implementação
Configurando o Redirecionamento do Captive Portal de Visitantes
Para configurar a Autenticação Web Externa no Catalyst 9800 WLC, você 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. Você deve configurar o endereço IPv4 virtual (geralmente 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 acessar o portal da Purple antes de serem autenticados. O 9800 WLC usa filtros de URL para abrir portas dinamicamente na ACL de interceptação com base em snooping de DNS.
urlfilter list PURPLE-PREAUTH
action permit
url portal.purple.ai
Aplique este filtro de URL ao perfil de política da sua WLAN nas configurações de ACL de pré-autenticação.
Configurando a Atribuição Dinâmica de VLAN para iPSK
Para alocar usuários ou dispositivos em VLANs específicas de forma dinâmica, o servidor RADIUS da Purple deve enviar três atributos IETF específicos na resposta Access-Accept [2].
- IETF 64 (Tunnel-Type): Definido como
VLAN(valor 13). - IETF 65 (Tunnel-Medium-Type): Definido como
802(valor 6). - IETF 81 (Tunnel-Private-Group-ID): Definido como o ID da VLAN como uma string (ex.:
"10").
No Catalyst 9800 WLC, certifique-se de que as seguintes configurações estejam aplicadas 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 Camada 2 está definida como WPA2-PSK (a PSK configurada funciona como um fallback).
Melhores Práticas
- Verificação de VLAN: O ID da VLAN retornado pelo servidor RADIUS no
Tunnel-Private-Group-IDDEVE existir como uma interface dinâmica na WLC. Se não existir, a WLC colocará o cliente na VLAN nativa, criando um grave risco de segurança. - Cadeias de Confiança de Certificados: Para implantações EAP-TLS, faça o upload da sua CA Raiz e de quaisquer certificados de CA Intermediária no painel do Purple SecurePass antes de distribuir os certificados de cliente. Se o servidor RADIUS não puder validar a cadeia, a autenticação falhará silenciosamente.
- RADIUS Redundante: Sempre configure servidores RADIUS secundários. Defina o timeout do primário para 3 segundos com 2 tentativas para garantir um failover rápido sem frustrar o usuário.
- Adoção do WPA3: Use WPA3-SAE para redes iPSK onde houver suporte por parte dos dispositivos clientes. Para redes de convidados abertas, implemente WPA3-OWE (Opportunistic Wireless Encryption) para criptografar o tráfego sem exigir uma senha.
Resolução de Problemas e Mitigação de Riscos
| Modo de Falha | Sintoma | Causa Raiz | Mitigação |
|---|---|---|---|
| Loop de Redirecionamento | O dispositivo cliente atualiza constantemente a página do portal cativo sem carregá-la. | A ACL de pré-autenticação ou o filtro de URL não permite o acesso aos endereços IP do portal da Purple. A WLC redireciona o cliente, o cliente tenta carregar a página, a WLC a bloqueia e o 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 seja permitido antes da autenticação. |
| Falha de Fallback do iPSK | Um dispositivo IoT não registrado se conecta à rede, mas recebe o endereço IP incorreto. | O endereço MAC do dispositivo não está no banco de dados RADIUS da Purple. A WLC recorre à PSK global configurada na WLAN e atribui a VLAN padrão. | Audite o endereço MAC no painel da Purple. Certifique-se de que a VLAN padrão atribuída ao perfil de política da WLAN seja uma rede de quarentena restrita, e não a LAN corporativa. |
| Timeout de RADIUS | Os clientes enfrentam longos atrasos para se conectar; os logs da WLC mostram o servidor RADIUS inacessível. | Os firewalls entre a WLC e os endpoints de nuvem do RADIUS da Purple estão bloqueando 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 gerenciamento da WLC para os endereços IP de RADIUS publicados da Purple. |
ROI e Impacto nos Negócios
A implementação de uma arquitetura unificada com Cisco e Purple entrega 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 chamados de TI. A automação do onboarding de IoT via API economiza horas de técnicos por localidade.
- Segurança e Conformidade: A atribuição dinâmica de VLAN garante a conformidade com o PCI-DSS em ambientes de varejo ao isolar estritamente os terminais de pagamento do tráfego de convidados (Requisito 1.3). O EAP-TLS elimina o risco de senhas compartilhadas de funcionários.
- Geração de Receita: A integração com o Captive Portal transforma um centro de custo (Guest WiFi) em um ativo de marketing. A captura de consentimentos conscientes constrói um banco de dados primário que impulsiona campanhas de fidelidade e visitas recorrentes.
Referências
[1] Cisco Systems, "Configure Spaces Captive Portal with Catalyst 9800 WLC," Maio 2025. [2] Cisco Systems, "Configure a RADIUS Server and WLC for Dynamic VLAN Assignment," Setembro 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 hospedado externamente (como o da Purple) para autenticação.
Usado para fornecer páginas de login personalizadas e capturar dados primários sem depender do servidor web interno limitado do WLC.
Identity PSK (iPSK)
Um recurso da Cisco que permite o uso de múltiplas Pre-Shared Keys exclusivas em um único SSID, com cada chave mapeada para um endereço MAC de cliente e VLAN específicos via RADIUS.
Essencial para proteger dispositivos IoT e ambientes multilocatários onde o 802.1X não é suportado, reduzindo a necessidade de múltiplos SSIDs.
AAA Override
Uma configuração de WLAN no Cisco WLC que força o controlador a aceitar os parâmetros de política (como IDs de VLAN ou ACLs) retornados pelo servidor RADIUS, substituindo a 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 senhas.
O padrão ouro para segurança WiFi corporativa de funcionários, exigindo um MDM para implantar certificados de cliente nos dispositivos corporativos.
PEAP-MSCHAPv2
Protected Extensible Authentication Protocol. Um método 802.1X que criptografa o processo de autenticação dentro de um túnel TLS, permitindo que os usuários se autentiquem de forma segura com um nome de usuário e senha.
Usado para redes corporativas de funcionários do tipo BYOD, onde a implantação de certificados de cliente não é viável.
ACL de Pré-Autenticação
Uma Lista de Controle de Acesso (ACL) aplicada a um cliente sem fio antes de sua autenticação, definindo exatamente quais recursos de rede ele pode acessar.
Crucial para portais cativos; deve permitir o DNS e o acesso aos IPs da página de login da Purple, bloqueando todo o restante do 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 retorna 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á direcionado para a VLAN nativa.
WPA3-SAE
Simultaneous Authentication of Equals. O substituto moderno para WPA2-PSK, fornecendo sigilo de encaminhamento e proteção contra ataques de dicionário offline.
Suportado pelo Cisco Catalyst 9800 e Purple RADIUS para proteger redes IoT e de visitantes modernas.
Exemplos práticos
Um hotel de 200 quartos precisa segmentar o tráfego de rede entre hóspedes, funcionários e dispositivos IoT (fechaduras de portas, termostatos) usando um único Cisco Catalyst 9800 WLC, sem criar múltiplos SSIDs que causam congestionamento de RF.
Implante um único SSID usando Cisco iPSK. Registre o endereço MAC de cada dispositivo IoT no painel da Purple, atribuindo cada um à VLAN 30. Configure a WLAN do WLC com filtragem MAC, AAA Override e WPA2-PSK. Quando uma fechadura de porta se associa, o servidor RADIUS da Purple retorna a PSK exclusiva e os atributos IETF 64, 65 e 81 para direcionar dinamicamente o dispositivo para a VLAN 30. Os hóspedes usam um SSID aberto separado com Autenticação Web Externa apontando para o Captive Portal da Purple.
Uma rede de varejo com 80 lojas deve isolar o tráfego dos terminais de pagamento do tráfego WiFi de visitantes para manter a conformidade com o PCI-DSS, gerenciada centralmente via Cisco Catalyst Centre.
Configure o SSID de visitantes com uma ACL de pré-autenticação que descarta explicitamente o tráfego destinado à sub-rede dos terminais de pagamento (VLAN 40). Use iPSK para autenticar os terminais de pagamento, atribuindo-os dinamicamente à VLAN 40 via servidor RADIUS da Purple. O tráfego de visitantes é autenticado através do Captive Portal da Purple e direcionado para a VLAN 10.
Questões práticas
Q1. Você está implantando um Captive Portal em um Catalyst 9800 WLC. Os clientes se associam ao SSID, mas seus navegadores atualizam continuamente a URL da splash page sem nunca carregar o conteúdo. Qual é a causa arquitetônica mais provável?
Dica: Considere o estado do cliente antes que a autenticação seja concluída e qual tráfego é permitido.
Ver resposta modelo
A ACL de pré-autenticação ou o filtro de URL está desconfigurado. Ele está bloqueando 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 alcançar o portal para carregá-lo, gerando um loop de redirecionamento infinito. Você deve permitir explicitamente os endereços IP da Purple ou usar um filtro de URL para o domínio do portal.
Q2. Um dispositivo IoT se autentica com sucesso via iPSK, e o servidor RADIUS da Purple retorna 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 gerência). Por que isso 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á desabilitado nas configuraçõ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 gerência.
Q3. Um local deseja implantar 802.1X para o WiFi da equipe usando o Microsoft Entra ID. Eles não possuem um servidor RADIUS local como o Cisco ISE. Como isso pode ser alcançado usando 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 usar o Purple SecurePass como o servidor RADIUS. A Purple atua como um proxy RADIUS na nuvem, encerrando o túnel EAP-TLS ou PEAP do WLC e encaminhando com segurança a busca de identidade para o Microsoft Entra ID via API/SAML. Nenhum servidor RADIUS local é necessário.
Continue a ler esta série
CommScope Ruckus Integration with Purple WiFi: Setup and Configuration Guide
Este guia de referência técnica fornece um manual de configuração definitivo para integrar arquiteturas CommScope Ruckus com o Purple WiFi. Ele 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 usando Ruckus Dynamic PSK.
Integração de Access Points Allied Telesis com o Purple WiFi
Este guia fornece um manual de configuração abrangente para integrar os access points Allied Telesis Série TQ com o Purple WiFi. Ele aborda o redirecionamento de Captive Portal externo, autenticação RADIUS 802.1X e direcionamento dinâmico de VLAN usando Private Pre-Shared Keys (PPSK) para implantações seguras de múltiplos inquilinos (multi-tenant).
Integração de Access Points Grandstream GWN com Purple WiFi
Este guia de referência técnica detalhado explica como integrar os access points Grandstream GWN com o Guest WiFi e a plataforma de analytics da Purple. Ele abrange a configuração do Captive Portal Grandstream, definições de RADIUS AAA, configuração de walled garden, autenticação segura de funcionários via 802.1X com direcionamento dinâmico de VLAN e segmentação PPSK multi-tenant — fornecendo orientações práticas passo a passo para MSPs e equipes de TI que implantam WiFi para visitantes e funcionários em escala.