Risoluzione dei problemi del captive portal Ruckus: elenco di controllo per reindirizzamento WISPr, hotspot e walled garden

La maggior parte dei guasti del Captive Portal Ruckus si riconduce a cinque elementi: l'URL di accesso e la pagina iniziale dell'hotspot (WISPr), le voci mancanti del walled garden per il portale e le sue risorse, una password dell'interfaccia del portale northbound non corrispondente, errori di autenticazione o accounting RADIUS e avvisi relativi ai certificati di reindirizzamento HTTPS. Verificali in questo ordine, utilizzando la cronologia degli eventi del client su SmartZone, Ruckus One o Unleashed.

Che aspetto ha un Captive Portal Ruckus non funzionante?

Un servizio hotspot Ruckus utilizza WISPr (Wireless Internet Service Provider roaming). Si tratta di un framework in cui il controller trattiene un ospite non autenticato dietro un Captive Portal finché un sistema esterno non lo approva. Un Captive Portal è la splash page che un ospite compila prima di accedere a Internet. Quando la catena si interrompe, l'ospite riscontra uno di questi sei sintomi:

• Nessun reindirizzamento. Il dispositivo si connette all'SSID e riceve un indirizzo IP, ma non viene visualizzato alcun messaggio di accesso e il browser va in timeout.
• Una splash page vuota o caricata a metà. Il prompt si apre, ma il caricamento di loghi, font, script o pulsanti di accesso social non riesce.
• Un avviso di certificato prima del portale. Il browser mostra "La tua connessione non è privata" o un messaggio simile, e l'ospite deve fare clic per procedere.
• Un ciclo continuo di login. L'ospite compila il modulo e si ritrova nuovamente sulla splash page, ancora offline.
• Nessun prompt, ma nessuna connessione a Internet. Il dispositivo segnala di essere online, quindi il Captive Network Assistant non si apre mai.
• Online, ma nessun dato di sessione. Gli ospiti navigano normalmente, ma gli accessi e la durata delle sessioni non compaiono mai nei tuoi report.

Gli ultimi due sintomi sono facili da ignorare, perché nessuno chiama l'assistenza. Te ne accorgerai in seguito, quando i dati sui tuoi ospiti smetteranno di crescere.

Quali sono le cause più comuni dei malfunzionamenti del Captive Portal Ruckus?

È utile innanzitutto conoscere la sequenza. L'articolo di supporto sul Captive Portal di Purple ne illustra i dettagli. Il controller gestisce l'interazione WiFi con i server della splash page di Purple. Tali server raccolgono i dati dell'ospite e generano un login monouso. Il controller trasmette quindi tale login al server RADIUS di Purple per completare l'accesso. RADIUS (Remote Authentication Dial-In User Service, RFC 2865) è il protocollo che autentica la sessione. L'accounting RADIUS (RFC 2866) registra la sessione successivamente.

Ogni passaggio presenta una propria modalità di errore.

Impostazioni di reindirizzamento e pagina iniziale del servizio hotspot

Il servizio hotspot contiene l'URL di accesso esterno e la pagina iniziale. L'URL di accesso è la destinazione a cui vengono inviati gli ospiti non autenticati. La pagina iniziale è la pagina su cui atterrano dopo l'accesso. Un errore di battitura, un URL non aggiornato dopo una modifica del portale o l'associazione di un servizio hotspot errato alla WLAN impediscono il reindirizzamento. Una pagina iniziale che rimanda a un URL bloccato o obsoleto fa sembrare fallito un accesso andato a buon fine.

Lacune nel walled garden

Il walled garden è l'elenco delle destinazioni che un ospite non autenticato può raggiungere prima di effettuare l'accesso. Deve includere l'hostname del portale e ogni host da cui la splash page carica risorse. Deve inoltre includere i domini di qualsiasi provider di identità social o single sign-on offerto. Se aggiungi un'opzione di login, leggi how to enable single sign-on e aggiungi i domini di quel provider. Un solo host di risorse mancante produce una pagina caricata a metà.

Anche l'errore opposto causa problemi. I dispositivi testano la connettività verificando un nome di dominio predefinito, secondo l'articolo di supporto di Purple. Se quel dominio di probe si trova nel walled garden, il dispositivo crede di essere online. La richiesta di accesso non viene mai visualizzata e l'ospite rimane bloccato.

