Ruckus Captive Portal Fehlerbehebung: Checkliste für WISPr Weiterleitung, Hotspot und Walled Garden

Die meisten Fehler beim Ruckus Captive Portal lassen sich auf fünf Stellen zurückführen: die Hotspot-Anmelde-URL (WISPr) und die Startseite, fehlende Walled Garden-Einträge für das Portal und seine Assets, ein nicht übereinstimmendes Kennwort für die Northbound Portal-Schnittstelle, Fehler bei der RADIUS-Authentifizierung oder beim Accounting sowie HTTPS-Weiterleitungs-Zertifikatswarnungen. Überprüfen Sie diese in genau dieser Reihenfolge, indem Sie den Ereignisverlauf des Clients auf SmartZone, Ruckus One oder Unleashed nutzen.

Wie sieht ein fehlerhaftes Ruckus Captive Portal aus?

Ein Ruckus Hotspot-Dienst verwendet WISPr (Wireless Internet Service Provider roaming). Dies ist ein Framework, bei dem der Controller einen nicht authentifizierten Gast hinter einem Captive Portal hält, bis ein externes System ihn freigibt. Ein Captive Portal ist die Splash Page, die ein Gast ausfüllt, bevor er das Internet erreicht. Wenn die Kette unterbrochen wird, sieht der Gast eines von sechs Symptomen:

• Keine Weiterleitung. Das Gerät verbindet sich mit der SSID und erhält eine IP-Adresse, aber es erscheint keine Anmeldeaufforderung und der Browser meldet eine Zeitüberschreitung.
• Eine leere oder unvollständig geladene Splash Page. Die Eingabeaufforderung öffnet sich, aber Logos, Schriftarten, Skripte oder Social-Login-Buttons werden nicht geladen.
• Eine Zertifikatswarnung vor dem Portal. Der Browser zeigt "Ihre Verbindung ist nicht privat" oder Ähnliches an, und der Gast muss sich durchklicken.
• Eine Endlosschleife bei der Anmeldung. Der Gast füllt das Formular aus und landet wieder auf der Splash Page, immer noch offline.
• Keine Aufforderung, aber auch kein Internet. Das Gerät meldet, dass es online ist, sodass der Captive Network Assistant sich nie öffnet.
• Online, aber keine Sitzungsdaten. Gäste surfen ganz normal, aber Anmeldungen und Sitzungsdauern tauchen in Ihren Berichten nie auf.

Die letzten beiden Symptome werden leicht übersehen, da sich niemand beim Helpdesk meldet. Sie bemerken sie erst später, wenn Ihre Gästedaten nicht mehr wachsen.

Was verursacht normalerweise Fehler beim Ruckus Captive Portal?

Es hilft, zuerst die genaue Abfolge zu kennen. Der Support-Artikel von Purple zum Thema Captive Portal erklärt dies im Detail. Der Controller verwaltet die WiFi Interaktion mit den Splash-Page-Servern von Purple. Diese Server erfassen die Daten des Gasts und stellen ein einmaliges Login aus. Der Controller leitet dieses Login dann an den RADIUS-Server von Purple weiter, um den Zugriff abzuschließen. RADIUS (Remote Authentication Dial-In User Service, RFC 2865) ist das Protokoll, das die Sitzung authentifiziert. RADIUS Accounting (RFC 2866) meldet die Sitzung im Anschluss.

Jeder Schritt hat seine eigenen Fehlermöglichkeiten.

Einstellungen für die Weiterleitung des Hotspot-Dienstes und die Startseite

Der Hotspot-Dienst enthält die externe Anmelde-URL und die Startseite. Die Anmelde-URL ist das Ziel, an das nicht authentifizierte Gäste weitergeleitet werden. Die Startseite ist die Seite, auf der sie nach der Anmeldung landen. Ein Tippfehler, eine veraltete URL nach einer Portaländerung oder der falsche, mit dem WLAN verknüpfte Hotspot-Dienst verhindern die Weiterleitung. Eine Startseite, die auf eine blockierte oder nicht mehr existierende URL verweist, lässt eine erfolgreiche Anmeldung wie einen Fehler aussehen.

Lücken im Walled Garden

