Zum Hauptinhalt springen
Setup-Leitfaden

Cisco WLC Captive Portal
Setup-Leitfaden

Verbinden Sie Ihren Wireless-LAN-Controller Cisco Catalyst 9800 oder AireOS per Central Web Authentication (CWA) mit CaptiFi: Erfassen Sie Gäste-E-Mail-Adressen, automatisieren Sie Google-Bewertungen und lassen Sie Ihr Marketing auf Autopilot laufen. Kein ISE erforderlich.

📋 Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:
• Einen Cisco Catalyst 9800 (IOS-XE 17.x) oder einen AireOS-WLC (8.x: 5500, 8500 oder virtueller WLC) mit verbundenen und betriebsbereiten Access Points
• Admin-Zugriff auf den WLC (GUI oder CLI)
• Ein CaptiFi-Konto mit einem angelegten Cisco-Standort - erstellen Sie hier eines, wählen Sie dann im Einrichtungsassistenten auf my.captifi.io Cisco Catalyst 9800 / AireOS und im Schritt zum Betrieb Ihr WLC-Betriebssystem aus. Der Assistent legt den Standort an und zeigt Ihr Konfigurationspaket
• Ihr Konfigurationspaket aus dem Assistenten mit Ihrem RADIUS Shared Secret, der NAS-Kennung und allen unten verwendeten Werten (nach der Einrichtung finden Sie es unter Controller-Einstellungen im Menü Mehr auf der Karte des Betriebs unter Meine Standorte)

Einrichten im Assistenten

Wählen Sie im Einrichtungsassistenten in Ihrem CaptiFi-Dashboard auf my.captifi.io Cisco Catalyst 9800 / AireOS. Der Assistent legt Ihren Betrieb an, sobald Sie ihn benennen, und zeigt die Werte, die der WLC benötigt, als kopierbares Konfigurationspaket: die Adresse der Splash-Seite, die erlaubten Domains sowie RADIUS-Server, Ports, Shared Secret und NAS-Kennung. Eine Verbindungsprüfung zeigt dann, wann das erste Gastgerät die Anmeldeseite erreicht und wann der erste Gast sie abschließt.

1 Wie der CWA-Flow funktioniert

Seit August 2026 unterstützt CaptiFi beide Cisco-WLC-Betriebssysteme per Central Web Authentication (CWA): derselbe Ablauf wie bei ISE, wobei CaptiFi als RADIUS-Server fungiert. Sie benötigen kein ISE.

Catalyst 9800 Appliance, Cloud oder Embedded, mit IOS-XE 17.x. Folgen Sie den Schritten 2 bis 4 unten.
AireOS WLC 5500, 8500 oder virtueller WLC mit AireOS 8.x (der zum Beispiel Aironet-2700-APs versorgt). Folgen Sie den Schritten 2 und 3 sinngemäß, dann dem Abschnitt zu AireOS.

Der Ablauf zur Laufzeit: Ein Gast verbindet sich mit Ihrer offenen Gäste-SSID, der WLC sendet eine MAC-Authentifizierung (MAB) an den RADIUS-Server von CaptiFi, unbekannte Gäste werden in einen Quarantänezustand mit Weiterleitung auf Ihre CaptiFi-Splash-Seite aufgenommen, der Gast füllt das Splash-Formular aus, CaptiFi autorisiert seine MAC-Adresse und weist Ihren WLC an, die Sitzung erneut zu prüfen (CoA beim 9800, Disconnect-Request/PoD bei AireOS), und der WLC authentifiziert die Sitzung erneut und gewährt vollen Internetzugang.

💡 Auf einem Cisco WLC tragen Sie nie eine feste Splash-URL ein. CaptiFi gibt die Redirect-URL dynamisch in der RADIUS-Antwort zurück (im Attribut url-redirect) und leitet den Gast auf Ihre Splash-Seite im eigenen Branding, die Sie im Splash Page Builder auf my.captifi.io gestalten. Die genaue URL für Ihren Standort steht in Ihrem Konfigurationspaket.
⚠️ Der Name der Redirect-ACL und die RADIUS-Einstellungen müssen genau wie angegeben eingegeben werden. Die Konfiguration des Cisco 9800 unterscheidet sich je nach IOS-XE-Version: Wenn Sie nicht weiterkommen, schreiben Sie an support@captifi.io, und wir gehen es gemeinsam mit Ihnen durch.

