Integrazione di Cambium Networks cnPilot e cnMaestro con Purple WiFi
Questa guida autorevole descrive in dettaglio l'integrazione degli access point Cambium Networks cnPilot e del cloud controller cnMaestro con la piattaforma di intelligence Purple WiFi. Copre l'architettura, la configurazione del Captive Portal, i requisiti di walled garden, il WiFi per il personale 802.1X e la segmentazione dinamica delle VLAN tramite Cambium ePSK per ambienti multi-tenant.
Ascolta questa guida
Visualizza trascrizione del podcast
- Executive Summary
- Technical Deep-Dive
- Integration Architecture
- Walled Garden Requirements
- Multi-Tenant Segmentation with Cambium ePSK
- Implementation Guide
- 1. Configure the Guest WLAN
- 2. Enable the External Hotspot
- 3. Configure RADIUS Authentication and Accounting
- 4. Define the Walled Garden
- 5. Configure 802.1X for Staff WiFi
- Best Practice
- Risoluzione dei problemi e mitigazione dei rischi
- ROI e impatto sul business

Executive Summary
Per le sedi aziendali che si standardizzano sull'infrastruttura Cambium Networks, l'implementazione di una soluzione WiFi per gli ospiti di livello di produzione richiede una stretta integrazione tra il livello di accesso wireless e la piattaforma di gestione delle identità. Questa guida fornisce un modello definitivo per l'integrazione degli access point Cambium cnPilot e del cloud controller cnMaestro con Purple WiFi. Combinando l'hardware scalabile di Cambium con il Captive Portal, l'autenticazione RADIUS e le funzionalità di analisi di Purple, i team IT possono trasformare le loro reti wireless da un centro di costo in un asset strategico. L'architettura qui dettagliata supporta qualsiasi scenario, dall'accesso ospiti di base alla complessa segmentazione multi-tenant tramite le chiavi pre-condivise private (PPSK) di Cambium, offrendo una connettività sicura, conforme e ricca di dati in ambienti alberghieri, commerciali e del settore pubblico.
Technical Deep-Dive
L'integrazione tra Cambium Networks e Purple si basa sul reindirizzamento HTTP standard e sui protocolli RADIUS. Questo approccio indipendente dal fornitore garantisce una sicurezza robusta, compatibilità multipiattaforma e gestione centralizzata tramite cnMaestro.
Integration Architecture
Il meccanismo principale prevede un reindirizzamento al Captive Portal gestito dall'AP Cambium, abbinato all'autenticazione RADIUS gestita da Purple.

Quando un dispositivo ospite si associa a un SSID ospiti aperto, l'AP Cambium intercetta la richiesta HTTP iniziale. Invece di instradare il traffico verso Internet, l'AP reindirizza il dispositivo all'URL del Captive Portal ospitato da Purple. L'ospite completa il flusso di autenticazione sulla splash page di Purple, che supporta il social login, la registrazione via e-mail e moduli di acquisizione dati personalizzati.
In caso di autenticazione riuscita, il backend di Purple invia un messaggio RADIUS di Access-Accept all'AP Cambium sulla porta UDP 1812. Questo messaggio segnala all'AP di far passare il dispositivo client dallo stato di walled garden pre-autenticazione al pieno accesso alla rete. Contemporaneamente, l'AP invia i dati di RADIUS accounting a Purple sulla porta UDP 1813, popolando le dashboard di analisi di Purple con informazioni sulla durata della sessione, sull'utilizzo dei dati e sul tipo di dispositivo.
Walled Garden Requirements
Il walled garden è un componente critico del flusso del Captive Portal. Definisce gli indirizzi IP e i domini specifici che un dispositivo non autenticato può raggiungere. Se il walled garden è configurato in modo errato, il dispositivo non può caricare il portale Purple, con conseguente timeout di connessione.
Affinché l'integrazione funzioni, the walled garden deve includere i domini del portale di Purple, tutti gli endpoint della Content Delivery Network (CDN) che ospitano le risorse del portale e i domini di tutti i provider di identità supportati (come Facebook, Google o Microsoft Entra ID).
Multi-Tenant Segmentation with Cambium ePSK
L'implementazione di Cambium delle chiavi pre-condivise private, denominata ePSK, consente agli architetti di rete di segmentare il traffico in modo sicuro senza trasmettere più SSID.