Der Walled Garden ist die Liste der Ziele, die ein nicht authentifizierter Gast vor dem Login erreichen kann. Er muss den Portal-Hostnamen und jeden Host enthalten, von dem die Splash Page Inhalte lädt. Er muss auch die Domains aller von Ihnen angebotenen Social-Media- oder Single-Sign-On-Identity-Provider enthalten. Wenn Sie eine Login-Option hinzufügen, lesen Sie bitte how to enable single sign-on und fügen Sie die Domains dieses Anbieters hinzu. Ein einziger fehlender Asset-Host führt zu einer unvollständig geladenen Seite.

Der umgekehrte Fehler führt ebenfalls zu Problemen. Geräte testen die Konnektivität, indem sie eine vordefinierte Domain abfragen, wie im Support-Artikel von Purple beschrieben. Befindet sich diese Probe-Domain im Walled Garden, glaubt das Gerät, es sei online. Die Aufforderung zur Anmeldung erscheint nie und der Gast kann die Verbindung nicht nutzen.

Zugangsdaten für das Northbound Portal Interface

Bei SmartZone teilt das externe Portal dem Controller über das Northbound Portal Interface mit, dass sich ein Gast angemeldet hat. Das Portal authentifiziert sich an dieser Schnittstelle mit einem auf dem Controller festgelegten Passwort. Wenn sich dieses Passwort nur auf einer Seite ändert, kann das Portal niemanden autorisieren. Der Gast füllt das Formular aus und landet wieder auf der Splash Page.

RADIUS-Authentifizierung und -Accounting

Der Controller leitet das einmalige Login an RADIUS weiter. Die Authentifizierung schlägt fehl, wenn das Shared Secret abweicht, der RADIUS-Server nicht erreichbar ist oder Anfragen von einer Adresse eingehen, die der Server nicht erkennt. Accounting-Fehler fallen weniger auf. Gäste gehen online, aber die Datensätze für den Sitzungsstart und das -ende kommen nie an.

HTTPS-Umleitungsverhalten

Moderne Browser erwarten eine Login-Seite über HTTPS. Der Cisco WLC certificate article von Purple beschreibt die Auswirkungen auf Cisco-Controller. Eine HTTP-Umleitung zu einer Controller-Adresse löst eine Sicherheitswarnung aus, und der Gast muss sich durchklicken. Die Lösung besteht in einem öffentlich vertrauenswürdigen Zertifikat, dessen Common Name mit dem Web-Authentifizierungs-Hostnamen des Controllers übereinstimmt. Das gleiche Prinzip gilt, wenn Sie die HTTPS-Umleitung auf einem Ruckus-Controller aktivieren. Ein abgelaufenes Zertifikat oder eine Namensabweichung lässt die Warnung erneut erscheinen.

Wie finden Sie heraus, was die Ursache ist?

Gehen Sie vom Symptom aus, nicht von der Konfiguration. Die Tabelle ordnet jedes Symptom seiner wahrscheinlichsten Ursache und dem ersten Ort zu, an dem Sie suchen sollten.

Symptom	Wahrscheinlichste Ursache	Erste Anlaufstelle	Erste Prüfung
Keine Login-Aufforderung, Browser-Zeitüberschreitung	Hotspot-Logon-URL falsch oder falscher Hotspot-Dienst auf dem WLAN	Hotspot- (WISPr) Dienst und WLAN-Einstellungen	Öffnen Sie neverssl.com auf einem Testgerät und prüfen Sie, wo Sie landen
Splash Page lädt ohne Bilder oder Buttons	Asset- oder Identity-Provider-Host fehlt im Walled Garden	Walled Garden-Liste	Laden Sie das Portal auf einem Laptop und listen Sie alle blockierten Hosts in den Browser-Entwicklertools auf
Gerät sagt online, keine Aufforderung, kein Internet	Connectivity Probe-Domain im Walled Garden	Walled Garden-Liste	Entfernen Sie breite Wildcard-Einträge und testen Sie erneut
Zertifikatswarnung vor dem Portal	HTTPS-Weiterleitung ohne ein vertrauenswürdiges, übereinstimmendes Zertifikat	Zertifikatseinstellungen des Controllers	Vergleichen Sie Zertifikatsnamen und Ablaufdatum mit dem Hostnamen der Weiterleitung
Formular wird ausgefüllt, Gast wird zurückgeleitet	Passwortkonflikt an der Northbound-Portalschnittstelle	Einstellungen der Northbound-Schnittstelle und Portalintegration	Bestätigen Sie, dass das Passwort auf beiden Seiten übereinstimmt
Anmeldung nach Formular abgelehnt	RADIUS Shared Secret oder Quelladresse stimmt nicht überein	RADIUS-Authentifizierungsdienst und Client-Ereignisse	Suchen Sie nach Authentifizierungs-Timeouts oder Ablehnungen
Gäste online, keine Sitzungsdaten	RADIUS-Accounting falsch konfiguriert oder nicht zugewiesen	RADIUS-Accounting-Dienst auf dem WLAN	Bestätigen Sie, dass das Accounting aktiviert ist und auf den richtigen Server verweist