2 Fügen Sie den CaptiFi RADIUS-Server hinzu

Gehen Sie in der Benutzeroberfläche des 9800 zu Configuration → Security → AAA → Servers/Groups → RADIUS → Servers → Add und geben Sie Folgendes ein:

Serveradresse radius.captifi.io
Auth-Port 1812
Accounting-Port 1813
Shared Secret Angezeigt im Schritt Ihren Controller konfigurieren des Assistenten und anschließend unter Controller-Einstellungen im Menü Mehr auf der Karte des Standorts unter Meine Standorte
Unterstützung für CoA Aktiviert

CLI-Äquivalent, einschließlich dynamischer Autorisierung für CoA:

radius server CAPTIFI address ipv4 <resolved-ip-of-radius.captifi.io> auth-port 1812 acct-port 1813 key <YOUR_SHARED_SECRET> aaa server radius dynamic-author client <radius-server-ip> server-key <YOUR_SHARED_SECRET>

Erstellen Sie dann eine Servergruppe und die Methodenlisten, auf die das WLAN verweist:

aaa group server radius CAPTIFI_GROUP server name CAPTIFI aaa authorization network CAPTIFI_AUTHZ group CAPTIFI_GROUP aaa accounting identity CAPTIFI_ACCT start-stop group CAPTIFI_GROUP

3 Die Redirect-ACL erstellen

Die ACL mit dem Namen CAPTIFI_REDIRECT steuert, welcher Datenverkehr abgefangen (auf die Splash-Seite umgeleitet) und welcher vor der Authentifizierung durchgelassen wird:

ip access-list extended CAPTIFI_REDIRECT 10 deny udp any any eq domain 20 deny udp any eq domain any 30 deny tcp any host <app.captifi.io IP> eq 443 40 deny tcp any host <captifi.io IP> eq 443 100 permit tcp any any eq www 110 permit tcp any any eq 443
💡 So funktionieren Cisco-Redirect-ACLs auf dem 9800: In einer CWA-Redirect-ACL bedeutet deny = NICHT umleiten (durchlassen) und permit = abfangen und umleiten. DNS und die CaptiFi-Hosts müssen deny sein (vor der Authentifizierung erreichbar), der gesamte übrige Webverkehr permit (umgeleitet).

Dies sind die CaptiFi Hosts, die vor dem Login erreichbar sein müssen:

  • app.captifi.io
  • captifi.io
⚠️ Der ACL-Name muss exakt CAPTIFI_REDIRECT lauten (Groß- und Kleinschreibung beachten). CaptiFi gibt diesen Namen im AV-Pair url-redirect-acl zurück, ein anderer Name wird daher nie zugeordnet.

4 Konfigurieren Sie das Gäste-WLAN für MAB

Gehen Sie zu Configuration → Tags & Profiles → WLANs → Add und konfigurieren Sie Folgendes:

Gast-SSID-Sicherheit Layer 2 → Keine (offen, die Splash-Seite übernimmt die Anmeldung)
MAC-Filterung Aktiviert, wählen Sie die CAPTIFI_AUTHZ Autorisierungsliste aus

Im Richtlinienprofil für dieses WLAN:

AAA-Override Aktiviert
NAC-Status Aktiviert, NAC-Typ RADIUS
Accounting-Liste CAPTIFI_ACCT
Wenden Sie das Richtlinienprofil über den Richtlinientag auf Ihr Gäste-WLAN an.

CLI-Äquivalent (wichtigste Zeilen):

wlan GUEST_WIFI 10 "Free WiFi" mac-filtering CAPTIFI_AUTHZ no security wpa no shutdown wireless profile policy GUEST_POLICY aaa-override nac accounting-list CAPTIFI_ACCT no shutdown