Credenziali della northbound portal interface

Su SmartZone, la northbound portal interface è il modo in cui un portale esterno comunica al controller che un ospite ha effettuato l'accesso. Il portale si autentica su tale interfaccia con una password impostata sul controller. Se tale password viene modificata solo su un lato, il portale non può autorizzare nessuno. L'ospite compila il modulo e torna in loop alla splash page.

Autenticazione e accounting RADIUS

Il controller inoltra il login singolo al RADIUS. L'autenticazione fallisce se il segreto condiviso differisce, se il server RADIUS non è raggiungibile o se le richieste arrivano da un indirizzo che il server non riconosce. I fallimenti di accounting sono più silenziosi. Gli ospiti vanno online, ma i record di inizio e fine sessione non arrivano mai.

Comportamento del reindirizzamento HTTPS

I browser moderni si aspettano una pagina di login tramite HTTPS. L'articolo di Purple sul Cisco WLC certificate article descrive l'effetto sui controller Cisco. Un reindirizzamento HTTP a un indirizzo del controller attiva un avviso di sicurezza e l'ospite deve fare clic per procedere. La soluzione in questo caso è un certificato pubblicamente attendibile il cui Common Name corrisponde all'hostname di autenticazione web del controller. Lo stesso principio si applica quando si abilita il reindirizzamento HTTPS su un controller Ruckus. Un certificato scaduto, o una mancata corrispondenza del nome, fa ricomparire l'avviso.

Come capire qual è la causa?

Parti dal sintomo, non dalla configurazione. La tabella associa ogni sintomo alla sua causa più probabile e al primo posto in cui effettuare la verifica.

Sintomo	Causa più probabile	Dove guardare prima	Prima verifica
Nessuna richiesta di login, timeout del browser	URL di login dell'hotspot errato o servizio hotspot errato sulla WLAN	Servizio hotspot (WISPr) e impostazioni WLAN	Apri mai-neverssl.com su un dispositivo di prova e vedi dove atterra
La splash page si carica senza immagini o pulsanti	Host della risorsa o del provider di identità mancante nel walled garden	Elenco walled garden	Carica il portale su un laptop ed elenca tutti gli host bloccati negli strumenti di sviluppo del browser
Il dispositivo risulta online, nessuna richiesta, nessun accesso a Internet	Dominio di probe della connettività nel walled garden	Elenco walled garden	Rimuovi le voci con caratteri jolly generici e riprova
Modulo completato, l'ospite torna all'inizio	Mancata corrispondenza della password dell'interfaccia del portale Northbound	Impostazioni dell'interfaccia Northbound e integrazione del portale	Verificare che la password corrisponda su entrambi i lati
Accesso rifiutato dopo il modulo	Segreto condiviso RADIUS o indirizzo di origine non corrispondente	Servizio di autenticazione RADIUS ed eventi client	Verificare la presenza di timeout o rifiuti di autenticazione
Ospiti online, nessun dato di sessione	RADIUS accounting configurato in modo errato o non associato	Servizio RADIUS accounting sulla WLAN	Verificare che l'accounting sia abilitato e puntato al server corretto

Riprodurre il problema su un dispositivo pulito

Ignorare l'SSID su un telefono e un laptop di prova, quindi riconnettersi. Se la schermata non si apre, l'articolo di supporto di Purple consiglia di navigare su neverssl.com. Questo sito evita i problemi di reindirizzamento SSL, mostrando quindi se il reindirizzamento stesso funziona.

Leggere gli eventi del client

Ogni piattaforma Ruckus conserva una cronologia degli eventi del client. Su SmartZone, utilizzare i log degli eventi e degli allarmi e la cronologia delle connessioni del client. Su Ruckus One, aprire il client e verificare i relativi eventi. Su Unleashed, controllare il registro degli eventi per l'indirizzo MAC del client. Cercare tre elementi: se il client si è associato, se è stato reindirizzato e se RADIUS lo ha accettato o rifiutato. Questa sequenza indica quale anello della catena si è interrotto.

Come risolvere il problema su SmartZone, Ruckus One e Unleashed?

Le soluzioni seguono lo stesso ordine su tutte e tre le piattaforme. I menu variano, pertanto si prega di seguire la documentazione Ruckus per la propria versione e l'articolo di supporto del Captive Portal per i valori di Purple.

