Cisco WLC und Catalyst Integration mit Purple WiFi: Schritt-für-Schritt-Anleitung für den Gastzugang
Diese massgebliche Anleitung beschreibt die schrittweise Integration von Cisco Catalyst 9800 WLCs mit Purple WiFi. Sie deckt die externe Web-Authentifizierung für Gäste-Captive Portals, 802.1X EAP-TLS für sicheren Mitarbeiterzugang und Cisco iPSK für die dynamische VLAN-Segmentierung in Mandanten-Umgebungen ab.
Diesen Leitfaden anhören
Podcast-Transkript ansehen
- Management-Zusammenfassung
- Technischer Deep-Dive: Architektur und Authentifizierungsabläufe
- 1. Guest WiFi: External Web Authentication (EWA)
- 2. Staff WiFi: 802.1X EAP-TLS und PEAP
- 3. IoT und Multi-Tenant: Cisco Identity PSK (iPSK)
- Implementierungsleitfaden
- Konfiguration der Captive Portal Weiterleitung für Gäste
- Konfiguration der dynamischen VLAN-Zuweisung für iPSK
- Best Practices
- Fehlerbehebung & Risikominderung
- ROI & geschäftlicher Nutzen
- Referenzen

Management-Zusammenfassung
Die Bereitstellung eines sicheren, konformen und skalierbaren Drahtlosnetzwerks in Unternehmensumgebungen erfordert eine enge Integration zwischen Infrastruktur und Identitätsanbietern. Dieser Leitfaden beschreibt die architektonischen Entscheidungen und Konfigurationsschritte, die für die Integration von Cisco Catalyst 9800 Wireless LAN Controllern (WLC) in die Cloud-Plattform von Purple erforderlich sind.
Für den Gastzugang untersuchen wir die externe Web-Authentifizierung (EWA) für die Weiterleitung zum Captive Portal, um die Erfassung von Erstanbieterdaten und Guest WiFi -Analysen zu ermöglichen. Für den Mitarbeiterzugang beschreiben wir die 802.1X EAP-TLS- und PEAP-Authentifizierung unter Verwendung von Purple SecurePass als RADIUS-Proxy für Microsoft Entra ID oder Okta. Für IoT- und Mandanten-Umgebungen skizzieren wir die Cisco Identity PSK (iPSK)-Konfiguration, die eine dynamische VLAN-Zuweisung und Netzwerksegmentierung auf einer einzigen SSID ermöglicht, ohne auf komplexe Zertifikatsbereitstellungen angewiesen zu sein.
Purple wird in weltweit über 80.000 aktiven Standorten betrieben und verarbeitete im Jahr 2024 440 Millionen Logins. Diese Integration hat sich in hochfrequentierten Umgebungen in den Bereichen Hospitality , Retail und Transport bewährt, in denen Betriebszeit, Compliance und ein nahtloses Benutzererlebnis unverzichtbar sind.
Technischer Deep-Dive: Architektur und Authentifizierungsabläufe
1. Guest WiFi: External Web Authentication (EWA)
Um ein gebrandetes Captive Portal bereitzustellen und Benutzerdaten für WiFi Analytics zu erfassen, muss der Cisco Catalyst 9800 WLC nicht authentifizierten HTTP-Traffic abfangen und auf die von Purple in der Cloud gehostete Splash Page umleiten. Dieser Mechanismus wird als External Web Authentication (EWA) bezeichnet.