5 AireOS-Unterschiede (Legacy-WLCs)

AireOS (5500, 8500 oder virtueller WLC mit 8.x) verwendet dieselben CaptiFi-RADIUS-Einstellungen, aber eine andere GUI und, was wichtig ist, die entgegengesetzte ACL-Semantik.

Den RADIUS-Server hinzufügen

Gehen Sie zu Security → AAA → RADIUS → Authentication → New: Die Server-IP ist die aufgelöste IP von radius.captifi.io, das Shared Secret stammt aus Ihrem Konfigurationspaket, Port 1812, Support for CoA aktiviert. Wiederholen Sie dies unter Accounting mit Port 1813.

Die Redirect-ACL erstellen

Die ACL muss auch hier exakt CAPTIFI_REDIRECT heißen, aber Redirect-ACLs unter AireOS verwenden die normale Permit-Semantik, also das Gegenteil des Catalyst 9800: Sie geben per permit den Datenverkehr frei, der das Netzwerk vor der Authentifizierung erreichen soll, und das implizite Deny-all am Ende löst die Weiterleitung aus. Erlauben Sie unter Security → Access Control Lists DNS (UDP 53, beide Richtungen), DHCP (UDP 67 und 68, beide Richtungen) sowie TCP 80 und 443 zu app.captifi.io und captifi.io. Fügen Sie keine pauschale Permit-Regel für den gesamten Webverkehr hinzu: Das würde HTTP/HTTPS durchlassen und die Weiterleitung unterdrücken.

⚠️ FlexConnect Local Switching: Wenn Ihr Gäste-WLAN FlexConnect Local Switching verwendet, muss CAPTIFI_REDIRECT SOWOHL als FlexConnect-ACL existieren, die Ihrer FlexConnect-Gruppe zugeordnet ist (Wireless → FlexConnect Groups → Ihre Gruppe → ACL Mapping → Policies), ALS AUCH als identisch benannte reguläre ACL unter Security → Access Control Lists. Fehlt eine von beiden, ist das der häufigste Grund dafür, dass ein Client eine IP erhält, dann aber abgewiesen statt umgeleitet wird.

Konfigurieren Sie das Gäste-WLAN

Sicherheit → Layer 2 Keine, mit aktivierter MAC-Filterung
Sicherheit → Layer 3 Keine
Sicherheit → AAA-Server Wählen Sie den CaptiFi-RADIUS-Server für Authentifizierung und Accounting aus
Erweitert Allow AAA Override aktiviert, NAC State = RADIUS NAC (die GUI von AireOS 8.x nennt dies ISE NAC, es ist dieselbe Einstellung) und FlexConnect Local Switching aktiviert, wenn Ihre APs mit FlexConnect laufen
💡 Session-Bump unter AireOS: Nachdem ein Gast die Splash-Seite abgeschlossen hat, sendet CaptiFi einen RADIUS Disconnect-Request (Packet of Disconnect) an Ihren WLC auf UDP 3799. Der Client verbindet sich unbemerkt neu, durchläuft die MAC-Authentifizierung erneut und erhält vollen Zugang. Stellen Sie sicher, dass UDP 3799 eingehend von CaptiFi zur Management-IP des WLC offen ist. Beim Catalyst 9800 ist der entsprechende CoA-Port UDP 1700.

6 Lösung testen

Verbinden Sie ein Smartphone mit der Gäste-SSID. Die CaptiFi-Splash-Seite sollte automatisch erscheinen (oder öffnen Sie im Browser eine beliebige HTTP-Seite). Füllen Sie das Splash-Formular aus: Der volle Internetzugang sollte innerhalb weniger Sekunden gewährt werden, so lange dauern CoA und erneute Authentifizierung.

Prüfen Sie, ob die Erfassung in Ihrem CaptiFi-Dashboard unter Gästebesuche angekommen ist. Wenn der Gast erscheint, sind Sie live.

✅ Ihr Captive Portal von CaptiFi läuft jetzt in Ihrem Cisco-WLAN. Jeder Gast, der sich verbindet, sieht Ihre Anmeldeseite im eigenen Design, und seine E-Mail-Adresse wird automatisch erfasst.