Auf einem sauberen Gerät reproduzieren

Ignorieren Sie die SSID auf einem Testtelefon und einem Test-Laptop, und verbinden Sie sich dann erneut. Wenn sich die Eingabeaufforderung nicht öffnet, empfiehlt der Support-Artikel von Purple, neverssl.com aufzurufen. Diese Seite vermeidet SSL-Weiterleitungsprobleme und zeigt somit, ob die Weiterleitung an sich funktioniert.

Client-Ereignisse lesen

Jede Ruckus-Plattform speichert einen Client-Ereignisverlauf. Verwenden Sie bei SmartZone die Ereignis- und Alarmprotokolle sowie den Verbindungsverlauf des Clients. Öffnen Sie bei Ruckus One den Client und überprüfen Sie seine Ereignisse. Suchen Sie bei Unleashed im Ereignisprotokoll nach der MAC-Adresse des Clients. Achten Sie auf drei Dinge: ob sich der Client assoziiert hat, ob er weitergeleitet wurde und ob RADIUS ihn akzeptiert oder abgelehnt hat. Diese Abfolge zeigt Ihnen, welches Glied in der Kette unterbrochen wurde.

Wie behebt man das Problem auf SmartZone, Ruckus One und Unleashed?

Die Fehlerbehebungen folgen auf allen drei Plattformen der gleichen Reihenfolge. Die Menüs unterscheiden sich, befolgen Sie daher die Ruckus-Dokumentation für Ihre Version und den Captive Portal Support-Artikel für die Werte von Purple.

SmartZone

Bestätigen Sie, dass das WLAN den von Ihnen erwarteten Hotspot-Dienst (WISPr) verwendet und dass seine Anmelde-URL mit der Integration übereinstimmt. Erstellen Sie den Walled Garden anhand der aktuellen Liste neu, nicht aus dem Gedächtnis. Überprüfen Sie, ob das Passwort der Northbound-Portalschnittstelle mit dem für das Portal konfigurierten Passwort übereinstimmt. Bestätigen Sie anschließend, dass sowohl die RADIUS-Authentifizierungs- als auch die Accounting-Dienste auf die richtigen Server mit dem richtigen Shared Secret verweisen.

Ruckus One

Ruckus One verwaltet dieselben WISPr-Elemente zentral. Überprüfen Sie die Portal-Provider-Einstellungen, den Walled Garden und die RADIUS-Dienste des Gastnetzwerks. Überschreibungen auf Standortebene verdienen besondere Aufmerksamkeit, da ein Standort von der Vorlage abweichen kann, die überall sonst angewendet wird.

Unleashed

Unleashed führt die Controller-Funktion auf einem Access Point aus. Überprüfen Sie daher den Hotspot-Dienst auf diesem Master-AP. Achten Sie auf den Walled Garden und die RADIUS-Einstellungen und bestätigen Sie, dass der Hotspot-Dienst dem Gast-WLAN zugewiesen ist.

Ähnlich aussehende Fehler ausschließen

Einige Beschwerden sehen aus wie Portal-Fehler, sind es aber nicht. Wenn Gäste erneut zur Anmeldung aufgefordert werden, während sie sich zwischen Access Points bewegen, lesen Sie den Leitfaden zur Behebung von Roaming-Problemen in Unternehmens-WLANs. Wenn Verbindungen auf 5GHz-Kanälen willkürlich abbrechen, ist die Checkliste zur Diagnose von DFS-Radarereignissen der bessere Ausgangspunkt.