Der Prozess folgt einem bestimmten Ablauf:
- Der Client verbindet sich mit der offenen oder Opportunistic Wireless Encryption (OWE) SSID.
- Der WLC versetzt den Client in den Zustand
Webauth_reqdund wendet eine Pre-Authentication Access Control List (ACL) an. - Der WLC fängt die HTTP-Anfrage des Clients ab und sendet einen 302-Redirect an die Splash-Page-URL von Purple, wobei Parameter wie die AP-MAC-Adresse, die Client-MAC-Adresse und die WLAN-SSID angehängt werden.
- Der Client schließt den Authentifizierungsprozess auf dem Purple-Portal ab (z. B. Social Login, E-Mail-Erfassung oder Zustimmung zu den Nutzungsbedingungen).
- Der RADIUS-Server von Purple sendet eine Access-Accept-Nachricht an den WLC.
- Der WLC versetzt den Client in den Zustand
Runund gewährt Internetzugang basierend auf der Post-Authentication-Richtlinie.
2. Staff WiFi: 802.1X EAP-TLS und PEAP
Für firmeneigene Geräte bietet WPA2/WPA3 Enterprise mit 802.1X das stärkste Sicherheitsniveau. Anstatt einen lokalen RADIUS-Server wie Cisco ISE bereitzustellen, fungiert Purple SecurePass als Cloud-RADIUS-Proxy. Es beendet den EAP-Tunnel und leitet die Identitätsprüfung an Ihren Identity Provider (IdP) weiter, wie z. B. Microsoft Entra ID oder Google Workspace.
- EAP-TLS: Empfohlen für verwaltete Unternehmensgeräte. Erfordert die Bereitstellung von Client-Zertifikaten über ein MDM (z. B. Microsoft Intune). Die Authentifizierung erfolgt im Hintergrund und ist hochsicher.
- PEAP-MSCHAPv2: Empfohlen für BYOD-Umgebungen, in denen eine Zertifikatsbereitstellung unpraktisch ist. Benutzer authentifizieren sich mit ihren Unternehmens-Anmeldedaten.
3. IoT und Multi-Tenant: Cisco Identity PSK (iPSK)
In Umgebungen wie Build-to-Rent-Immobilien (BTR), Studentenwohnheimen oder Einzelhandelsgeschäften mit zahlreichen IoT-Geräten ist die Bereitstellung von 802.1X oft unmöglich, da die Geräte keine Supplicant-Unterstützung bieten. Das Erstellen einer eigenen SSID für jeden Mieter oder Gerätetyp führt zu einer Überlastung des Frequenzspektrums.
Cisco iPSK löst dieses Problem, indem es mehrere eindeutige Pre-Shared Keys (PSKs) auf einer einzigen SSID ermöglicht. Wenn sich ein Gerät verbindet, sendet der WLC seine MAC-Adresse an den RADIUS-Server von Purple. Purple gibt den spezifischen PSK für dieses Gerät zusammen mit Attributen für die dynamische VLAN-Zuweisung zurück und segmentiert so den Datenverkehr direkt am Switch-Port.