SmartZone

Verificare che la WLAN utilizzi il servizio hotspot (WISPr) previsto e che l'URL di accesso corrisponda all'integrazione. Ricostruire il walled garden dall'elenco aggiornato, non a memoria. Verificare che la password dell'interfaccia del portale northbound corrisponda a quella configurata per il portale. Successivamente, verificare che i servizi di autenticazione e accounting RADIUS puntino entrambi ai server corretti con il segreto condiviso corretto.

Ruckus One

Ruckus One gestisce gli stessi elementi WISPr in modo centralizzato. Verificare le impostazioni del provider del portale della rete ospiti, il walled garden e i servizi RADIUS. Le sostituzioni a livello di sede meritano attenzione, poiché una sede può differire dal modello applicato altrove.

Unleashed

Unleashed esegue la funzione di controller su un access point, pertanto verificare il servizio hotspot su quell'AP master. Prestare attenzione al walled garden e alle impostazioni RADIUS, e confermare che il servizio hotspot sia associato alla WLAN ospiti.

Escludere guasti simili

Alcuni reclami sembrano errori del portale ma non lo sono. Se ai visitatori viene chiesto nuovamente l'accesso mentre si spostano tra gli access point, leggi la guida sulla risoluzione dei problemi di roaming nelle WLAN aziendali. Se le sessioni si interrompono in modo casuale sui canali a 5 GHz, la checklist diagnostica per gli eventi radar DFS è il miglior punto di partenza.

Come si presenta questo scenario in una sede reale?

I due scenari seguenti sono illustrativi. Mostrano il metodo piuttosto che documentare una specifica installazione.

Scenario 1: un hotel da 200 camere dopo il restyling della splash page

Situazione. Il team di marketing ha rilanciato la splash page dell'hotel. La mattina successiva, la reception ha segnalato che i visitatori visualizzavano una pagina bianca con un solo campo di modulo.

Cosa è stato fatto. L'ingegnere ha caricato il portale su un laptop e ha elencato le richieste bloccate negli strumenti di sviluppo del browser. Il nuovo design caricava font e immagini da un host che non era presente nel walled garden di SmartZone. L'ingegnere ha aggiunto quell'host, ha ricollegato un telefono e un laptop di test e ha confermato che entrambi visualizzavano la pagina completa.

Risultato. La splash page completa è stata visualizzata su entrambi i dispositivi di test al primo tentativo. La correzione è consistita in un singolo inserimento nel walled garden, e gli eventi dei client hanno mostrato che i visitatori superavano nuovamente il reindirizzamento e l'accettazione RADIUS. Per saperne di più sull'esperienza degli ospiti in questo settore, consulta la pagina Purple per gli Hotel.

Scenario 2: una catena retail di 40 negozi dopo la migrazione del controller

Situazione. Un rivenditore ha trasferito i propri negozi su un nuovo cluster SmartZone. I clienti riuscivano ancora a connettersi a internet, ma la reportistica degli utenti registrava zero nuove sessioni in tutti i 40 negozi.

Cosa è stato fatto. Gli eventi dei client mostravano l'accettazione dell'autenticazione RADIUS ma nessun record di accounting. Il servizio di accounting non era stato associato alla WLAN ospiti sul nuovo cluster. L'ingegnere lo ha associato e ha confermato che il shared secret corrispondeva.

Risultato. I record delle sessioni sono riapparsi per tutti i 40 negozi. I clienti non hanno subito alcuna interruzione, poiché l'anomalia interessava solo la reportistica. Vedi la pagina Purple per il Retail per scoprire come i dati di sessione alimentano le analisi sul comportamento d'acquisto.

Come evitare che si verifichino nuovamente errori del Captive Portal Ruckus?

La maggior parte degli errori ricorrenti deriva dai cambiamenti, non da guasti improvvisi. Cinque buone abitudini consentono di prevenirli:

