MikroTik RouterOS Captive Portal und Purple WiFi Integrationshandbuch
Dieser technische Leitfaden bietet Schritt-für-Schritt-Anleitungen für die Integration von MikroTik RouterOS mit der WiFi-Plattform von Purple. Er behandelt die Konfiguration des Guest WiFi Captive Portal, die Staff WiFi 802.1X-Authentifizierung und Multi-Tenant WiFi unter Verwendung von Private PSKs für die dynamische VLAN-Segmentierung.
Diesen Leitfaden anhören
Podcast-Transkript ansehen
- Executive Summary
- Technischer Deep-Dive
- Guest WiFi: Captive Portal und Walled Garden
- Staff WiFi: 802.1X-Authentifizierung
- Multi-Tenant WiFi: Private PSK (PPSK)
- Implementierungsleitfaden
- 1. Konfiguration des RADIUS-Clients
- 2. Guest WiFi Hotspot-Einrichtung
- 3. Staff WiFi 802.1X-Einrichtung
- 4. Multi-Tenant PPSK-Einrichtung
- Best Practices
- Fehlerbehebung & Risikominderung
- ROI & geschäftliche Auswirkungen

Executive Summary
Die Integration von MikroTik RouterOS mit Purple schafft ein einheitliches, identitätsgesteuertes Netzwerk für Gäste-, Mitarbeiter- und Multi-Tenant-Umgebungen. Dieser Leitfaden liefert die spezifische Konfigurationslogik, die für die Bereitstellung des Cloud-Overlays von Purple auf MikroTik-Hardware erforderlich ist. Sie erfahren, wie Sie das RouterOS Hotspot Gateway für die Guest WiFi -Umleitung konfigurieren, IEEE 802.1X für sicheres Staff WiFi implementieren und Private Pre-Shared Keys (PPSK) zur Isolierung des Multi-Tenant-WiFi-Datenverkehrs bereitstellen.
Indem Sie diesen Bereitstellungsmodellen folgen, segmentieren Sie Ihr Netzwerk sicher und erfassen gleichzeitig First-Party-Daten für WiFi Analytics . Purple verarbeitete im Jahr 2024 440 Millionen Anmeldungen bei einer Betriebszeit von 99,999 %, wodurch sich diese Architektur hervorragend für Umgebungen mit hoher Dichte in den Bereichen Retail , Hospitality und Transport eignet.
Technischer Deep-Dive
Guest WiFi: Captive Portal und Walled Garden
Das MikroTik Hotspot Gateway fängt nicht authentifizierten HTTP-Datenverkehr ab und leitet ihn an das gehostete Captive Portal von Purple weiter. Purple fungiert als RADIUS-Server und übernimmt die Authentifizierung sowie das Sitzungsmanagement.
Um sicherzustellen, dass das Captive Portal korrekt geladen wird, müssen Sie einen Walled Garden konfigurieren. Dies ermöglicht vor der Authentifizierung den Zugriff auf die Domänen der Purple-Begrüßungsseite, Content Delivery Networks (CDNs) und OAuth-Anbieter (wie Google Workspace und Microsoft Entra ID). Ohne diese Einträge wird die Umleitungsschleife unterbrochen.
Nach erfolgreicher Authentifizierung gibt der RADIUS-Server von Purple Standardattribute zurück, darunter Session-Timeout zur Durchsetzung von Verbindungslimits und optional Mikrotik-Rate-Limit zur Durchsetzung von Bandbreitenbeschränkungen direkt über das Purple-Dashboard.
Staff WiFi: 802.1X-Authentifizierung
Für Staff WiFi eliminieren Sie gemeinsam genutzte Passwörtern durch die Bereitstellung von IEEE 802.1X. Der MikroTik-Access-Point fungiert als Authentifikator und leitet EAP-Anmeldedaten an den RADIUS-Server von Purple weiter. Purple lässt sich nativ in Microsoft Entra ID, Okta und Google Workspace integrieren und validiert Anmeldedaten über PEAP-MSCHAPv2 oder EAP-TLS.
Wenn sich ein Mitarbeiter verbindet, kann der RADIUS-Server von Purple das Attribut Mikrotik-Wireless-VLANID zurückgeben. Dies weist den MikroTik-Router an, das authentifizierte Gerät in ein bestimmtes VLAN zu verschieben, was eine rollenbasierte Netzwerksegmentierung über eine einzige SSID ermöglicht. Für einen umfassenderen Überblick über Sicherheitsstandards lesen Sie bitte Enterprise WiFi Security: A Complete Guide for 2026 .
Multi-Tenant WiFi: Private PSK (PPSK)
Multi-Tenant-Umgebungen erfordern eine sichere Isolation ohne die Komplexität von 802.1X, da viele Endgeräte (wie Smart-TVs und Spielekonsolen) dies nicht unterstützen. MikroTik unterstützt Private PSK (PPSK) über eine MAC-basierte RADIUS-Authentifizierung.
Wenn sich ein Gerät mit der SSID verbindet, sendet der MikroTik-Router die MAC-Adresse des Geräts an Purple. Purple gibt das Attribut Mikrotik-Wireless-Psk (die eindeutige Passphrase für diesen Mandanten) und das Attribut Mikrotik-Wireless-VLANID zurück. Diese Architektur ermöglicht es Hunderten von Mandanten, sich eine einzige SSID zu teilen, während sie in völlig isolierten Netzwerbumgebungen verbleiben.