Fehlerbehebung

Es erscheint keine Splash-Seite Prüfen Sie, ob die MAC-Filterung auf die CaptiFi-Autorisierungsliste verweist und der WLC radius.captifi.io:1812 (UDP) erreichen kann.
Splash-Seite wird nicht geladen Prüfen Sie die Redirect-ACL-Einträge für DNS und die CaptiFi-Hosts: Gäste müssen app.captifi.io vor der Authentifizierung erreichen können.
Gast hängt nach dem Absenden des Formulars fest CoA/PoD wird möglicherweise blockiert. Prüfen Sie, ob Dynamic Authorization aktiviert ist und der richtige UDP-Port eingehend von CaptiFi zum WLC offen ist: 1700 beim 9800, 3799 bei AireOS.
„RADIUS-Server reagiert nicht“ Prüfen Sie, ob das Shared Secret exakt übereinstimmt; stellen Sie sicher, dass keine Firewall UDP 1812/1813 ausgehend blockiert.
Funktioniert einmal, dann werden Gäste erneut zur Anmeldung aufgefordert Sitzungs-Timeout: CaptiFi gibt die Sitzungsdauer aus Ihren Standorteinstellungen zurück. Prüfen Sie autorisierte Minuten in Ihrem Dashboard.
ACL-Fehler in Logs Der ACL-Name muss exakt CAPTIFI_REDIRECT lauten (Groß-/Kleinschreibung beachten).
AireOS FlexConnect: Der Client erhält eine IP-Adresse, dann „Netzwerkzugang verweigert“, und wird nie umgeleitet Bei FlexConnect Local Switching greift die Umleitung nur, wenn CAPTIFI_REDIRECT sowohl als FlexConnect-ACL, die der Gruppe zugeordnet ist, als auch als identisch benannte reguläre ACL existiert. Siehe den Abschnitt zu AireOS oben.

Nützliche Debug-Befehle auf dem 9800:

show wireless client mac-address <mac> detail debug aaa authorization show access-lists CAPTIFI_REDIRECT

Funktioniert mit Ihrer bestehenden Cisco-Hardware, oder nutzen Sie unser mitgeliefertes Gerät

CaptiFi ist da ehrlich: Sie müssen nichts Neues kaufen. Es gibt zwei Wege: Ihre vorhandene Hardware funktioniert in jedem Tarif, und das Plug-and-Play-Gerät ist in jedem Tarif enthalten.

Verwenden Sie Ihre bestehende Cisco-Hardware Wenn Sie bereits einen Catalyst 9800 oder einen AireOS-WLC mit verbundenen Access Points betreiben, folgen Sie den obigen Schritten. CaptiFi fungiert als RADIUS-Server und liefert die Splash-Seite im eigenen Design aus. Kein ISE, keine zusätzliche Hardware.
Nutzen Sie unser mitgeliefertes Plug-and-Play-Gerät Kein Cisco-Controller, oder möchten Sie den WLC lieber nicht anfassen? Wir schicken Ihnen ein vorkonfiguriertes CaptiFi-Gerät per Post. Schließen Sie es per Ethernet an Ihr bestehendes Netzwerk an, geben Sie die 8-stellige Aktivierungs-PIN auf Ihrem Smartphone ein, und es holt sich seine Konfiguration aus der Cloud. Das Gäste-WLAN ist in etwa fünf Minuten startklar, von Anfang bis Ende, ohne Controller, statische IP oder Firewall-Änderung.
💡 Das Plug-and-Play-Gerät ist die Alternative ohne Konfiguration. Es ist in jedem Fall dieselbe Marketingplattform, sodass Sie mit unserem Gerät starten und später auf Ihre Cisco-Hardware umsteigen können, oder auch nie.

Lite: £19.99 pro Monat in Ihrem eigenen Netzwerk