1. Gestisci il walled garden come un documento controllato. Registra ogni voce, il relativo proprietario e il motivo della sua esistenza. Monitoralo ogni volta che la splash page subisce modifiche.
2. Aggiorna le chiavi segrete contemporaneamente su entrambi i lati. Cambia la password dell'interfaccia del portale Northbound e la shared secret RADIUS in un'unica finestra di manutenzione, mai su un solo lato alla volta.
3. Monitora la scadenza dei certificati. Pianifica il rinnovo con largo anticipo rispetto alla scadenza del certificato di reindirizzamento HTTPS e verifica successivamente che i nomi corrispondano.
4. Effettua test dopo ogni modifica. Esegui lo stesso controllo su un iPhone, un telefono Android, un laptop Windows e un laptop macOS. I diversi sistemi operativi gestiscono il Captive Network Assistant in modi differenti.
5. Monitora quotidianamente il conteggio delle sessioni. Un calo improvviso a zero nei tuoi dati di analisi WiFi indica un problema di accounting prima ancora che qualsiasi ospite se ne lamenti.

Tieni aperta la rete ospiti, come raccomandato dall'articolo di supporto di Purple. Una rete aperta è la convenzione standard e un comportamento familiare riduce l'attrito al momento del login. Per gli operatori di trasporto, dove i passeggeri si connettono in movimento, si applicano gli stessi controlli; vedi Purple per Treni.

Domande frequenti

Purple funziona con Ruckus SmartZone, Ruckus One e Unleashed?

Sì, Purple Guest WiFi funziona sui servizi hotspot Ruckus (WISPr) come Captive Portal esterno. Purple è agnostico rispetto all'hardware e funziona anche con Cisco Meraki, HPE Aruba, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme Networks e Fortinet. Il controller gestisce il reindirizzamento e il server RADIUS, mentre Purple ospita la splash page e autentica l'ospite. I valori e i passaggi di configurazione si trovano nell'articolo di supporto del Captive Portal di Purple.

Abbiamo bisogno di nuovi access point per aggiungere Purple a una rete Ruckus esistente?

No, Purple funziona come un overlay cloud sugli access point e sul controller Ruckus che già possiedi. Configuri un servizio hotspot, un walled garden e le impostazioni RADIUS sul controller, quindi punti la WLAN ospiti su Purple. Non viene sostituito nulla in loco. La maggior parte dell'impegno consiste nel testare il reindirizzamento sui dispositivi iOS, Android, Windows e macOS prima di andare online.

Possiamo passare dal portale ospiti Ruckus integrato a Purple senza interrompere il servizio per gli ospiti?

Sì, se crei prima la configurazione Purple su una WLAN di test separata. Configura il servizio hotspot, il walled garden e i servizi RADIUS insieme alla tua rete ospiti attiva e prova il login completo sui dispositivi di test. Una volta verificato il funzionamento, collega il nuovo servizio hotspot alla WLAN attiva in un periodo di scarso traffico. Gli ospiti vedranno una nuova splash page, non un'interruzione del servizio.

In che modo Purple gestisce i dati degli ospiti raccolti tramite un Captive Portal Ruckus?

Purple raccoglie dati di prima parte tramite opt-in basati su una scelta consapevole sulla splash page. Purple è certificato ISO 27001 e Cyber Essentials, e opera in conformità con il GDPR e il CCPA. Il controller Ruckus non conserva dati di marketing. Trasmette un login unico al server RADIUS di Purple, in modo che i dettagli degli ospiti rimangano all'interno della piattaforma certificata di Purple anziché diffondersi nei singoli controller del sito.

Quanto tempo richiede l'implementazione di un Captive Portal Ruckus con Purple?

Un singolo sito viene solitamente configurato entro una sola sessione di lavoro, poiché non vi sono modifiche all'hardware. Il controller richiede un servizio hotspot, un walled garden e le funzioni di autenticazione e accounting RADIUS. Le proprietà multi-sito richiedono più tempo, principalmente per i test e il controllo delle modifiche piuttosto che per la configurazione. Su Ruckus One o SmartZone, un modello applicato centralmente mantiene coerente ogni sede e riduce il rischio di discrepanze tra i siti.

Su quale scala è comprovata la piattaforma WiFi per ospiti di Purple?

Purple è attivo in oltre 80.000 sedi reali e ha registrato 440 milioni di accessi nel 2024, secondo i dati aziendali di Purple. Queste sedi spaziano dal settore dell'ospitalità, al retail, ai trasporti, all'istruzione e al settore pubblico. Purple opera dal 2012 e ogni installazione utilizza la stessa splash page e lo stesso flusso RADIUS descritti in questa guida, indipendentemente dal fornitore di hardware supportato su cui si appoggia la rete.