Integração do Huawei AirEngine e CloudCampus com o Purple WiFi
Este guia fornece instruções passo a passo para integrar os access points Huawei AirEngine e o iMaster NCE-Campus com o Purple WiFi. Ele aborda a configuração de Captive Portal, autenticação de funcionários via 802.1X e direcionamento dinâmico de VLAN por PPSK para redes corporativas.
Ouça este guia
Ver transcrição do podcast
- Resumo Executivo
- Aprofundamento Técnico
- Visão Geral da Arquitetura
- Walled Garden e ACLs de Pré-Autenticação
- Direcionamento Dinâmico de VLAN e Atributos RADIUS
- Guia de Implantação
- Passo 1: Configurar o Servidor de Relay RADIUS
- Passo 2: Criar a ACL de Walled Garden
- Passo 3: Configurar o Modelo de URL do Captive Portal
- Etapa 4: Provisionar o SSID de Visitantes
- Melhores Práticas
- Resolução de Problemas e Mitigação de Riscos
- A Splash Page Falha ao Carregar
- Falhas Silenciosas de Autenticação
- Timeout de DHCP Após a Autenticação
- Retorno sobre o Investimento (ROI) e Impacto nos Negócios

Resumo Executivo
As redes corporativas exigem hardware confiável combinado com gerenciamento inteligente de identidade. Os access points Huawei AirEngine e o controlador iMaster NCE-Campus oferecem conectividade de alta densidade, enquanto a Purple fornece a sobreposição em nuvem (cloud overlay) para autenticação, análise e aplicação de políticas. Este guia detalha a arquitetura de integração necessária para implantar WiFi de Visitantes , WiFi seguro para funcionários e WiFi multi-tenant usando um único controlador Huawei.
Ao integrar o Huawei CloudCampus com a Purple, você substitui silos de autenticação distintos por uma Rede Baseada em Identidade unificada. Operamos em mais de 80.000 locais ativos e processamos 440 milhões de logins em 2024. Nossa plataforma agnóstica de hardware se integra nativamente com a Huawei por meio de protocolos padrão RADIUS e Captive Portal. Essa integração permite opt-ins de escolha consciente para visitantes, validação de certificados 802.1X para funcionários e direcionamento dinâmico de VLAN via Private Pre-Shared Keys (PPSK) para locatários.
Quer você gerencie um estádio, um campus universitário ou uma rede de varejo, este documento fornece as etapas exatas de configuração, atributos RADIUS e listas de controle de acesso necessários para proteger sua borda sem fio e capturar dados primários (first-party data) em escala.
Ouça o podcast de briefing técnico:
Aprofundamento Técnico
A integração depende de protocolos padrão: RADIUS (UDP 1812/1813) para autenticação e bilhetagem (accounting), e HTTPS (TCP 443) para redirecionamento de Captive Portal. O iMaster NCE-Campus atua como o servidor de acesso à rede (NAS) e relay RADIUS, encaminhando solicitações dos access points AirEngine para a infraestrutura RADIUS em nuvem da Purple.
Visão Geral da Arquitetura