Implementierungsleitfaden
1. Konfiguration des RADIUS-Clients
Definieren Sie zunächst Purple als RADIUS-Server in RouterOS. Dies gilt für alle drei Anwendungsfälle.
/radius
add address=YOUR-PURPLE-RADIUS-IP secret=YOUR-SHARED-SECRET service=hotspot,wireless authentication-port=1812 accounting-port=1813 timeout=3000ms
2. Guest WiFi Hotspot-Einrichtung
Führen Sie den Hotspot-Setup-Assistenten auf Ihrer Guest-VLAN-Schnittstelle aus und aktivieren Sie anschließend die RADIUS-Authentifizierung für das resultierende Profil.
/ip hotspot profile
set [ find default=yes ] use-radius=yes radius-accounting=yes
Konfigurieren Sie den Walled Garden, um den Zugriff auf die Infrastruktur von Purple zu ermöglichen.
/ip hotspot walled-garden
add action=allow dst-host=*purple.ai
add action=allow dst-host=*purpleportal.net
3. Staff WiFi 802.1X-Einrichtung
Konfigurieren Sie das Wireless-Sicherheitsprofil so, dass es WPA2-Enterprise verwendet, und verweisen Sie es auf den RADIUS-Server.
/interface wireless security-profiles
add authentication-types=wpa2-eap eap-methods=passthrough mode=dynamic-keys name=staff-8021x radius-mac-authentication=no
Stellen Sie sicher, dass die Bridge-VLAN-Filterung aktiviert ist, um die dynamische VLAN-Zuweisung zu unterstützen.
/interface bridge
set bridge1 vlan-filtering=yes
4. Multi-Tenant PPSK-Einrichtung
Aktivieren Sie für PPSK die MAC-Authentifizierung im Wireless-Sicherheitsprofil und konfigurieren Sie das MAC-Adressformat.
/interface wireless security-profiles
add authentication-types=wpa2-psk mode=dynamic-keys name=multi-tenant-ppsk radius-mac-authentication=yes radius-mac-format=XX:XX:XX:XX:XX:XX