Wie sieht das in einem Live-Betrieb aus?

Die beiden folgenden Szenarien dienen der Veranschaulichung. Sie zeigen die Methodik und beziehen sich nicht auf ein namentlich genanntes Projekt.

Szenario 1: Ein Hotel mit 200 Zimmern nach der Neugestaltung einer Splash Page

Situation. Das Marketing-Team hat die Splash Page des Hotels neu gestaltet. Am nächsten Morgen meldete die Rezeption, dass Gäste eine leere Seite mit einem einzigen Formularfeld sahen.

Maßnahme. Der Techniker öffnete das Portal auf einem Laptop und listete die blockierten Anfragen in den Entwicklertools des Browsers auf. Das neue Design lud Schriftarten und Bilder von einem Host, der im SmartZone Walled Garden fehlte. Der Techniker fügte diesen Host hinzu, verband ein Test-Telefon sowie ein Test-Laptop neu und bestätigte, dass auf beiden die vollständige Seite gerendert wurde.

Ergebnis. Die vollständige Splash Page wurde beim ersten erneuten Test auf beiden Testgeräten gerendert. Die Behebung bestand aus einem einzigen Walled-Garden-Eintrag, und die Client-Ereignisse zeigten, dass Gäste die Weiterleitung und die RADIUS-Freigabe wieder erfolgreich durchliefen. Weitere Informationen zur Gäste-Erfahrung in dieser Branche finden Sie unter Purple für Hotels.

Szenario 2: Eine Einzelhandelskette mit 40 Filialen nach einer Controller-Migration

Situation. Ein Einzelhändler hat seine Filialen auf einen neuen SmartZone-Cluster migriert. Kunden konnten weiterhin online gehen, aber die Berichte zeigten null neue Sitzungen in allen 40 Filialen.

Maßnahme. Die Client-Ereignisse zeigten erfolgreiche RADIUS-Authentifizierungen, aber keine Accounting-Datensätze. Der Accounting-Dienst war im neuen Cluster nicht mit dem Gäste-WLAN verknüpft worden. Der Techniker verknüpfte ihn und bestätigte, dass das Shared Secret übereinstimmte.

Ergebnis. Sitzungsdaten aus allen 40 Filialen wurden wieder erfasst. Für die Kunden gab es keine Unterbrechung, da nur die Berichterstellung betroffen war. Unter Purple für Einzelhandel erfahren Sie, wie diese Sitzungsdaten zur Kundenerkenntnis beitragen.

Wie verhindert man, dass Fehler im Ruckus Captive Portal erneut auftreten?

Die meisten wiederkehrenden Fehler entstehen durch Änderungen, nicht durch Systemausfälle. Fünf Gewohnheiten beugen ihnen vor:

1. Behandeln Sie den Walled Garden wie ein kontrolliertes Dokument. Erfassen Sie jeden Eintrag, seinen Eigentümer und den Grund für seine Existenz. Überprüfen Sie ihn bei jeder Änderung der Splash Page.
2. Rotieren Sie Secrets auf beiden Seiten gleichzeitig. Ändern Sie das Passwort der Northbound-Portalschnittstelle und das RADIUS Shared Secret in einem einzigen Änderungsfenster, niemals nur auf einer Seite.
3. Überwachen Sie den Ablauf von Zertifikaten. Planen Sie die Erneuerung rechtzeitig vor dem Ablauf des HTTPS-Weiterleitungszertifikats ein und überprüfen Sie anschließend die Namensübereinstimmung.
4. Testen Sie nach jeder Änderung. Führen Sie dieselbe Überprüfung auf einem iPhone, einem Android-Telefon, einem Windows-Laptop und einem macOS-Laptop durch. Verschiedene Betriebssysteme verhalten sich beim Captive Network Assistant unterschiedlich.
5. Überwachen Sie täglich die Anzahl der Sitzungen. Ein plötzlicher Abfall auf Null in Ihren WiFi Analysen deutet auf ein Abrechnungsproblem hin, noch bevor sich ein Gast beschwert.