A Purple suporta três modelos principais de autenticação no hardware da Huawei:
- WiFi de Visitantes (Captive Portal): O tráfego não autenticado é interceptado pelo controlador Huawei e redirecionado para a splash page da Purple. O acesso antes da autenticação é restrito por uma ACL de Walled Garden. Após o login bem-sucedido, a Purple envia um Access-Accept do RADIUS, concedendo ao cliente acesso total à rede.
- WiFi de Funcionários (802.1X): Os funcionários se autenticam usando credenciais corporativas via EAP-PEAP ou EAP-TLS. A Purple valida essas credenciais em relação a provedores de identidade como Microsoft Entra ID, Okta ou Google Workspace.
- WiFi Multi-Tenant (PPSK): Os locatários se conectam a um único SSID compartilhado usando senhas exclusivas. A Purple valida a senha e retorna atributos RADIUS específicos para direcionar dinamicamente o locatário para sua VLAN isolada.
Walled Garden e ACLs de Pré-Autenticação
Um Captive Portal requer um Walled Garden — uma Lista de Controle de Acesso (ACL) que permite o tráfego para serviços essenciais antes que o usuário se autentique. Se o Walled Garden estiver incompleto, a splash page não será carregada, resultando em uma experiência ruim para o visitante.
Para o Huawei iMaster NCE-Campus, a ACL de pré-autenticação deve permitir:
- Resolução de DNS (UDP 53)
- Domínios de Captive Portal da Purple (
*.purpleportal.net,*.purple.ai) - Redes de Distribuição de Conteúdo (CDNs) que hospedam recursos da splash page
- Domínios de provedores de identidade se o login social (Apple, Google, Facebook) estiver ativado
Todo o outro tráfego deve ser negado até que a Purple retorne o Access-Accept do RADIUS.
Direcionamento Dinâmico de VLAN e Atributos RADIUS
Para isolar o tráfego de rede, a Purple usa a atribuição dinâmica de VLAN. Em vez de transmitir vários SSIDs, você transmite um único SSID e atribui a VLAN dinamicamente com base na identidade do usuário.
Quando a Purple autentica um usuário (via 802.1X ou PPSK), ela retorna um pacote Access-Accept contendo três atributos RADIUS padrão IETF obrigatórios:
Tunnel-Type=VLAN(ou 13)Tunnel-Medium-Type=802(ou 6)Tunnel-Private-Group-ID=[VLAN ID]
O controlador Huawei recebe esses atributos e instrui o access point AirEngine a marcar o tráfego do cliente com o ID da VLAN especificado.