Con ePSK, un singolo SSID supporta fino a 2.000 passphrase univoche. Ciascuna passphrase si mappa su una VLAN specifica. Quando un utente si connette utilizzando la sua chiave univoca, l'AP Cambium inserisce automaticamente il suo traffico nella VLAN assegnata. Questa funzionalità è preziosa per gli ambienti multi-tenant, come gli spazi di coworking o gli edifici residenziali, in cui ogni tenant richiede un segmento di rete isolato. Purple si integra con questa architettura gestendo il ciclo di vita di ePSK tramite l'API di cnMaestro, automatizzando la fornitura, l'assegnazione delle VLAN e la revoca delle credenziali dei tenant.
Implementation Guide
L'implementazione dell'integrazione tra Cambium e Purple richiede una configurazione precisa all'interno della console cloud cnMaestro. Seguite questi passaggi per stabilire il servizio WiFi per gli ospiti di base.
1. Configure the Guest WLAN
Navigate nel menu Configuration in cnMaestro, selezionate WiFi Profiles e aprite la scheda WLANs. Create un nuovo profilo WLAN.
- Name / SSID: definite il nome della rete ospiti (ad es. "Venue Guest WiFi").
- Security: impostate su Open.
- Client Isolation: impostate su Enable per impedire ai dispositivi degli ospiti di comunicare tra loro sulla sottorete locale.
2. Enable the External Hotspot
All'interno della configurazione WLAN, individuate la sezione Guest Access.
- Enable Guest Access: selezionate questa casella.
- Portal Type: selezionate External Hotspot.
- External Page URL: inserite l'URL specifico del Captive Portal fornito dal vostro account manager Purple.
3. Configure RADIUS Authentication and Accounting
Nella stessa sezione Guest Access, configurate i parametri RADIUS.
- Authentication Server: inserite l'indirizzo IP del server RADIUS primario di Purple.
- Authentication Port:
1812 - Accounting Server: inserite l'indirizzo IP del server RADIUS primario di Purple.
- Accounting Port:
1813 - Shared Secret: inserite il segreto condiviso complesso fornito da Purple. Assicuratevi che corrisponda esattamente su entrambe le piattaforme.
4. Define the Walled Garden
Nelle impostazioni dell'External Hotspot, popolate l'elenco del walled garden. È necessario aggiungere i domini principali di Purple e i domini specifici richiesti per i metodi di autenticazione scelti (ad es. provider di social login).
5. Configure 802.1X for Staff WiFi
Per proteggere l'accesso del personale, create un profilo WLAN separato in cnMaestro.
- Security: impostate su WPA2-Enterprise.
- RADIUS Server: puntate all'IP del server RADIUS di Purple sulla porta 1812.
Il personale si autentica utilizzando le proprie credenziali aziendali tramite Microsoft Entra ID o Google Workspace, che Purple convalidates. Purple restituisce quindi un attributo RADIUS Tunnel-Private-Group-ID, indicando all'AP Cambium di inserire il dispositivo del personale nella VLAN aziendale sicura.
Best Practice
- VLAN Trunking: Assicurarsi che tutte le VLAN richieste (Guest, Staff, Management) siano in trunk sulle porte dello switch che si collegano agli AP Cambium. Se la VLAN manca dal trunk, i client autenticati non riusciranno a ottenere un indirizzo IP tramite DHCP.
- Coerenza del firmware: Standardizzare il parco AP sulla versione firmware cnPilot 6.0 o successiva. Questa versione offre il supporto più stabile per il reindirizzamento dell'hotspot esterno e la funzionalità ePSK.
- L'accounting è obbligatorio: Non disattivare mai l'accounting RADIUS. Purple si basa interamente sul flusso di accounting UDP 1813 per generare metriche sul tempo di permanenza (dwell time), dati sulla frequenza delle visite e log di conformità.
- Evitare PSK locali per lo staff: Sostituire le password condivise legacy con l'autenticazione 802.1X per le reti dello staff. Questo approccio è in linea con i requisiti ISO 27001, associando l'accesso alla rete a identità individuali e verificabili.
Risoluzione dei problemi e mitigazione dei rischi
Quando si verificano problemi di integrazione, questi si manifestano in genere durante il reindirizzamento iniziale al Captive Portal o durante la fase di autenticazione RADIUS.
- Mancato caricamento del portale: Si tratta quasi sempre di un problema di walled garden. Se un dispositivo ospite si connette all'SSID ma riceve un timeout di connessione invece della splash page, l'AP sta bloccando l'accesso al dominio del portale Purple. Verificare le voci del walled garden in cnMaestro e assicurarsi che la risoluzione DNS sia consentita prima dell'autenticazione.
- Autenticazione non riuscita (errore credenziali non valide): Verificare il segreto condiviso (shared secret) RADIUS. Una mancata corrispondenza tra cnMaestro e Purple farà sì che il server RADIUS scarti silenziosamente le richieste di autenticazione.
- Il dispositivo si autentica ma non ha accesso a Internet: Questo indica un errore nell'assegnazione dinamica della VLAN o nel processo DHCP. Verificare che Purple restituisca l'ID VLAN corretto nella risposta RADIUS e confermare che la configurazione del trunking della porta dello switch consenta tale VLAN.
ROI e impatto sul business
L'implementazione di Purple WiFi sull'infrastruttura Cambium Networks trasforma una normale utility di rete in un asset aziendale misurabile. Acquisendo dati di prima parte al momento dell'autenticazione, le location possono creare profili completi dei visitatori e avviare campagne di marketing mirate.
Ad esempio, Harrods ha implementato Purple Guest WiFi e ha ottenuto un ROI di marketing pari a 57 volte integrando i dati acquisiti con il proprio programma fedeltà. Allo stesso modo, AGS Airports ha generato un ROI dell'842% utilizzando una larghezza di banda scaglionata e un coinvolgimento mirato dei passeggeri. Standardizzando su Cambium cnMaestro e Purple, i responsabili IT possono offrire una connettività sicura e conforme, fornendo al contempo al reparto marketing i dati necessari per incrementare i ricavi.
Definizioni chiave
Captive Portal
Una pagina di accesso personalizzata che richiede agli utenti di autenticarsi o accettare i termini prima di ottenere l'accesso a una rete WiFi pubblica o aziendale.
Utilizzato nelle distribuzioni WiFi per gli ospiti per acquisire dati di prima parte, applicare le politiche di utilizzo accettabile e presentare il brand della struttura prima di concedere l'accesso a Internet.
RADIUS
Remote Authentication Dial-In User Service; un protocollo di rete che fornisce una gestione centralizzata di autenticazione, autorizzazione e contabilità (AAA).
Il protocollo utilizzato dagli AP Cambium per comunicare con Purple per verificare le credenziali dell'utente e segnalare i dati della sessione.
Walled Garden
Un ambiente limitato che controlla l'accesso degli utenti a contenuti e servizi web prima dell'autenticazione.
Richiesto in cnMaestro per consentire ai dispositivi degli ospiti di raggiungere la splash page di Purple e i domini dei provider di identità (come Facebook o Google) prima di avere pieno accesso a Internet.
ePSK
Enhanced Pre-Shared Key; l'implementazione di Cambium di chiavi pre-condivise private, che consente passphrase univoche per singoli utenti su un unico SSID.
Utilizzato per fornire segmenti di rete sicuri e isolati per ambienti multi-tenant senza trasmettere numerosi SSID.
Dynamic VLAN Assignment
Il processo di posizionamento di un dispositivo autenticato su una specifica Virtual Local Area Network in base agli attributi RADIUS anziché alla porta fisica o all'SSID.
Consente al reparto IT di utilizzare un singolo SSID separando in modo sicuro il traffico degli ospiti da quello del personale o di gestione.
802.1X
Uno standard IEEE per il controllo dell'accesso alla rete basato su porta, che fornisce un meccanismo di autenticazione ai dispositivi che desiderano connettersi a una LAN o WLAN.
Lo standard utilizzato per il WiFi sicuro del personale, che sostituisce le password condivise con credenziali aziendali individuali convalidate rispetto a un provider di identità.
cnMaestro
La piattaforma di gestione basata su cloud o on-premises di Cambium Networks per il controllo centralizzato dell'infrastruttura di rete wireless e cablata.
L'interfaccia in cui gli architetti di rete configurano i profili WLAN, le impostazioni RADIUS e i walled garden richiesti per l'integrazione con Purple.
First-Party Data
Informazioni che un'azienda raccoglie direttamente dai propri clienti e di cui è interamente proprietaria.
Il principale output aziendale di una distribuzione WiFi per gli ospiti di Purple, utilizzato per guidare le campagne di marketing e comprendere il comportamento dei visitatori.
Esempi pratici
Un hotel con 200 camere deve implementare un WiFi sicuro per ospiti, personale e un centro congressi. Gli ospiti richiedono un Captive Portal personalizzato con il brand, il personale necessita di un accesso sicuro ai sistemi interni e il centro congressi richiede reti isolate per i diversi organizzatori di eventi. In che modo l'architetto di rete dovrebbe configurare l'ambiente Cambium cnMaestro per supportare questa configurazione utilizzando Purple?
L'architetto dovrebbe implementare tre profili WLAN distinti in cnMaestro.
- WLAN Ospiti: configurata come rete aperta con 'External Hotspot' abilitato. L'URL di reindirizzamento punta al Captive Portal di Purple. L'autenticazione RADIUS (UDP 1812) e l'accounting (UDP 1813) puntano ai server di Purple. Il walled garden include i domini di Purple.
- WLAN Personale: configurata come WPA2-Enterprise (802.1X). Il RADIUS punta a Purple, che si integra con Microsoft Entra ID dell'hotel. Il personale si autentica con le credenziali aziendali e Purple lo assegna alla VLAN del personale.
- WLAN Conferenze: configurata con WPA2 Pre-Shared Key e Cambium ePSK abilitato. Purple fornisce passphrase ePSK univoche per ciascun organizzatore di eventi tramite l'API di cnMaestro, assegnando ciascuna chiave a una VLAN isolata (ad es. VLAN 301, 302).
Una catena di negozi ha implementato gli AP Cambium e410 e configurato il Captive Portal di Purple. Tuttavia, i clienti segnalano che la splash page non appare mai sui loro smartphone; al contrario, il browser mostra un timeout di connessione. Qual è la causa principale e come si risolve?
La causa principale è una configurazione incompleta del walled garden in cnMaestro. L'AP Cambium sta bloccando il traffico HTTP/HTTPS richiesto per caricare il portale Purple prima che l'utente sia autenticato.
Per risolvere questo problema, l'ingegnere di rete deve accedere a cnMaestro, navigare nel profilo WLAN Ospiti e aggiornare l'elenco del walled garden dell'External Hotspot. Deve aggiungere i domini specifici del portale di Purple e tutti gli endpoint CDN associati. Una volta applicata la modifica, i dispositivi non autenticati saranno in grado di raggiungere il portale e completare il flusso di accesso.
Domande di esercitazione
Q1. Stai implementando il WiFi per gli ospiti di Purple in 50 negozi al dettaglio utilizzando gli AP Cambium e505. Gli utenti possono connettersi all'SSID e visualizzare la splash page, ma dopo l'accesso non riescono a navigare in Internet. Verifichi che Purple stia inviando il messaggio di Access-Accept. Qual è il problema infrastrutturale più probabile?
Suggerimento: Considera cosa succede a livello di switch quando un dispositivo tenta di ottenere un indirizzo IP dopo l'autenticazione.
Visualizza risposta modello
Il problema più probabile è la mancanza del trunking VLAN sulle porte dello switch che collegano gli AP Cambium. Sebbene l'AP autorizzi il dispositivo, se la VLAN ospiti assegnata non è consentita sul trunk dello switch, il dispositivo non può raggiungere il server DHCP per ottenere un indirizzo IP, con conseguente assenza di accesso a Internet.
Q2. Un campus universitario desidera utilizzare un unico SSID per tutti gli studenti nei dormitori, ma richiede che i dispositivi di ciascuno studente siano isolati nel proprio segmento di rete privato per consentire la trasmissione alla propria smart TV specifica. Come si implementa questa soluzione utilizzando Cambium e Purple?
Suggerimento: Esamina l'implementazione di Cambium delle chiavi pre-condivise private.
Visualizza risposta modello
Implementa Cambium ePSK (Enhanced Pre-Shared Key) sulla WLAN del dormitorio. Purple gestirà il ciclo di vita di ePSK tramite l'API di cnMaestro, generando una passphrase univoca per ciascuno studente. Quando uno studente connette i propri dispositivi utilizzando la sua chiave specifica, l'AP Cambium lo assegna a una VLAN univoca, creando una rete d'area privata isolata.
Q3. Durante una distribuzione pilota, la dashboard di analisi di Purple mostra metriche di tempo di permanenza o utilizzo dei dati pari a zero per il sito di test Cambium, anche se gli utenti si autenticano e navigano in Internet con successo. Quale passaggio di configurazione è stato saltato in cnMaestro?
Suggerimento: La reportistica richiede i dati di sessione, che vengono gestiti da una porta UDP specifica nella configurazione AAA.
Visualizza risposta modello
Il RADIUS Accounting non è stato configurato. L'ingegnere di rete deve abilitare il RADIUS Accounting nel profilo WLAN Ospiti di cnMaestro e puntarlo al server RADIUS di Purple sulla porta UDP 1813. Senza questo passaggio, Purple gestisce solo l'autenticazione e non riceve alcun dato sul ciclo di vita della sessione.
Continua a leggere questa serie
CommScope Ruckus Integration with Purple WiFi: Setup and Configuration Guide
Questa guida di riferimento tecnico fornisce un playbook di configurazione autorevole per l'integrazione delle architetture CommScope Ruckus con Purple WiFi. Dettaglia le implementazioni passo-passo per i Captive Portal per Guest WiFi, il WiFi sicuro per il personale tramite 802.1X e l'isolamento di rete multi-tenant tramite Ruckus Dynamic PSK.
Allied Telesis Access Points Integration with Purple WiFi
Questa guida fornisce un playbook di configurazione completo per l'integrazione degli access point Allied Telesis serie TQ con Purple WiFi. Copre il reindirizzamento del Captive Portal esterno, l'autenticazione RADIUS 802.1X e l'instradamento dinamico della VLAN tramite Private Pre-Shared Keys (PPSK) per distribuzioni multi-tenant sicure.
Cisco WLC and Catalyst Integration with Purple WiFi: Step-by-Step Guest Access Guide
Questa guida descrive in dettaglio l'integrazione passo-passo di Cisco WLC e Catalyst 9800 Wireless con Purple, coprendo il reindirizzamento al Captive Portal per Guest WiFi tramite Central Web Authentication, il WiFi aziendale sicuro per il personale tramite 802.1X EAP-TLS e la segmentazione multi-tenant tramite Cisco Identity Pre-Shared Keys (iPSK) con assegnazione dinamica della VLAN. È scritta per architetti di rete aziendali e direttori della sicurezza IT che distribuiscono l'infrastruttura Cisco nei settori hospitality, retail e grandi spazi pubblici.