Huawei AirEngine and CloudCampus Integration with Purple WiFi
Questa guida fornisce istruzioni dettagliate per l'integrazione degli access point Huawei AirEngine e iMaster NCE-Campus con Purple WiFi. Copre la configurazione del Captive Portal, l'autenticazione del personale tramite 802.1X e il routing dinamico delle VLAN tramite PPSK per le reti aziendali.
Ascolta questa guida
Visualizza trascrizione del podcast
- Executive Summary
- Technical Deep-Dive
- Architecture Overview
- Walled Garden e ACL di Pre-Autenticazione
- Instradamento Dinamico della VLAN e Attributi RADIUS
- Guida all'Implementazione
- Passaggio 1: Configurare il Server Relay RADIUS
- Passaggio 2: Creare l'ACL del Walled Garden
- Passaggio 3: Configurare il Modello URL del Captive Portal
- Passaggio 4: Configurazione del SSID Ospiti
- Best Practice
- Risoluzione dei problemi e mitigazione dei rischi
- Impossibile caricare la pagina di benvenuto
- Errori di Autenticazione Silenti
- Timeout DHCP Dopo l'Autenticazione
- ROI e Impatto sul Business

Executive Summary
Le reti aziendali richiedono hardware affidabile abbinato a una gestione intelligente delle identità. Gli access point Huawei AirEngine e il controller iMaster NCE-Campus offrono connettività ad alta densità, mentre Purple fornisce l'overlay cloud per l'autenticazione, l'analisi e l'applicazione delle policy. Questa guida descrive in dettaglio l'architettura di integrazione richiesta per distribuire il Guest WiFi , il Staff WiFi sicuro e il WiFi multi-tenant utilizzando un unico controller Huawei.
Integrando Huawei CloudCampus con Purple, si sostituiscono i silos di autenticazione disparati con una rete unificata basata sull'identità (Identity-Based Network). Operiamo in oltre 80.000 sedi attive e abbiamo gestito 440 milioni di accessi nel 2024. La nostra piattaforma indipendente dall'hardware si integra nativamente con Huawei tramite protocolli RADIUS e Captive Portal standard. Questa integrazione consente il consenso esplicito (opt-in) per i visitatori, la convalida dei certificati 802.1X per i dipendenti e l'instradamento VLAN dinamico tramite chiavi pre-condivise private (PPSK) per i tenant.
Sia che gestiate uno stadio, un campus universitario o una catena di negozi, questo documento fornisce i passaggi di configurazione esatti, gli attributi RADIUS e le liste di controllo degli accessi (ACL) necessari per proteggere il vostro edge wireless e acquisire dati di prima parte su scala.
Ascolta il podcast del briefing tecnico:
Technical Deep-Dive
L'integrazione si basa su protocolli standard: RADIUS (UDP 1812/1813) per l'autenticazione e l'accounting, e HTTPS (TCP 443) per il reindirizzamento al Captive Portal. iMaster NCE-Campus funge da server di accesso alla rete (NAS) e relay RADIUS, inoltrando le richieste dagli access point AirEngine all'infrastruttura cloud RADIUS di Purple.
Architecture Overview