Guia de Implantação
Esta seção aborda as etapas exatas para configurar o iMaster NCE-Campus para a integração com a Purple.
Passo 1: Configurar o Servidor de Relay RADIUS
Primeiro, defina a Purple como o servidor de autenticação externo.
- No iMaster NCE-Campus, navegue até Design > Network Design > Template Management.
- Selecione RADIUS Server e clique em Create.
- Defina o Authentication service como Portal authentication.
- Insira os endereços IP primário e secundário do RADIUS da Purple (disponíveis no painel da Purple).
- Defina a porta de autenticação como 1812 e a porta de bilhetagem (accounting) como 1813.
- Insira o Segredo Compartilhado (Shared Secret) do RADIUS fornecido pela Purple.
- Defina o NAS identifier como Device MAC.
Passo 2: Criar a ACL de Walled Garden
Crie a ACL para permitir o tráfego antes da autenticação.
- Navegue até Design > Network Design > Template Management > ACL.
- Crie uma nova ACL chamada
Purple_Walled_Garden. - Defina o ACL Type como User.
- Adicione regras de permissão para DNS e domínios necessários da Purple (por exemplo,
*.purpleportal.net). - Salve o modelo de ACL.
Passo 3: Configurar o Modelo de URL do Captive Portal
A Huawei exige um modelo de URL para mapear os parâmetros de redirecionamento padrão para o formato exigido pela Purple.
- Navegue até Design > Network Design > Template Management > URL Template.
- Crie um novo modelo chamado
Purple_URL_Template. - Defina o Template Type como Cloud platform-based relay authentication.
- Configure o mapeamento de parâmetros exatamente como a seguir:
redirect-urlmapeia pararedirect-urlloginurlmapeia paralogin-urldevice-macmapeia paraap-macuser-ipmapeia parauaddressuser-macmapeia paraumacssidmapeia parassid
Etapa 4: Provisionar o SSID de Visitantes
Vincule o servidor RADIUS, ACL e o template de URL ao SSID.
- Navegue até Provision > Device Configuration > Site Configuration.
- Selecione AP e crie um novo SSID.
- Defina o Network Type como Open.
- Selecione Open+Portal authentication.
- Defina o tipo de autenticação como Relay authentication by cloud platform.
- Defina o modo de interconexão como RADIUS relay.
- Selecione o
Purple_URL_Templatecriado anteriormente. - No campo de URL de autenticação de terceiros, cole a URL exclusiva da sua splash page do Purple.
- Selecione o template de servidor RADIUS do Purple.
- Selecione a ACL
Purple_Walled_Gardenpara a regra de permissão padrão. - Salve e implante a configuração nos pontos de acesso AirEngine.
Melhores Práticas
Para garantir uma implantação segura e confiável, siga estas melhores práticas neutras de fornecedor:
- Implemente 802.1X para Funcionários: Nunca use PSKs compartilhadas para redes de funcionários. Implante 802.1X com EAP-TLS usando o add-on SecurePass do Purple para emitir certificados de cliente. Isso elimina vetores de phishing baseados em senha e se alinha aos requisitos da ISO 27001.
- Consolide SSIDs: A transmissão de muitos SSIDs degrada a eficiência do tempo de transmissão (airtime) devido à sobrecarga de frames de gerenciamento. Use PPSK e direcionamento dinâmico de VLAN para consolidar redes multi-tenant em um único SSID.
- Verifique as Configurações de Trunk: A atribuição dinâmica de VLAN falha silenciosamente se a VLAN atribuída não for permitida na porta trunk do switch que conecta o ponto de acesso. Sempre audite as configurações de switchport antes de testar o direcionamento RADIUS.
- Monitore a Latência do RADIUS: Os limites de tempo (timeouts) de autenticação geralmente decorrem da latência da WAN. Certifique-se de que seu controlador iMaster NCE-Campus tenha um caminho de baixa latência para a infraestrutura RADIUS regional do Purple.
Resolução de Problemas e Mitigação de Riscos
Ao integrar o RADIUS em nuvem com controladores corporativos, os problemas normalmente se isolam em três áreas: o Walled Garden, o segredo compartilhado (shared secret) do RADIUS ou o trunking de VLAN.
A Splash Page Falha ao Carregar
Sintoma: Um dispositivo se conecta ao WiFi de Visitantes, mas o navegador exibe um erro de timeout em vez da splash page do Purple.
Causa Raiz: A ACL do Walled Garden está incompleta, bloqueando o acesso aos domínios do portal do Purple ou às CDNs necessárias.
Mitigação: Conecte um dispositivo de teste ao SSID. Tente pingar purpleportal.net. Se o ping falhar, revise a configuração de ACL do iMaster NCE-Campus e garanta que ela seja aplicada ao estado de pré-autenticação do SSID.
Falhas Silenciosas de Autenticação
Sintoma: Um usuário insere credenciais válidas, mas a conexão cai sem uma mensagem de erro. Causa Raiz: Uma incompatibilidade no segredo compartilhado (shared secret) do RADIUS entre o iMaster NCE-Campus e o Purple. Mitigação: Copie o segredo compartilhado diretamente do painel do Purple e cole-o no template de servidor RADIUS da Huawei. Um único espaço em branco no final quebrará o hash MD5 usado nos pacotes RADIUS.
Timeout de DHCP Após a Autenticação
Sintoma: Um membro da equipe se autentica com sucesso via 802.1X, mas o dispositivo recebe um endereço APIPA 169.254.x.x em vez de um IP válido.
Causa Raiz: O Purple atribuiu com sucesso uma VLAN dinâmica via RADIUS, mas essa VLAN não está em trunk para o ponto de acesso AirEngine.
Mitigação: Faça login no switch de acesso e verifique se o comando port trunk allow-pass vlan inclui o ID da VLAN de destino na interface conectada ao AP.
Retorno sobre o Investimento (ROI) e Impacto nos Negócios
A implantação do Huawei AirEngine com o Purple transforma uma infraestrutura de rede padrão em um ativo de negócios mensurável.
Para operadores de Varejo , essa integração captura dados primários (first-party data) dos compradores, permitindo campanhas de marketing direcionadas que atraem visitantes e aumentam o valor médio das transações. O painel de WiFi Analytics do Purple fornece mapas de calor e métricas de tempo de permanência, permitindo que os gerentes de estabelecimentos otimizem o layout das lojas com base no comportamento real dos visitantes.
Em ambientes de Hospitalidade , a autenticação automatizada via OpenRoaming ou Passpoint elimina o atrito dos logins manuais, aumentando as pontuações de satisfação dos hóspedes. Para edifícios multi-tenant, o direcionamento dinâmico de VLAN por PPSK reduz a sobrecarga de TI, eliminando a necessidade de provisionar e gerenciar manualmente SSIDs separados para cada novo locatário.
Ao unificar o engajamento de visitantes, a segurança da equipe e o isolamento de locatários em uma única infraestrutura de hardware, organizações maximizam o retorno sobre seu investimento no Huawei CloudCampus.
Definições principais
iMaster NCE-Campus
A plataforma de automação e gerenciamento de rede baseada em nuvem ou local da Huawei.
As equipes de TI usam isso como o controlador central para configurar SSIDs, aplicar políticas aos APs AirEngine e configurar o relay RADIUS para a Purple.
PPSK (Private Pre-Shared Key)
Um recurso de segurança que permite o uso de várias senhas exclusivas em um único SSID, com cada senha vinculando o usuário a uma política de rede ou VLAN específica.
Essencial para ambientes multi-tenant (como espaços de coworking ou centros comerciais) onde os locatários precisam de redes isoladas sem a transmissão de dezenas de SSIDs.
Dynamic VLAN Steering
O processo de atribuição de um dispositivo a uma Rede Local Virtual (VLAN) específica com base em sua identidade autenticada, em vez do SSID ao qual ele se conectou.
Usado pela Purple para garantir que um gerente, um caixa e um convidado que se conectam ao mesmo access point físico sejam colocados em segmentos de rede totalmente separados e seguros.
Walled Garden
Uma Lista de Controle de Acesso (ACL) aplicada a usuários não autenticados, permitindo o acesso apenas a endereços IP ou domínios específicos necessários para concluir o processo de login.
Se o Walled Garden estiver mal configurado, os visitantes verão uma tela em branco ou um erro de tempo limite em vez da splash page da Purple.
RADIUS Relay
Uma configuração na qual o controlador de rede local encaminha solicitações de autenticação dos access points para um servidor RADIUS externo.
O Huawei iMaster NCE-Campus atua como o relay, transmitindo credenciais com segurança do local para a infraestrutura em nuvem da Purple para validação.
802.1X
Um padrão IEEE para controle de acesso à rede baseado em porta que fornece um mecanismo de autenticação para dispositivos que desejam se conectar a uma LAN ou WLAN.
O padrão corporativo para WiFi de funcionários. Ele substitui senhas compartilhadas por credenciais de usuário individuais ou certificados digitais.
EAP-TLS
Extensible Authentication Protocol - Transport Layer Security. Um método de autenticação 802.1X que depende de certificados de cliente e servidor em vez de senhas.
O método de autenticação mais seguro disponível. O SecurePass da Purple emite esses certificados para dispositivos de funcionários para eliminar riscos de phishing.
Captive Portal
Uma página da web que um usuário de uma rede de acesso público é obrigado a visualizar e interagir antes que o acesso seja concedido.
O principal mecanismo que a Purple usa para capturar dados primários (first-party data) e consentimento dos visitantes do local.
Exemplos práticos
Um hotel de 200 quartos precisa fornecer WiFi seguro e isolado para hóspedes, funcionários e uma cafeteria terceirizada que opera no lobby, usando apenas dois SSIDs para preservar o tempo de transmissão (airtime).
Implante um SSID chamado 'Hotel_Guest' configurado com uma política de autenticação Open+Portal apontando para o Captive Portal da Purple. Implante um segundo SSID chamado 'Hotel_Secure' configurado com autenticação WPA3-Enterprise e 802.1X. Os funcionários se autenticam via EAP-TLS, e a Purple retorna um atributo RADIUS atribuindo-os à VLAN 20. A cafeteria usa PPSK no mesmo SSID 'Hotel_Secure'; eles inserem uma senha exclusiva e a Purple retorna um atributo RADIUS atribuindo-os à VLAN 30.
Uma grande rede de varejo está migrando para o Huawei AirEngine e precisa garantir que sua página de login (splash page) existente da Purple seja carregada corretamente em todas as lojas, sem acionar avisos de segurança em smartphones modernos.
Configure o modelo de URL do iMaster NCE-Campus para mapear os parâmetros necessários (ap-mac, uaddress, umac, ssid, redirect-url) com precisão. Crie uma ACL de Walled Garden abrangente que permita o tráfego DNS (UDP 53) e HTTPS (TCP 443) para os domínios da Purple e quaisquer APIs de login social necessárias. Certifique-se de que o controlador intercepte o tráfego HTTP e o redirecione para a splash page HTTPS.
Questões práticas
Q1. Você configurou o SSID de Visitantes e a ACL de Walled Garden no iMaster NCE-Campus. Ao testar a conexão, seu telefone detecta o Captive Portal, mas a tela permanece em branco. Qual é a causa mais provável?
Dica: Considere o que o dispositivo precisa para carregar uma página da web moderna hospedada em uma plataforma de nuvem.
Ver resposta modelo
A ACL do Walled Garden provavelmente não possui regras de permissão para os domínios necessários. Especificamente, o DNS (UDP 53) deve ser permitido, juntamente com o acesso HTTPS aos domínios do portal da Purple e a quaisquer Redes de Distribuição de Conteúdo (CDNs) que hospedem os recursos da página. Se o login social estiver ativado, esses endpoints de API específicos também deverão ser permitidos antes da autenticação.
Q2. Um locatário que usa sua rede PPSK reclama que não consegue acessar a internet. Você verifica os logs do iMaster NCE-Campus e vê que a Purple retornou um Access-Accept do RADIUS com o Tunnel-Private-Group-ID definido como 40. No entanto, o dispositivo cliente tem um endereço IP de 169.254.x.x. Qual é o erro de configuração?
Dica: A autenticação foi bem-sucedida, mas o roteamento de rede falhou na borda.
Ver resposta modelo
A porta do switch que conecta o access point Huawei AirEngine à rede não está configurada para trunking da VLAN 40. Embora a Purple tenha autorizado o usuário com sucesso e o controlador tenha instruído o AP a marcar o tráfego com a VLAN 40, o switch upstream descartou os pacotes porque a VLAN não é permitida no trunk. Você deve adicionar a VLAN 40 à lista de permissões (allow-pass) do trunk no switch de acesso.
Q3. Você está migrando de um controlador legado para o Huawei iMaster NCE-Campus. Você configura o modelo de servidor RADIUS exatamente como estava no sistema antigo, mas todas as solicitações de autenticação falham silenciosamente. O que você deve verificar primeiro?
Dica: Falhas silenciosas no RADIUS geralmente indicam uma incompatibilidade criptográfica.
Ver resposta modelo
Verifique o Segredo Compartilhado (Shared Secret) do RADIUS. Se o segredo configurado no iMaster NCE-Campus não corresponder perfeitamente ao segredo no painel da Purple, os pacotes RADIUS não poderão ser descriptografados, resultando em falhas silenciosas ou mensagens de Access-Reject sem códigos de erro claros. Certifique-se de que não haja espaços extras ao copiar o segredo.
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.