Halten Sie das Gastnetzwerk offen, wie im Support-Artikel von Purple empfohlen. Ein offenes Netzwerk ist der Standard, und vertrautes Verhalten reduziert Reibungsverluste bei der Anmeldung. Für Transportunternehmen, bei denen sich Passagiere von unterwegs aus verbinden, gelten dieselben Prüfungen; siehe Purple für Züge.

Häufig gestellte Fragen

Funktioniert Purple mit Ruckus SmartZone, Ruckus One und Unleashed?

Ja, Purple Guest WiFi läuft auf Ruckus Hotspot-Diensten (WISPr) als externes Captive Portal. Purple ist hardwareunabhängig und funktioniert auch mit Cisco Meraki, HPE Aruba, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme und Fortinet. Der Controller übernimmt die Weiterleitung und RADIUS, während Purple die Splash-Page hostet und den Gast authentifiziert. Konfigurationswerte und -schritte finden Sie im Support-Artikel zum Captive Portal von Purple.

Benötigen wir neue Access Points, um Purple zu einem bestehenden Ruckus-Netzwerk hinzuzufügen?

Nein, Purple läuft als Cloud-Overlay auf den Ruckus Access Points und Controllern, die Sie bereits besitzen. Sie konfigurieren einen Hotspot-Dienst, eine Walled Garden und die RADIUS-Einstellungen auf dem Controller und weisen dann das Gast-WLAN auf Purple. Vor Ort wird nichts ausgetauscht. Der größte Aufwand liegt im Testen der Weiterleitung auf iOS-, Android-, Windows- und macOS-Geräten vor der Liveschaltung.

Können wir vom integrierten Ruckus-Gästewebsite auf Purple wechseln, ohne die Gäste zu stören?

Ja, wenn Sie die Purple-Konfiguration zuerst auf einem separaten Test-WLAN erstellen. Richten Sie den Hotspot-Dienst, die Walled Garden und die RADIUS-Dienste parallel zu Ihrem Live-Gastnetzwerk ein und testen Sie den vollständigen Login auf Testgeräten. Sobald es funktioniert, weisen Sie den neuen Hotspot-Dienst dem Live-WLAN in einer ruhigen Phase zu. Die Gäste sehen eine neue Splash-Page, keinen Ausfall.

Wie geht Purple mit Gästedaten um, die über ein Ruckus Captive Portal erfasst werden?

Purple erfasst First-Party-Daten durch bewusste Opt-ins auf der Splash-Page. Purple ist nach ISO 27001 und Cyber Essentials zertifiziert und arbeitet im Einklang mit der GDPR und der CCPA. Der Ruckus-Controller speichert keine Marketingdaten. Er übergibt einen einmaligen Login an den RADIUS-Server von Purple, sodass die Gästedaten auf der zertifizierten Plattform von Purple verbleiben, anstatt sich über einzelne Standort-Controller zu verteilen.

Wie lange dauert eine Ruckus Captive Portal Bereitstellung mit Purple?

Ein einzelner Standort ist in der Regel innerhalb einer Arbeitssitzung konfiguriert, da keine Hardwareänderungen erforderlich sind. Der Controller benötigt einen Hotspot-Dienst, eine Walled Garden sowie RADIUS-Authentifizierung und -Accounting. Multi-Standort-Umgebungen dauern länger, hauptsächlich aufgrund von Tests und Change-Management-Prozessen, nicht wegen der Konfiguration. Auf Ruckus One oder SmartZone sorgt eine zentral angewendete Vorlage für Konsistenz an jedem Standort und verringert das Risiko von Abweichungen zwischen den Standorten.

Für welche Größenordnungen ist die Guest WiFi Plattform von Purple ausgelegt?

Laut eigenen Unternehmensdaten wird Purple an über 80.000 Live-Standorten betrieben und verzeichnete im Jahr 2024 440 Millionen Logins. Diese Standorte erstrecken sich über das Gastgewerbe, den Einzelhandel, den Transportsektor, das Bildungswesen und den öffentlichen Sektor. Purple ist seit 2012 am Markt aktiv und jede Bereitstellung nutzt dieselbe Splash-Page und denselben RADIUS-Flow, der in diesem Leitfaden beschrieben wird - unabhängig davon, welcher unterstützte Hardware-Hersteller das zugrunde liegende Netzwerk betreibt.