Purple supporta tre modelli di autenticazione principali sull'hardware Huawei:
- Guest WiFi (Captive Portal): Il traffico non autenticato viene intercettato dal controller Huawei e reindirizzato alla splash page di Purple. L'accesso pre-autenticazione è limitato da una ACL Walled Garden. Una volta completato l'accesso con successo, Purple invia un messaggio di RADIUS Access-Accept, concedendo al client l'accesso completo alla rete.
- Staff WiFi (802.1X): I dipendenti si autenticano utilizzando le credenziali aziendali tramite EAP-PEAP o EAP-TLS. Purple convalida queste credenziali rispetto a provider di identità come Microsoft Entra ID, Okta o Google Workspace.
- WiFi Multi-Tenant (PPSK): gli inquilini si connettono a un singolo SSID condiviso utilizzando passphrase univoche. Purple convalida la passphrase e restituisce attributi RADIUS specifici per indirizzare dinamicamente l'inquilino nella propria VLAN isolata.
Walled Garden e ACL di Pre-Autenticazione
Un Captive Portal richiede un Walled Garden - una Access Control List (ACL) che consenta il traffico verso i servizi essenziali prima che l'utente si autentichi. Se il Walled Garden è incompleto, la splash page non si caricherà, con conseguente scarsa esperienza per il visitatore.
Per Huawei iMaster NCE-Campus, l'ACL di pre-autenticazione deve consentire:
- Risoluzione DNS (UDP 53)
- Domini del Captive Portal di Purple (
*.purpleportal.net,*.purple.ai) - Content Delivery Networks (CDNs) che ospitano le risorse della splash page
- Domini dei provider di identità se l'accesso social (Apple, Google, Facebook) è abilitato
Tutto l'altro traffico deve essere negato fino a quando Purple non restituisce il pacchetto RADIUS Access-Accept.
Instradamento Dinamico della VLAN e Attributi RADIUS
Per isolare il traffico di rete, Purple utilizza l'assegnazione dinamica della VLAN. Invece di trasmettere più SSID, si trasmette un solo SSID e si assegna la VLAN in modo dinamico in base all'identità dell'utente.
Quando Purple autentica un utente (tramite 802.1X o PPSK), restituisce un pacchetto Access-Accept contenente tre attributi RADIUS standard IETF obbligatori:
Tunnel-Type=VLAN(o 13)Tunnel-Medium-Type=802(o 6)Tunnel-Private-Group-ID=[VLAN ID]
Il controller Huawei riceve questi attributi e indica all'access point AirEngine di taggare il traffico del client con l'ID VLAN specificato.