Implementierungsleitfaden
Konfiguration der Captive Portal Weiterleitung für Gäste
Um die externe Web-Authentifizierung auf dem Catalyst 9800 WLC zu konfigurieren, müssen Sie eine Parameter-Map und einen URL-Filter definieren, um den Datenverkehr vor der Authentifizierung zum Portal von Purple zuzulassen [1].
Schritt 1: Erstellen der Web-Authentifizierungs-Parameter-Map
Konfigurieren Sie den WLC so, dass Clients zum Purple Portal weitergeleitet werden, wobei die erforderlichen Variablen übergeben werden. Sie müssen die virtuelle IPv4-Adresse (normalerweise 192.0.2.1) global konfigurieren.
parameter-map type webauth PURPLE-GUEST
type consent
timeout init-state sec 600
redirect for-login https://portal.purple.ai
redirect append ap-mac tag ap_mac
redirect append wlan-ssid tag wlan
redirect append client-mac tag client_mac
redirect portal ipv4
logout-window-disabled
success-window-disabled
Schritt 2: Konfigurieren des URL-Filters vor der Authentifizierung
Clients müssen das Portal von Purple erreichen können, bevor sie authentifiziert werden. Der 9800 WLC verwendet URL-Filter, um basierend auf DNS-Snooping dynamisch Ausnahmen in der Intercept-ACL zuzulassen.
urlfilter list PURPLE-PREAUTH
action permit
url portal.purple.ai
Wenden Sie diesen URL-Filter auf Ihr WLAN-Richtlinienprofil unter den ACL-Einstellungen vor der Authentifizierung an.
Konfiguration der dynamischen VLAN-Zuweisung für iPSK
Um Benutzer oder Geräte dynamisch in bestimmte VLANs einzuteilen, muss der Purple RADIUS-Server drei spezifische IETF-Attribute in der Access-Accept-Antwort senden [2].
- IETF 64 (Tunnel-Type): Auf
VLANfestgelegt (Wert 13). - IETF 65 (Tunnel-Medium-Type): Auf
802festgelegt (Wert 6). - IETF 81 (Tunnel-Private-Group-ID): Auf die VLAN-ID als String festgelegt (z. B.
"10").
Stellen Sie auf dem Catalyst 9800 WLC sicher, dass die folgenden Einstellungen für das iPSK WLAN konfiguriert sind:
- MAC-Filterung ist aktiviert.
- AAA Override ist aktiviert (entscheidend für die Annahme der RADIUS-VLAN-Zuweisung).
- Layer 2 Security ist auf WPA2-PSK eingestellt (der konfigurierte PSK fungiert als Fallback).
Best Practices
- VLAN-Verifizierung: Die vom RADIUS-Server in
Tunnel-Private-Group-IDzurückgegebene VLAN-ID MUSS als dynamische Schnittstelle auf dem WLC existieren. Ist dies nicht der Fall, verschiebt der WLC den Client in das native VLAN, was ein erhebliches Sicherheitsrisiko darstellt. - Zertifikats-Vertrauensketten: Laden Sie bei EAP-TLS-Bereitstellungen Ihre Root-CA- und alle Intermediate-CA-Zertifikate in das Purple SecurePass-Dashboard hoch, bevor Sie Client-Zertifikate ausrollen. Wenn der RADIUS-Server die Kette nicht validieren kann, schlägt die Authentifizierung geräuschlos fehl.
- Redundantes RADIUS: Konfigurieren Sie immer sekundäre RADIUS-Server. Stellen Sie den primären Timeout auf 3 Sekunden mit 2 Wiederholungsversuchen ein, um ein schnelles Failover zu gewährleisten, ohne den Benutzer zu frustrieren.
- WPA3-Einführung: Verwenden Sie WPA3-SAE für iPSK-Netzwerke, sofern dies von den Client-Geräten unterstützt wird. Implementieren Sie für offene Gastnetzwerke WPA3-OWE (Opportunistic Wireless Encryption), um den Datenverkehr ohne Passworteingabe zu verschlüsseln.
Fehlerbehebung & Risikominderung
| Fehlermodus | Symptom | Ursache | Behebung |
|---|---|---|---|
| Redirect-Schleife | Das Client-Gerät lädt die Captive Portal-Seite ständig neu, ohne sie vollständig anzuzeigen. | Die Pre-Authentication-ACL oder der URL-Filter lässt den Zugriff auf die Portal-IP-Adressen von Purple nicht zu. Der WLC leitet den Client weiter, der Client versucht, die Seite zu laden, der WLC blockiert dies und leitet erneut weiter. | Überprüfen Sie, ob der URL-Filter PURPLE-PREAUTH auf das Policy-Profil angewendet wird und die Portal-Domain korrekt geschrieben ist. Stellen Sie sicher, dass DNS-Verkehr vor der Authentifizierung zugelassen ist. |
| iPSK-Fallback-Fehler | Ein nicht registriertes IoT-Gerät verbindet sich mit dem Netzwerk, erhält jedoch die falsche IP-Adresse. | Die MAC-Adresse des Geräts ist nicht in der RADIUS-Datenbank von Purple vorhanden. Der WLC fällt auf den auf dem WLAN konfigurierten globalen PSK zurück und weist das Standard-VLAN zu. | Überprüfen Sie die MAC-Adresse im Purple-Dashboard. Stellen Sie sicher, dass das dem WLAN-Policy-Profil zugewiesene Standard-VLAN ein eingeschränktes Quarantänenetzwerk ist und nicht das Unternehmens-LAN. |
| RADIUS-Timeout | Clients haben lange Verzögerungen beim Verbindungsaufbau; WLC-Protokolle zeigen an, dass der RADIUS-Server nicht erreichbar ist. | Firewalls zwischen dem WLC und den Cloud-RADIUS-Endpunkten von Purple blockieren die UDP-Ports 1812 (Authentifizierung) oder 1813 (Accounting). | Überprüfen Sie, ob die ausgehenden Firewall-Regeln UDP 1812/1813 von der WLC-Management-Schnittstelle zu den veröffentlichten RADIUS-IP-Adressen von Purple zulassen. |
ROI & geschäftlicher Nutzen
Die Implementierung einer einheitlichen Architektur mit Cisco und Purple liefert messbaren Geschäftswert über drei Säulen hinweg:
- Betriebliche Effizienz: Der Ersatz der manuellen VLAN-Bereitstellung und mehrerer SSIDs durch iPSK reduziert das IT-Ticketvolumen. Die Automatisierung des IoT-Onboardings über die API spart pro Standort Stunden an Technikerzeit.
- Compliance und Sicherheit: Die dynamische VLAN-Zuweisung stellt die PCI DSS-Compliance in Einzelhandelsumgebungen sicher, indem sie Zahlungsterminals strikt vom Gäste-Traffic isoliert (Anforderung 1.3). EAP-TLS eliminiert das Risiko gemeinsam genutzter Mitarbeiterpasswörter.
- Umsatzgenerierung: Die Integration von Captive Portal verwandelt eine Kostenstelle (Gast-WiFi) in ein Marketing-Asset. Das Erfassen von bewussten Opt-ins baut eine First-Party-Datenbank auf, die Kundenbindungskampagnen und wiederholte Besuche fördert.
Referenzen
[1] Cisco Systems, "Configure Spaces Captive Portal with Catalyst 9800 WLC," Mai 2025. [2] Cisco Systems, "Configure a RADIUS Server and WLC for Dynamic VLAN Assignment," September 2012.
Schlüsseldefinitionen
Externe Web-Authentifizierung (EWA)
Ein Mechanismus, bei dem der Cisco WLC nicht authentifizierten HTTP-Verkehr abfängt und den Client zur Authentifizierung an ein extern gehostetes Captive Portal (wie Purple) weiterleitet.
Wird verwendet, um gebrandete Splash Pages bereitzustellen und First-Party-Daten zu erfassen, ohne auf den begrenzten internen Webserver des WLC angewiesen zu sein.
Identity PSK (iPSK)
Eine Cisco-Funktion, mit der mehrere eindeutige Pre-Shared Keys auf einer einzigen SSID verwendet werden können, wobei jeder Schlüssel über RADIUS einer bestimmten Client-MAC-Adresse und einem VLAN zugeordnet wird.
Unerlässlich für die Absicherung von IoT-Geräten und Mandanten-Umgebungen, in denen 802.1X nicht unterstützt wird, wodurch der Bedarf an mehreren SSIDs verringert wird.
AAA Override
Eine WLAN-Einstellung auf dem Cisco WLC, die den Controller zwingt, vom RADIUS-Server zurückgegebene Richtlinienparameter (wie VLAN-IDs oder ACLs) zu akzeptieren und die lokale WLAN-Konfiguration zu überschreiben.
Muss aktiviert sein, damit die dynamische VLAN-Zuweisung und iPSK korrekt funktionieren.
EAP-TLS
Extensible Authentication Protocol - Transport Layer Security. Eine hochsichere 802.1X-Authentifizierungsmethode, die auf einem gegenseitigen Zertifikatsaustausch anstelle von Passwörtern basiert.
Der Goldstandard für die WiFi-Sicherheit von Mitarbeitern, der ein MDM erfordert, um Client-Zertifikate auf Unternehmensgeräten bereitzustellen.
PEAP-MSCHAPv2
Protected Extensible Authentication Protocol. Eine 802.1X-Methode, die den Authentifizierungsprozess innerhalb eines TLS-Tunnels verschlüsselt, sodass sich Benutzer sicher mit Benutzername und Passwort authentifizieren können.
Wird für BYOD-Mitarbeiternetzwerke verwendet, bei denen die Bereitstellung von Client-Zertifikaten nicht machbar ist.
Pre-Authentication ACL
Eine Access Control List, die auf einen Wireless-Client angewendet wird, bevor er sich authentifiziert hat, und die genau festlegt, welche Netzwerkressourcen er erreichen kann.
Entscheidend für Captive Portals; sie muss DNS und den Zugriff auf die IP-Adressen der Purple Splash Page erlauben, während der gesamte andere Datenverkehr blockiert wird.
Dynamische Schnittstelle
Eine auf dem WLC erstellte logische Schnittstelle, die einer bestimmten VLAN-ID und einem physischen Port zugeordnet ist.
Wenn RADIUS eine VLAN-ID für die dynamische Zuweisung zurückgibt, muss dieses VLAN bereits als dynamische Schnittstelle auf dem WLC existieren, andernfalls wird der Client in das native VLAN verschoben.
WPA3-SAE
Simultaneous Authentication of Equals. Der moderne Ersatz für WPA2-PSK, der Forward Secrecy und Schutz vor Offline-Wörterbuchangriffen bietet.
Unterstützt von Cisco Catalyst 9800 und Purple RADIUS zur Absicherung moderner IoT- und Gastnetzwerke.
Ausgearbeitete Beispiele
Ein Hotel mit 200 Zimmern muss den Netzwerkverkehr für Gäste, Mitarbeiter und IoT-Geräte (Türschlösser, Thermostate) über einen einzigen Cisco Catalyst 9800 WLC segmentieren, ohne mehrere SSIDs zu erstellen, die zu RF-Überlastung führen.
Richten Sie eine einzelne SSID unter Verwendung von Cisco iPSK ein. Registrieren Sie die MAC-Adresse jedes IoT-Geräts im Dashboard von Purple und weisen Sie jedes dem VLAN 30 zu. Konfigurieren Sie das WLC WLAN mit MAC-Filterung, AAA Override und WPA2-PSK. Wenn sich ein Türschloss verbindet, gibt der RADIUS-Server von Purple den eindeutigen PSK sowie die IETF-Attribute 64, 65 und 81 zurück, um das Gerät dynamisch in das VLAN 30 zu leiten. Gäste nutzen eine separate offene SSID mit externer Web-Authentifizierung, die auf das Captive Portal von Purple verweist.
Eine Einzelhandelskette mit 80 Filialen muss den Datenverkehr von Zahlungsterminals vom Gäste-WiFi-Verkehr trennen, um die PCI-DSS-Konformität zu wahren, die zentral über das Cisco Catalyst Centre verwaltet wird.
Konfigurieren Sie die Gäste-SSID mit einer Pre-Authentication ACL, die Datenverkehr, der für das Subnetz der Zahlungsterminals (VLAN 40) bestimmt ist, explizit verwirft. Verwenden Sie iPSK, um Zahlungsterminals zu authentifizieren, und weisen Sie sie über den RADIUS-Server von Purple dynamisch dem VLAN 40 zu. Der Gästeverkehr wird über das Captive Portal von Purple authentifiziert und dem VLAN 10 zugewiesen.
Übungsfragen
Q1. Sie stellen ein Captive Portal auf einem Catalyst 9800 WLC bereit. Clients verbinden sich mit der SSID, aber ihre Browser laden die URL der Splash Page kontinuierlich neu, ohne den Inhalt jemals anzuzeigen. Was ist die wahrscheinlichste architektonische Ursache?
Hinweis: Berücksichtigen Sie den Status des Clients, bevor die Authentifizierung abgeschlossen ist, und welcher Datenverkehr zulässig ist.
Musterlösung anzeigen
Die Pre-Authentication-ACL oder der URL-Filter ist falsch konfiguriert. Sie blockiert den Zugriff auf die IP-Adressen des Portals von Purple. Der WLC fängt den Datenverkehr ab und leitet ihn zum Portal weiter, aber der Client kann das Portal nicht erreichen, um es zu laden, was eine Endlosschleife bei der Weiterleitung auslöst. Sie müssen die IP-Adressen von Purple explizit zulassen oder einen URL-Filter für die Portal-Domain verwenden.
Q2. Ein IoT-Gerät authentifiziert sich erfolgreich über iPSK, und der RADIUS-Server von Purple gibt ein Access-Accept mit den IETF-Attributen 64, 65 und 81 zurück, die VLAN 50 spezifizieren. Das Gerät wird jedoch im VLAN 10 (dem Management-VLAN) platziert. Warum ist das passiert?
Hinweis: Denken Sie an die Voraussetzungen, die auf dem WLC selbst erforderlich sind, um ein per RADIUS zugewiesenes VLAN zu akzeptieren und anzuwenden.
Musterlösung anzeigen
Entweder ist "AAA Override" in den erweiterten WLAN-Einstellungen deaktiviert, was dazu führt, dass der WLC die RADIUS-Attribute ignoriert, ODER VLAN 50 existiert nicht als konfiguriertes dynamisches Interface auf dem WLC. Wenn das zugewiesene VLAN lokal nicht existiert, fällt der WLC auf das native/Management-VLAN zurück.
Q3. Ein Standort möchte 802.1X für das Mitarbeiter-WiFi unter Verwendung von Microsoft Entra ID bereitstellen. Sie verfügen über keinen lokalen RADIUS-Server wie Cisco ISE. Wie kann dies über die Purple-Plattform realisiert werden?
Hinweis: Überlegen Sie, wie Purple den EAP-Tunnel und die Identitätsprüfung handhabt.
Musterlösung anzeigen
Konfigurieren Sie den WLC so, dass er Purple SecurePass als RADIUS-Server verwendet. Purple fungiert als Cloud-RADIUS-Proxy, beendet den EAP-TLS- oder PEAP-Tunnel vom WLC und leitet die Identitätsabfrage über API/SAML sicher an Microsoft Entra ID weiter. Es ist kein lokaler RADIUS-Server erforderlich.
Weiterlesen in dieser Reihe
CommScope Ruckus Integration mit Purple WiFi: Einrichtungs- und Konfigurationshandbuch
Dieses technische Referenzhandbuch bietet einen maßgeblichen Konfigurationsleitfaden für die Integration von CommScope Ruckus-Architekturen mit Purple WiFi. Es beschreibt Schritt-für-Schritt-Bereitstellungen für Guest WiFi Captive Portals, sicheres Mitarbeiter-WiFi über 802.1X und mandantenfähige Netzwerkisolierung mithilfe von Ruckus Dynamic PSK.
Allied Telesis Access Points Integration mit Purple WiFi
Dieses Handbuch bietet eine umfassende Konfigurationsanleitung für die Integration von Allied Telesis Access Points der TQ-Serie mit Purple WiFi. Es behandelt die externe Captive Portal-Weiterleitung, die 802.1X-RADIUS-Authentifizierung und die dynamische VLAN-Steuerung mithilfe von Private Pre-Shared Keys (PPSK) für sichere Multi-Tenant-Bereitstellungen.
Grandstream GWN Access Points Integration mit Purple WiFi
Dieses maßgebliche technische Handbuch beschreibt die Integration von Grandstream GWN Access Points mit dem Purple Guest WiFi und der Analytics-Plattform. Es umfasst die Konfiguration des Grandstream Captive Portal, die RADIUS AAA-Einstellungen, die Einrichtung des Walled Garden, die sichere 802.1X-Authentifizierung für Mitarbeiter mit dynamischer VLAN-Steuerung sowie die Multi-Tenant-PPSK-Segmentierung – eine praxisnahe Schritt-für-Schritt-Anleitung für MSPs und IT-Teams, die WiFi für Gäste und Mitarbeiter in großem Stil bereitstellen.