Sie setzen bereits Cisco Catalyst ein? Lite bietet Gästeerfassung und CSV-Export auf Ihren vorhandenen Access Points, 500 neue Gäste pro Monat, für einen Standort. Die Splash-Seite behält das CaptiFi-Branding.

Verwandte Leitfäden und Seiten

FAQ zum Cisco WLC Captive Portal

Welche Cisco-Controller unterstützt CaptiFi?

Stand August 2026 unterstützt CaptiFi die Familie Catalyst 9800 (Appliance, Cloud und Embedded, mit IOS-XE 17.x) sowie AireOS-WLCs (5500, 8500 und virtueller WLC mit 8.x). Beide verwenden denselben CWA-Flow mit CaptiFi als RADIUS-Server.

Brauche ich Cisco ISE, um CaptiFi zu verwenden?

Nein. CaptiFi verwendet denselben ISE-ähnlichen Central Web Authentication-Flow, aber CaptiFi fungiert selbst als RADIUS-Server. Es gibt sonst nichts zu lizenzieren oder bereitzustellen.

Wo gebe ich die URL der Splash-Seite ein?

Das ist nicht nötig. Bei einem Cisco WLC wird die Redirect-URL dynamisch von CaptiFi in der RADIUS-Antwort zurückgegeben (im Attribut url-redirect), es gibt also kein Feld für eine Splash-URL, das auszufüllen wäre. Die Splash-Seite selbst gestalten Sie im Splash Page Builder auf my.captifi.io.

Warum bleibt mein Gast nach dem Absenden des Formulars auf der Splash-Seite hängen?

Die Nachricht zur erneuten Autorisierung wird wahrscheinlich blockiert. Prüfen Sie, ob die dynamische Autorisierung auf dem WLC aktiviert ist und ob der richtige UDP-Port für eingehenden Verkehr von CaptiFi offen ist: 1700 für CoA auf dem Catalyst 9800, 3799 für Disconnect-Request unter AireOS.

Wird CaptiFi mein Cisco-WLAN verlangsamen?

Nein. CaptiFi übernimmt nur die Splash-Seite zur Anmeldung und die RADIUS-Autorisierung. Sobald ein Gast durch ist, läuft sein Datenverkehr wie gewohnt direkt über Ihr Cisco-Netzwerk.

Ist das Cisco Captive Portal mit CaptiFi DSGVO-konform?

CaptiFi fragt die Marketing-Einwilligung getrennt vom Internetzugang ab und erfasst die Antwort jedes Gastes, und Gäste, die ablehnen, gelangen trotzdem in Ihr Cisco-WLAN. Jede Marketing-E-Mail enthält einen Abmeldelink, Löschen (DSGVO) und Anonymisieren (DSGVO) auf der Seite „Gästebesuche“ erledigen Löschanfragen, und die Datenverarbeitungsvereinbarung von CaptiFi ist veröffentlicht. Ihr Betrieb ist der datenschutzrechtlich Verantwortliche, daher bleibt die Einhaltung selbst bei Ihnen.

Für MSPs und Installateure

Richten Sie dies für einen Kunden ein?

CaptiFi-Partner kaufen in jedem Tarif zu einem Großhandelspreis unter dem Endkundenpreis ein, und White Label gibt es zu denselben Preisen. Sie legen Ihren eigenen Preis fest und rechnen direkt mit Ihren Kunden ab. Die vollständige Preisliste in Ihrer Währung steht im Partner-Dashboard, sobald Ihr Konto freigegeben ist, und Sie können sie bei der Bewerbung anfragen.

  • ✓ Preislisten in GBP, USD, EUR, CAD, AUD und NZD
  • ✓ Kostenlose 6-monatige interne Demo-Lizenz für einen internen Teststandort (nur Tests und Demos)
  • ✓ Partner-Dashboard ab Ihrer ersten Anmeldung nach der Freigabe sowie Schritt-für-Schritt-Checklisten für die Bereitstellung

Verwandeln Sie Ihr Cisco-Gäste-WLAN in eine Marketingmaschine

Starten Sie eine kostenlose 30-tägige Testphase oder sehen Sie sich zuerst eine Live-Demo an.