Best Practices
- Standardisieren Sie auf RouterOS 7: Die dynamische VLAN-Zuweisung über Wireless-RADIUS ist in RouterOS 7 im Vergleich zu RouterOS 6 deutlich robuster.
- RADIUS-Timeouts erhöhen: Das standardmäßige RADIUS-Timeout von MikroTik beträgt 1100 ms. Erhöhen Sie dieses auf 3000 ms, um sporadische Authentifizierungsfehler durch Netzwerklatenz zu vermeiden.
- Hostnamen-Walled-Garden-Einträge verwenden: Verwenden Sie für Walled-Garden-Einträge immer
dst-hostanstelle vondst-address, da sich IP-Adressen von Cloud-Infrastrukturen änge häufig. - Bridge-VLAN-Filterung aktivieren: Die dynamische VLAN-Zuweisung über RADIUS (
Mikrotik-Wireless-VLANID) erfordertvlan-filtering=yesauf der Bridge-Schnittstelle.
Fehlerbehebung & Risikominderung
Wenn das Captive Portal nicht geladen werden kann, ist der Walled Garden fast sicher unvollständig. Verwenden Sie das MikroTik Torch-Tool, um verworfene DNS-Anfragen von nicht authentifizierten Clients im Gäste-VLAN zu überwachen. Fügen Sie die fehlenden Domains dem Walled Garden hinzu.
Wenn die Authentifizierung von 802.1X-Clients fehlschlägt, überprüfen Sie das Shared Secret und stellen Sie sicher, dass der RADIUS-Client mit service=wireless konfiguriert ist. Überprüfen Sie die Protokolle im Purple-Dashboard, um zu bestätigen, ob die Access-Reject-Meldung von Purple oder Ihrem Identitätsanbieter stammt.
Wenn sich Clients authentifizieren, aber die falsche IP-Adresse erhalten, stellen Sie sicher, dass die Bridge-VLAN-Filterung aktiviert ist und der DHCP-Server korrekt an die dynamisch zugewiesene VLAN-Schnittstelle gebunden ist.
ROI & geschäftliche Auswirkungen
Die Bereitstellung von Purple in Ihrer MikroTik-Infrastruktur verwandelt eine Kostenstelle in eine Einnahmequelle. Durch die Erfassung von First-Party-Daten können Veranstaltungsorte detaillierte digitale Profile erstellen und Marketingkampagnen automatisieren. Beispielsweise erzielte Avanti West Coast eine Kapitalrendite (ROI) von 463 %, indem das Unternehmen von wiederkehrenden Reisenden und Upselling-Möglichkeiten profitierte.
Darüber hinaus reduziert identitätsbasiertes Networking den IT-Overhead. Die Automatisierung des Onboardings und Offboardings für das Mitarbeiter-WiFi über Entra ID macht die manuelle Passwortverwaltung überflüssig, während PPSK für Multi-Tenant-WiFi es Immobilienverwaltern ermöglicht, isolierte Netzwerke bereitzustellen, ohne dedizierte Hardware pro Einheit installieren zu müssen.
Schlüsseldefinitionen
Hotspot Gateway
Eine RouterOS-Funktion, die nicht authentifizierten HTTP-Datenverkehr abfängt und auf eine Captive Portal-Begrüßungsseite (Splash Page) umleitet.
Wird verwendet, um Gästedaten zu erfassen und Nutzungsbedingungen durchzusetzen, bevor Internetzugang gewährt wird.
Walled Garden
Eine Liste erlaubter Ziele, auf die nicht authentifizierte Benutzer zugreifen können.
Entscheidend dafür, dass Gäste die Purple-Begrüßungsseite, CDNs und OAuth-Anbieter (wie Google) erreichen können, um den Anmeldevorgang abzuschließen.
802.1X
Ein IEEE-Standard für die portbasierte Netzwerkzugriffskontrolle, der einen Authentifizierungsmechanismus für Geräte bereitstellt, die eine Verbindung mit einem LAN oder WLAN herstellen möchten.
Wird für sicheres Staff WiFi verwendet und ermöglicht die Authentifizierung über Entra ID oder Okta anstelle eines gemeinsamen Passworts.
Private PSK (PPSK)
Eine Sicherheitsarchitektur, bei der mehrere eindeutige Pre-Shared Keys auf einer einzigen SSID verwendet werden, die oft an bestimmte MAC-Adressen und VLANs gebunden sind.
Ideal für Multi-Tenant WiFi, da es isolierte Netzwerbumgebungen für Bewohner und deren Endgeräte bereitstellt.
RADIUS
Remote Authentication Dial-In User Service. Ein Netzwerkprotokoll, das eine zentrale Verwaltung von Authentifizierung, Autorisierung und Abrechnung (AAA) bereitstellt.
Das Kernprotokoll, das MikroTik-Hardware mit der Cloud-Plattform von Purple zur Identitätsprüfung verbindet.
VLAN-Filterung
Eine RouterOS-Bridge-Einstellung, die VLAN-Tagging- und Untagging-Regeln auf Bridge-Ports erzwingt.
Muss aktiviert sein, damit die dynamische VLAN-Zuweisung über RADIUS korrekt funktioniert.
CAPsMAN
Controlled Access Point system Manager. Das zentrale Wireless-Verwaltungssystem von MikroTik.
Wird verwendet, um konsistente Wireless-Sicherheitsprofile und RADIUS-Einstellungen über mehrere Access-Points hinweg bereitzustellen.
EAP-TLS
Extensible Authentication Protocol - Transport Layer Security. Eine hochsichere Authentifizierungsmethode, die clientseitige Zertifikate erfordert.
Wird von Purple für Zero-Trust-Staff WiFi-Bereitstellungen unterstützt, bei denen eine passwortlose Authentifizierung erforderlich ist.
Ausgearbeitete Beispiele
Ein Hotel mit 200 Zimmern muss sicheres Staff WiFi über seine MikroTik-Access-Points bereitstellen. Die Finanzabteilung soll im VLAN 10 und das Betriebspersonal im VLAN 20 platziert werden, unter Verwendung ihrer bestehenden Microsoft Entra ID-Anmeldedaten.
- Integrieren Sie Purple mit Microsoft Entra ID im Purple-Dashboard.
- Konfigurieren Sie den MikroTik RADIUS-Client so, dass er mit
service=wirelessauf Purple verweist. - Erstellen Sie ein MikroTik-Wireless-Sicherheitsprofil mit
authentication-types=wpa2-eap. - Aktivieren Sie
vlan-filtering=yesauf der MikroTik-Bridge. - Ordnen Sie in Purple die Entra ID-Gruppe „Finance“ so zu, dass sie
Mikrotik-Wireless-VLANID=10zurückgibt, und die Gruppe „Operations“ so, dass sieMikrotik-Wireless-VLANID=20zurückgibt.
Ein Verwalter von Mietwohnungen (Build-to-Rent) muss isolierte WiFi-Netzwerke für 50 Wohnungen über eine einzige SSID bereitstellen, die von MikroTik CAPsMAN übertragen wird.
- Konfigurieren Sie das MikroTik-Wireless-Sicherheitsprofil für die SSID mit
authentication-types=wpa2-pskundradius-mac-authentication=yes. - Stellen Sie sicher, dass der RADIUS-Client mit
service=wirelesskonfiguriert ist und auf Purple verweist. - Registrieren Sie im Purple-Dashboard die MAC-Adressen der Geräte der Bewohner.
- Weisen Sie jeder Wohnung in Purple einen eindeutigen PSK und eine VLAN-ID zu.
- Wenn sich ein Gerät verbindet, gibt Purple die Attribute
Mikrotik-Wireless-PskundMikrotik-Wireless-VLANIDzurück und platziert das Gerät in seiner isolierten Netzwerbumgebung.
Übungsfragen
Q1. Sie haben das MikroTik Hotspot Gateway konfiguriert und auf den RADIUS-Server von Purple verwiesen. Gäste verbinden sich mit der SSID, aber ihre Browser zeigen einen Timeout-Fehler anstelle der Purple-Begrüßungsseite an. Was ist der wahrscheinlichste Konfigurationsfehler?
Hinweis: Überlegen Sie, was passieren muss, bevor sich der Gast authentifiziert.
Musterlösung anzeigen
Der Walled Garden ist falsch konfiguriert oder es fehlen Einträge. Ohne den Zugriff auf die Domänen der Purple-Begrüßungsseite und die zugehörigen CDNs in /ip hotspot walled-garden zuzulassen, kann der nicht authentifizierte Gast die Anmeldeseite nicht laden, was zu einem Timeout führt.
Q2. Eine Einzelhandelskette möchte Staff WiFi unter Verwendung von 802.1X und Entra ID bereitstellen. Sie konfigurieren `authentication-types=wpa2-eap` und richten den RADIUS-Client ein. Die Authentifizierung schlägt jedoch fehl. Sie überprüfen die Konfiguration des RADIUS-Clients und sehen `service=hotspot`. Wie lösen Sie dieses Problem?
Hinweis: Verschiedene Wireless-Authentifizierungsmethoden erfordern unterschiedliche RADIUS-Diensttypen in RouterOS.
Musterlösung anzeigen
Ändern Sie die Konfiguration des RADIUS-Clients so, dass sie service=wireless enthält. Der Diensttyp hotspot wird nur für die Captive Portal-Authentifizierung verwendet. Die 802.1X- und MAC-Authentifizierung erfordern den Diensttyp wireless.
Q3. Sie stellen Multi-Tenant WiFi unter Verwendung von Private PSKs bereit. Purple gibt die Attribute `Mikrotik-Wireless-Psk` und `Mikrotik-Wireless-VLANID` erfolgreich zurück, und das Gerät verbindet sich. Das Gerät erhält jedoch eine IP-Adresse aus dem Standard-Verwaltungssubnetz und nicht aus dem isolierten Mandantensubnetz. Welche RouterOS-Einstellung fehlt?
Hinweis: Die dynamische VLAN-Zuweisung erfordert, dass die Bridge VLAN-Tags verarbeitet.
Musterlösung anzeigen
Die Bridge-VLAN-Filterung ist deaktiviert. Sie müssen vlan-filtering=yes auf der Bridge-Schnittstelle festlegen. Ohne diese Einstellung ignoriert die Bridge das von RADIUS zugewiesene dynamische VLAN-Tag, und der Datenverkehr fällt auf die standardmäßige ungetaggte PVID zurück.
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.
Cisco WLC and Catalyst Integration with Purple WiFi: Step-by-Step Guest Access Guide
Diese Anleitung beschreibt die schrittweise Integration von Cisco WLC und Catalyst 9800 Wireless mit Purple. Sie umfasst die Weiterleitung zum Guest WiFi Captive Portal über Central Web Authentication, sicheres Mitarbeiter-WiFi mittels 802.1X EAP-TLS sowie Multi-Tenant-Segmentierung über Cisco Identity Pre-Shared Keys (iPSK) mit dynamischer VLAN-Zuweisung. Sie richtet sich an Netzwerkarchitekten in Unternehmen und IT-Sicherheitsverantwortliche, die Cisco-Infrastrukturen im Gastgewerbe, im Einzelhandel und in großen öffentlichen Veranstaltungsorten bereitstellen.
OpenWrt Custom Firmware Integration with Purple WiFi
Dieses Handbuch bietet das vollständige Integrations-Playbook für die Bereitstellung von OpenWrt Custom Firmware mit Purple WiFi. Es deckt die Konfiguration des CoovaChilli Captive Portal, die Verwaltung des iptables Walled Garden, sicheres Mitarbeiter-WiFi über 802.1X mit hostapd sowie die mandantenfähige PPSK-Segmentierung mit dynamischer VLAN-Zuweisung ab. Damit erhalten IT-Teams die genauen Konfigurationsschritte, die für den Aufbau eines identitätsbasierten Netzwerks auf jeder OpenWrt-fähigen Hardware erforderlich sind.