Guida all'Implementazione
Questa sezione illustra i passaggi esatti per configurare iMaster NCE-Campus per l'integrazione con Purple.
Passaggio 1: Configurare il Server Relay RADIUS
Innanzitutto, definire Purple come server di autenticazione esterno.
- In iMaster NCE-Campus, accedere a Design > Network Design > Template Management.
- Selezionare RADIUS Server e fare clic su Create.
- Impostare Authentication service su Portal authentication.
- Inserire gli indirizzi IP RADIUS primario e secondario di Purple (disponibili nella dashboard di Purple).
- Impostare la porta di autenticazione su 1812 e la porta di accounting su 1813.
- Inserire il RADIUS Shared Secret fornito da Purple.
- Impostare NAS identifier su Device MAC.
Passaggio 2: Creare l'ACL del Walled Garden
Creare l'ACL per consentire il traffico di pre-autenticazione.
- Accedere a Design > Network Design > Template Management > ACL.
- Creare una nuova ACL denominata
Purple_Walled_Garden. - Impostare ACL Type su User.
- Aggiungere regole di autorizzazione (permit) per il DNS e i domini richiesti da Purple (ad es.
*.purpleportal.net). - Salvare il modello ACL.
Passaggio 3: Configurare il Modello URL del Captive Portal
Huawei richiede un modello URL per mappare i parametri di reindirizzamento standard nel formato richiesto da Purple.
- Passare a Design > Network Design > Template Management > URL Template.
- Creare un nuovo modello denominato
Purple_URL_Template. - Impostare il Template Type su Cloud platform-based relay authentication.
- Configurare la mappatura dei parametri esattamente come segue:
redirect-urlmappa suredirect-urlloginurlmappa sulogin-urldevice-macmappa suap-macuser-ipmappa suuaddressuser-macmappa suumacssidmappa sussid
Passaggio 4: Configurazione del SSID Ospiti
Associare il server RADIUS, l'ACL e il modello URL al SSID.
- Passare a Provision > Device Configuration > Site Configuration.
- Selezionare AP e creare un nuovo SSID.
- Impostare il Network Type su Open.
- Selezionare Open+Portal authentication.
- Impostare il tipo di autenticazione su Relay authentication by cloud platform.
- Impostare la modalità di interconnessione su RADIUS relay.
- Selezionare il
Purple_URL_Templatecreato in precedenza. - Nel campo dell'URL di autenticazione di terze parti, incollare l'URL univoco della pagina di benvenuto di Purple.
- Selezionare il modello di server RADIUS Purple.
- Selezionare l'ACL
Purple_Walled_Gardenper la regola di autorizzazione predefinita. - Salvare e distribuire la configurazione agli access point AirEngine.
Best Practice
Per garantire una distribuzione sicura e affidabile, seguire queste best practice indipendenti dal fornitore:
- Implementare 802.1X per i dipendenti: Non utilizzare mai PSK condivise per le reti del personale. Distribuire 802.1X con EAP-TLS utilizzando l'add-on SecurePass di Purple per emettere certificati client. Ciò elimina i vettori di phishing basati su password e si allinea ai requisiti ISO 27001.
- Consolidare gli SSID: La trasmissione di troppi SSID riduce l'efficienza del tempo di trasmissione radio a causa del sovraccarico dei frame di gestione. Utilizzare PPSK e l'instradamento VLAN dinamico per consolidare le reti multi-tenant in un unico SSID.
- Verificare le configurazioni dei Trunk: L'assegnazione dinamica della VLAN non va a buon fine in modo silenzioso se la VLAN assegnata non è consentita sulla porta trunk dello switch che collega l'access point. Verificare sempre le configurazioni delle porte dello switch prima di testare l'instradamento RADIUS.
- Monitorare la latenza RADIUS: I timeout di autenticazione spesso derivano dalla latenza WAN. Assicurarsi che il controller iMaster NCE-Campus disponga di un percorso a bassa latenza verso l'infrastruttura RADIUS regionale di Purple.
Risoluzione dei problemi e mitigazione dei rischi
Quando si integra il RADIUS cloud con i controller aziendali, i problemi in genere si isolano in tre aree: il Walled Garden, il segreto condiviso RADIUS o il trunking VLAN.
Impossibile caricare la pagina di benvenuto
Sintomo: Un dispositivo si connette al WiFi ospiti, ma il browser mostra un errore di timeout invece della pagina di benvenuto di Purple.
Causa principale: L'ACL del Walled Garden è incompleta, bloccando l'accesso ai domini del portale di Purple o alle CDN richieste.
Mitigation: Connettere un dispositivo di test all'SSID. Tentare un ping a purpleportal.net. Se il ping fallisce, verificare la configurazione dell'ACL di iMaster NCE-Campus e assicurarsi che sia applicata allo stato di pre-autenticazione dell'SSID.
Errori di Autenticazione Silenti
Sintomo: Un utente inserisce credenziali valide, ma la connessione si interrompe senza alcun messaggio di errore. Causa principale: Una mancata corrispondenza nel segreto condiviso RADIUS tra iMaster NCE-Campus e Purple. Mitigation: Copiare il segreto condiviso direttamente dalla dashboard di Purple e incollarlo nel modello del server RADIUS Huawei. Un singolo spazio finale interromperà l'hash MD5 utilizzato nei pacchetti RADIUS.
Timeout DHCP Dopo l'Autenticazione
Sintomo: Un membro dello staff si autentica correttamente tramite 802.1X, ma il dispositivo riceve un indirizzo APIPA 169.254.x.x invece di un IP valido.
Causa principale: Purple ha assegnato con successo una VLAN dinamica tramite RADIUS, ma tale VLAN non è configurata in trunk verso l'access point AirEngine.
Mitigation: Accedere allo switch di accesso e verificare che il comando port trunk allow-pass vlan includa l'ID della VLAN di destinazione sull'interfaccia connessa all'AP.
ROI e Impatto sul Business
La distribuzione di Huawei AirEngine con Purple trasforma un'infrastruttura di rete standard in una risorsa aziendale misurabile.
Per gli operatori del settore Retail , questa integrazione acquisisce dati di prima parte dagli acquirenti, consentendo campagne di marketing mirate che aumentano l'affluenza e il valore medio delle transazioni. La dashboard di WiFi Analytics di Purple fornisce mappe di calore e metriche sul tempo di permanenza, consentendo ai gestori dei locali di ottimizzare il layout dei negozi in base al comportamento effettivo dei visitatori.
Negli ambienti Hospitality , l'autenticazione automatica tramite OpenRoaming o Passpoint elimina l'attrito dei login manuali, aumentando i punteggi di soddisfazione degli ospiti. Per gli edifici multi-tenant, il routing dinamico delle VLAN tramite PPSK riduce i costi di gestione IT eliminando la necessità di configurare e gestire manualmente SSID separati per ogni nuovo inquilino.
Unificando il coinvolgimento degli ospiti, la sicurezza del personale e l'isolamento degli inquilini su un'unica infrastruttura hardware, le organizzazioni massimizzano il ritorno sull'investimento in Huawei CloudCampus.
Definizioni chiave
iMaster NCE-Campus
La piattaforma di automazione e gestione della rete di Huawei, basata su cloud o on-premises.
I team IT utilizzano questo strumento come controller centrale per configurare gli SSID, inviare policy agli AP AirEngine e configurare il relay RADIUS verso Purple.
PPSK (Private Pre-Shared Key)
Una funzionalità di sicurezza che consente di utilizzare più password univoche su un singolo SSID, associando ogni password dell'utente a una policy di rete o VLAN specifica.
Essenziale per ambienti multi-tenant (come spazi di coworking o parchi commerciali) in cui i locatari necessitano di reti isolate senza trasmettere decine di SSID.
Dynamic VLAN Steering
Il processo di assegnazione di un dispositivo a una specifica Virtual Local Area Network in base alla sua identità autenticata, anziché all'SSID a cui si è connesso.
Utilizzato da Purple per garantire che un manager, un cassiere e un ospite che si connettono allo stesso access point fisico siano inseriti in segmenti di rete completamente separati e sicuri.
Walled Garden
Una Access Control List (ACL) applicata agli utenti non autenticati, che consente l'accesso solo a indirizzi IP o domini specifici necessari per completare il processo di login.
Se il Walled Garden è configurato in modo errato, gli ospiti visualizzeranno una schermata vuota o un errore di timeout invece della splash page di Purple.
RADIUS Relay
Una configurazione in cui il controller di rete locale inoltra le richieste di autenticazione dagli access point a un server RADIUS esterno.
Huawei iMaster NCE-Campus funge da relay, trasmettendo in modo sicuro le credenziali dalla sede all'infrastruttura cloud di Purple per la convalida.
802.1X
Uno standard IEEE per il controllo dell'accesso alla rete basato su porte che fornisce un meccanismo di autenticazione ai dispositivi che desiderano connettersi a una LAN o WLAN.
Lo standard aziendale per il WiFi del personale. Sostituisce le password condivise con credenziali utente individuali o certificati digitali.
EAP-TLS
Extensible Authentication Protocol - Transport Layer Security. Un metodo di autenticazione 802.1X che si basa su certificati client e server anziché su password.
Il metodo di autenticazione più sicuro disponibile. SecurePass di Purple rilascia questi certificati ai dispositivi dei dipendenti per eliminare i rischi di phishing.
Captive Portal
Una pagina web che un utente di una rete ad accesso pubblico è obbligato a visualizzare e con cui deve interagire prima che venga concesso l'accesso.
Il meccanismo principale utilizzato da Purple per raccogliere dati di prima parte e il consenso da parte dei visitatori della sede.
Esempi pratici
Un hotel di 200 camere deve fornire un servizio WiFi sicuro e isolato per ospiti, personale e una caffetteria esterna che opera nella hall, utilizzando solo due SSID per preservare il tempo di trasmissione (airtime).
Configurare un SSID denominato "Hotel_Guest" con una policy di autenticazione Open+Portal che reindirizza al Captive Portal di Purple. Configurare un secondo SSID denominato "Hotel_Secure" con autenticazione WPA3-Enterprise e 802.1X. Il personale si autentica tramite EAP-TLS e Purple restituisce un attributo RADIUS che lo assegna alla VLAN 20. La caffetteria utilizza il protocollo PPSK sullo stesso SSID "Hotel_Secure"; inserendo una passphrase univoca, Purple restituisce un attributo RADIUS che la assegna alla VLAN 30.
Una grande catena di vendita al dettaglio sta migrando a Huawei AirEngine e deve garantire che la pagina di benvenuto (splash page) esistente di Purple si carichi correttamente in tutti i negozi, senza attivare avvisi di sicurezza sui moderni smartphone.
Configurare il modello di URL di iMaster NCE-Campus per mappare con precisione i parametri richiesti (ap-mac, uaddress, umac, ssid, redirect-url). Creare una ACL di Walled Garden completa che consenta il traffico DNS (UDP 53) e HTTPS (TCP 443) verso i domini di Purple e le API di login social necessarie. Assicurarsi che il controller intercetti il traffico HTTP e lo reindirizzi alla splash page HTTPS.
Domande di esercitazione
Q1. Hai configurato l'SSID Guest e l'ACL Walled Garden su iMaster NCE-Campus. Quando testi la connessione, il tuo telefono rileva il Captive Portal, ma lo schermo rimane vuoto. Qual è la causa più probabile?
Suggerimento: Considera ciò di cui il dispositivo ha bisogno per caricare una pagina web moderna ospitata su una piattaforma cloud.
Visualizza risposta modello
È probabile che nell'ACL Walled Garden manchino le regole di autorizzazione per i domini richiesti. Nello specifico, deve essere consentito il DNS (UDP 53), insieme all'accesso HTTPS ai domini del portale di Purple e a qualsiasi Content Delivery Network (CDN) che ospita le risorse della pagina. Se l'accesso tramite social è abilitato, anche i relativi endpoint API specifici devono essere autorizzati prima dell'autenticazione.
Q2. Un tenant che utilizza la tua rete PPSK lamenta di non riuscire a raggiungere internet. Controlli i log di iMaster NCE-Campus e vedi che Purple ha restituito un RADIUS Access-Accept con Tunnel-Private-Group-ID impostato su 40. Tuttavia, il dispositivo client ha un indirizzo IP pari a 169.254.x.x. Qual è l'errore di configurazione?
Suggerimento: L'autenticazione è andata a buon fine, ma il routing di rete è fallito all'edge.
Visualizza risposta modello
La porta dello switch che collega l'access point Huawei AirEngine alla rete non è configurata per il trunking della VLAN 40. Sebbene Purple abbia autorizzato con successo l'utente e il controller abbia istruito l'AP a taggare il traffico con la VLAN 40, lo switch a monte ha scartato i pacchetti perché la VLAN non è consentita sul trunk. È necessario aggiungere la VLAN 40 all'elenco allow-pass del trunk sullo switch di accesso.
Q3. Stai migrando da un controller legacy a Huawei iMaster NCE-Campus. Configuri il modello di server RADIUS esattamente come era sul vecchio sistema, ma tutte le richieste di autenticazione falliscono silenziosamente. Cosa dovresti verificare per primo?
Suggerimento: I fallimenti silenziosi in RADIUS indicano solitamente una mancata corrispondenza crittografica.
Visualizza risposta modello
Verifica il RADIUS Shared Secret. Se il segreto configurato in iMaster NCE-Campus non corrisponde perfettamente a quello presente nella dashboard di Purple, i pacchetti RADIUS non possono essere decifrati, causando fallimenti silenziosi o messaggi di Access-Reject senza codici di errore chiari. Assicurati che non ci siano spazi finali quando copi il segreto.
Continua a leggere questa serie
Integrazione di CommScope Ruckus con Purple WiFi: Guida alla Configurazione e all'Installazione
Questa guida di riferimento tecnico fornisce un manuale di configurazione autorevole per l'integrazione delle architetture CommScope Ruckus con Purple WiFi. Dettaglia passo dopo passo le implementazioni per i Captive Portal per Guest WiFi, il WiFi aziendale sicuro per il personale tramite 802.1X e l'isolamento di rete Multi-Tenant utilizzando Ruckus Dynamic PSK.
Integrazione degli Access Point Allied Telesis con Purple WiFi
Questa guida fornisce un playbook di configurazione completo per integrare gli access point Allied Telesis serie TQ con Purple WiFi. Copre il reindirizzamento al Captive Portal esterno, l'autenticazione RADIUS 802.1X e lo steering dinamico delle VLAN utilizzando le chiavi PPSK (Private Pre-Shared Keys) per implementazioni multi-tenant sicure.
Integrazione degli Access Point Grandstream GWN con Purple WiFi
Questa guida tecnica di riferimento dettagliata spiega come integrare gli access point Grandstream GWN con la piattaforma di Guest WiFi e analytics di Purple. Copre la configurazione del Captive Portal Grandstream, le impostazioni RADIUS AAA, la configurazione del walled garden, l'autenticazione sicura del personale tramite 802.1X con instradamento VLAN dinamico e la segmentazione PPSK multi-tenant, offrendo una guida pratica e passo dopo passo per MSP e team IT che implementano WiFi per ospiti e personale su larga scala.