Huawei AirEngine und CloudCampus Integration mit Purple WiFi
Diese Anleitung bietet Schritt-für-Schritt-Anweisungen für die Integration von Huawei AirEngine Access Points und iMaster NCE-Campus mit Purple WiFi. Sie deckt die Captive Portal-Konfiguration, die 802.1X-Mitarbeiterauthentifizierung und das dynamische PPSK-VLAN-Steering für Unternehmensnetzwerke ab.
Diesen Leitfaden anhören
Podcast-Transkript ansehen
- Executive Summary
- Technischer Deep-Dive
- Architektur-Übersicht
- Walled Garden und Pre-Authentication-ACLs
- Dynamisches VLAN-Steering und RADIUS-Attribute
- Implementierungsleitfaden
- Schritt 1: Konfigurieren des RADIUS-Relay-Servers
- Schritt 2: Erstellen der Walled Garden ACL
- Schritt 3: Konfigurieren der Captive Portal-URL-Vorlage
- Schritt 4: Bereitstellung der Guest SSID
- Best Practices
- Fehlerbehebung & Risikominderung
- Splash-Page lädt nicht
- Lautlose Authentifizierungsfehler
- DHCP-Timeout nach der Authentifizierung
- ROI & geschäftliche Auswirkungen

Executive Summary
Unternehmensnetzwerke erfordern zuverlässige Hardware gepaart mit intelligentem Identitätsmanagement. Huawei AirEngine Access Points und der iMaster NCE-Campus-Controller bieten hochverdichtete Konnektivität, während Purple das Cloud-Overlay für Authentifizierung, Analysen und Richtliniendurchsetzung bereitstellt. Diese Anleitung beschreibt die Integrationsarchitektur, die für die Bereitstellung von Gäste-WiFi , sicherem Mitarbeiter-WiFi und mandantenfähigem WiFi über einen einzigen Huawei-Controller erforderlich ist.
Durch die Integration von Huawei CloudCampus mit Purple ersetzen Sie isolierte Authentifizierungssilos durch ein einheitliches identitätsbasiertes Netzwerk. Wir sind an über 80.000 aktiven Standorten im Einsatz und haben allein im Jahr 2024 440 Millionen Logins verarbeitet. Unsere hardwareunabhängige Plattform lässt sich nativ über Standard-RADIUS- und Captive Portal-Protokolle in Huawei integrieren. Diese Integration ermöglicht bewusste Opt-ins für Besucher, die 802.1X-Zertifikatsvalidierung für Mitarbeiter und ein dynamisches VLAN-Steering über Private Pre-Shared Keys (PPSK) für Mandanten.
Unabhängig davon, ob Sie ein Stadion, einen Universitätscampus oder eine Einzelhandelskette verwalten, bietet dieses Dokument die genauen Konfigurationsschritte, RADIUS-Attribute und Access Control Lists (ACLs), die erforderlich sind, um Ihren Wireless Edge zu sichern und First-Party-Daten in großem Umfang zu erfassen.
Hören Sie sich den Podcast zum technischen Briefing an:
Technischer Deep-Dive
Die Integration basiert auf Standardprotokollen: RADIUS (UDP 1812/1813) für Authentifizierung und Accounting sowie HTTPS (TCP 443) für die Captive Portal-Umleitung. iMaster NCE-Campus fungiert als Network Access Server (NAS) und RADIUS-Relay, das Anfragen von den AirEngine Access Points an die Cloud-RADIUS-Infrastruktur von Purple weiterleitet.
Architektur-Übersicht

Purple unterstützt drei primäre Authentifizierungsmodelle auf Huawei-Hardware:
- Gäste-WiFi (Captive Portal): Nicht authentifizierter Traffic wird vom Huawei-Controller abgefangen und auf die Splashpage von Purple umgeleitet. Der Zugriff vor der Authentifizierung wird durch eine Walled Garden ACL eingeschränkt. Nach erfolgreicher Anmeldung sendet Purple ein RADIUS Access-Accept, das dem Client vollen Netzwerkzugriff gewährt.
- Mitarbeiter-WiFi (802.1X): Mitarbeiter authentifizieren sich mit ihren Unternehmensanmeldedaten über EAP-PEAP oder EAP-TLS. Purple validiert diese Anmeldedaten gegenüber Identitätsanbietern wie Microsoft Entra ID, Okta oder Google Workspace.
- Mandantenfähiges WiFi (PPSK): Mandanten verbinden sich über eine einzige gemeinsam genutzte SSID mit eindeutigen Passphrasen. Purple validiert die Passphrase und gibt spezifische RADIUS-Attribute zurück, um den Mandanten dynamisch in sein isoliertes VLAN zu leiten.
Walled Garden und Pre-Authentication-ACLs
Ein Captive Portal erfordert einen Walled Garden – eine Access Control List (ACL), die Traffic zu wichtigen Diensten zulässt, bevor sich der Benutzer authentifiziert. Wenn der Walled Garden unvollständig ist, kann die Splashpage nicht geladen werden, was zu einer schlechten Besucherfahrung führt.
Für Huawei iMaster NCE-Campus muss die Pre-Authentication-ACL Folgendes zulassen:
- DNS-Auflösung (UDP 53)
- Die Captive Portal-Domänen von Purple (
*.purpleportal.net,*.purple.ai) - Content Delivery Networks (CDNs), die Splashpage-Elemente hosten
- Domänen von Identitätsanbietern, wenn Social Login (Apple, Google, Facebook) aktiviert ist
Sämtlicher andere Traffic muss blockiert werden, bis Purple das RADIUS Access-Accept zurückgibt.
Dynamisches VLAN-Steering und RADIUS-Attribute
Zur Isolierung des Netzwerktraffics verwendet Purple eine dynamische VLAN-Zuweisung. Anstatt mehrere SSIDs auszustrahlen, strahlen Sie eine einzige SSID aus und weisen das VLAN dynamisch basierend auf der Identität des Benutzers zu.
Wenn Purple einen Benutzer authentifiziert (über 802.1X oder PPSK), gibt es ein Access-Accept-Paket zurück, das drei obligatorische IETF-Standard-RADIUS-Attribute enthält:
Tunnel-Type=VLAN(oder 13)Tunnel-Medium-Type=802(oder 6)Tunnel-Private-Group-ID=[VLAN-ID]
Der Huawei-Controller empfängt diese Attribute und weist den AirEngine Access Point an, den Traffic des Clients mit der angegebenen VLAN-ID zu taggen.

Implementierungsleitfaden
Dieser Abschnitt beschreibt die genauen Schritte zur Konfiguration von iMaster NCE-Campus für die Purple-Integration.
Schritt 1: Konfigurieren des RADIUS-Relay-Servers
Definieren Sie zunächst Purple als externen Authentifizierungsserver.
- Navigieren Sie in iMaster NCE-Campus zu Design > Network Design > Template Management.
- Wählen Sie RADIUS Server und klicken Sie auf Create.
- Stellen Sie den Authentication service auf Portal authentication ein.
- Geben Sie die primären und sekundären RADIUS-IP-Adressen von Purple ein (verfügbar in Ihrem Purple-Dashboard).
- Stellen Sie den Authentifizierungsport auf 1812 und den Accountingport auf 1813 ein.
- Geben Sie das von Purple bereitgestellte gemeinsame RADIUS-Geheimnis (Shared Secret) ein.
- Stellen Sie den NAS identifier auf Device MAC ein.
Schritt 2: Erstellen der Walled Garden ACL
Erstellen Sie die ACL, um Traffic vor der Authentifizierung zuzulassen.
- Navigieren Sie zu Design > Network Design > Template Management > ACL.
- Erstellen eine neue ACL namens
Purple_Walled_Garden. - Stellen Sie den ACL Type auf User ein.
- Fügen Sie Zulassungsregeln (permit) für DNS und die erforderlichen Domänen von Purple hinzu (z. B.
*.purpleportal.net). - Speichern Sie die ACL-Vorlage.
Schritt 3: Konfigurieren der Captive Portal-URL-Vorlage
Huawei erfordert eine URL-Vorlage, um Standard-Umleitungsparameter dem von Purple benötigten Format zuzuordnen.
- Navigieren Sie zu Design > Network Design > Template Management > URL Template.
- Erstellen Sie eine neue Vorlage namens
Purple_URL_Template. - Setzen Sie den Template Type auf Cloud platform-based relay authentication.
- Konfigurieren Sie das Parameter-Mapping genau wie folgt:
redirect-urlwird zugeordnet zuredirect-urlloginurlwird zugeordnet zulogin-urldevice-macwird zugeordnet zuap-macuser-ipwird zugeordnet zuuaddressuser-macwird zugeordnet zuumacssidwird zugeordnet zussid
Schritt 4: Bereitstellung der Guest SSID
Binden Sie den RADIUS-Server, die ACL und die URL-Vorlage an die SSID.
- Navigieren Sie zu Provision > Device Configuration > Site Configuration.
- Wählen Sie AP und erstellen Sie eine neue SSID.
- Setzen Sie den Network Type auf Open.
- Wählen Sie Open+Portal authentication.
- Setzen Sie den Authentifizierungstyp auf Relay authentication by cloud platform.
- Setzen Sie den Interconnection-Modus auf RADIUS relay.
- Wählen Sie das zuvor erstellte
Purple_URL_Templateaus. - Fügen Sie in das Feld für die Drittanbieter-Authentifizierungs-URL Ihre eindeutige Purple Splash-Page-URL ein.
- Wählen Sie die Purple RADIUS-Servervorlage aus.
- Wählen Sie die ACL
Purple_Walled_Gardenfür die Standard-Zulassungsregel aus. - Speichern und stellen Sie die Konfiguration auf den AirEngine Access Points bereit.
Best Practices
Um eine sichere und zuverlässige Bereitstellung zu gewährleisten, befolgen Sie diese herstellerneutralen Best Practices:
- 802.1X für Mitarbeiter implementieren: Verwenden Sie niemals gemeinsam genutzte PSKs für Mitarbeiternetzwerke. Stellen Sie 802.1X mit EAP-TLS unter Verwendung des SecurePass-Add-ons von Purple bereit, um Client-Zertifikate auszustellen. Dies eliminiert passwortbasierte Phishing-Vektoren und entspricht den Anforderungen von ISO 27001.
- SSIDs konsolidieren: Das Ausstrahlen von zu vielen SSIDs verringert die Airtime-Effizienz aufgrund des Overheads für Management-Frames. Nutzen Sie PPSK und dynamische VLAN-Steuerung, um mandantenfähige Netzwerke in einer einzigen SSID zu konsolidieren.
- Trunk-Konfigurationen überprüfen: Die dynamische VLAN-Zuweisung schlägt geräuschlos fehl, wenn das zugewiesene VLAN auf dem Switch-Trunk-Port, der den Access Point verbindet, nicht zugelassen ist. Überprüfen Sie vor dem Testen der RADIUS-Steuerung immer die Switchport-Konfigurationen.
- RADIUS-Latenz überwachen: Authentifizierungs-Timeouts resultieren häufig aus WAN-Latenzen. Stellen Sie sicher, dass Ihr iMaster NCE-Campus-Controller über einen Pfad mit geringer Latenz zur regionalen RADIUS-Infrastruktur von Purple verfügt.
Fehlerbehebung & Risikominderung
Bei der Integration von Cloud-RADIUS mit Enterprise-Controllern lassen sich Probleme in der Regel auf drei Bereiche eingrenzen: den Walled Garden, das gemeinsame RADIUS-Geheimnis (Shared Secret) oder das VLAN-Trunking.
Splash-Page lädt nicht
Symptom: Ein Gerät verbindet sich mit dem Guest WiFi, aber der Browser zeigt einen Timeout-Fehler anstelle der Purple Splash-Page an.
Fehlerursache: Die Walled Garden ACL ist unvollständig und blockiert den Zugriff auf die Portal-Domains von Purple oder erforderliche CDNs.
Behebung: Verbinden Sie ein Testgerät mit der SSID. Versuchen Sie, purpleportal.net anzupingen. Wenn der Ping fehlschlägt, überprüfen Sie die iMaster NCE-Campus ACL-Konfiguration und stellen Sie sicher, dass sie auf den Pre-Authentication-Status der SSID angewendet wird.
Lautlose Authentifizierungsfehler
Symptom: Ein Benutzer gibt gültige Anmeldedaten ein, aber die Verbindung bricht ohne Fehlermeldung ab. Fehlerursache: Keine Übereinstimmung beim gemeinsamen RADIUS-Geheimnis (Shared Secret) zwischen iMaster NCE-Campus und Purple. Behebung: Kopieren Sie das gemeinsame Geheimnis direkt aus dem Purple-Dashboard und fügen Sie es in die Huawei RADIUS-Servervorlage ein. Ein einzelnes nachfolgendes Leerzeichen zerstört den in RADIUS-Paketen verwendeten MD5-Hash.
DHCP-Timeout nach der Authentifizierung
Symptom: Ein Mitarbeiter authentifiziert sich erfolgreich über 802.1X, aber das Gerät erhält eine 169.254.x.x APIPA-Adresse anstelle einer gültigen IP-Adresse.
Fehlerursache: Purple hat erfolgreich ein dynamisches VLAN über RADIUS zugewiesen, aber dieses VLAN wird nicht an den AirEngine Access Point weitergeleitet (Trunking).
Behebung: Melden Sie sich am Access-Switch an und überprüfen Sie, ob der Befehl port trunk allow-pass vlan die Ziel-VLAN-ID auf der mit dem AP verbundenen Schnittstelle enthält.
ROI & geschäftliche Auswirkungen
Die Bereitstellung von Huawei AirEngine mit Purple verwandelt eine Standard-Netzwerkinfrastruktur in ein messbares Geschäftsgut.
Für Betreiber im Einzelhandel erfasst diese Integration First-Party-Daten von Käufern und ermöglicht so zielgerichtete Marketingkampagnen, die die Besucherfrequenz erhöhen und den durchschnittlichen Transaktionswert steigern. Das WiFi Analytics -Dashboard von Purple bietet Heatmaps und Verweildauer-Metriken, sodass Standortmanager die Ladenlayouts basierend auf dem tatsächlichen Besucherverhalten optimieren können.
In der Hotellerie eliminiert die automatisierte Authentifizierung über OpenRoaming oder Passpoint die Hürden manueller Logins und steigert so die Zufriedenheitswerte der Gäste. Für Gebäude mit mehreren Mietern reduziert die dynamische VLAN-Steuerung über PPSK den IT-Overhead, da nicht mehr für jeden neuen Mieter separate SSIDs manuell bereitgestellt und verwaltet werden müssen.
Durch die Vereinheitlichung von Gäste-Engagement, Mitarbeitersicherheit und Mieterisolierung auf einer einzigen Hardware-Plattform maximieren Unternehmen die Rendite ihrer Huawei CloudCampus-Investition.
Schlüsseldefinitionen
iMaster NCE-Campus
Huaweis cloudbasierte oder lokale Plattform zur Netzwerkautomatisierung und -verwaltung.
IT-Teams nutzen dies als zentralen Controller, um SSIDs zu konfigurieren, Richtlinien an AirEngine APs zu verteilen und das RADIUS-Relay zu Purple einzurichten.
PPSK (Private Pre-Shared Key)
Ein Sicherheitsfeature, das die Verwendung mehrerer eindeutiger Passwörter auf einer einzigen SSID ermöglicht, wobei jedes Passwort den Benutzer an eine bestimmte Netzwerkrichtlinie oder ein bestimmtes VLAN bindet.
Unerlässlich für mandantenfähige Umgebungen (wie Coworking-Spaces oder Fachmarktzentren), in denen Mandanten isolierte Netzwerke benötigen, ohne Dutzende von SSIDs auszustrahlen.
Dynamic VLAN Steering
Der Prozess der Zuweisung eines Geräts zu einem bestimmten virtuellen lokalen Netzwerk (VLAN) basierend auf seiner authentifizierten Identität und nicht auf der SSID, mit der es sich verbunden hat.
Wird von Purple verwendet, um sicherzustellen, dass ein Manager, ein Kassierer und ein Gast, die sich mit demselben physischen Access Point verbinden, in völlig separaten, sicheren Netzwerksegmenten platziert werden.
Walled Garden
Eine Access Control List (ACL), die auf nicht authentifizierte Benutzer angewendet wird und den Zugriff nur auf bestimmte IP-Adressen oder Domänen erlaubt, die für den Abschluss des Anmeldevorgangs erforderlich sind.
Wenn der Walled Garden falsch konfiguriert ist, sehen Gäste anstelle der Purple Splashpage einen leeren Bildschirm oder einen Timeout-Fehler.
RADIUS Relay
Eine Konfiguration, bei der der lokale Netzwerk-Controller Authentifizierungsanfragen von Access Points an einen externen RADIUS-Server weiterleitet.
Huawei iMaster NCE-Campus fungiert als Relay und leitet Anmeldedaten sicher vom Standort an die Cloud-Infrastruktur von Purple zur Validierung weiter.
802.1X
Ein IEEE-Standard für portbasierte Netzwerkzugriffskontrolle, der einen Authentifizierungsmechanismus für Geräte bereitstellt, die eine Verbindung zu einem LAN oder WLAN herstellen möchten.
Der Unternehmensstandard für Mitarbeiter-WiFi. Er ersetzt gemeinsam genutzte Passwörter durch individuelle Benutzeranmeldedaten oder digitale Zertifikate.
EAP-TLS
Extensible Authentication Protocol - Transport Layer Security. Eine 802.1X-Authentifizierungsmethode, die auf Client- und Serverzertifikaten anstelle von Passwörtern basiert.
Die sicherste verfügbare Authentifizierungsmethode. SecurePass von Purple stellt diese Zertifikate für Mitarbeitergeräte aus, um Phishing-Risiken zu eliminieren.
Captive Portal
Eine Webseite, die ein Benutzer eines öffentlich zugänglichen Netzwerks anzeigen und mit der er interagieren muss, bevor ihm der Zugriff gewährt wird.
Der primäre Mechanismus, den Purple verwendet, um First-Party-Daten und Einwilligungen von Besuchern vor Ort zu erfassen.
Ausgearbeitete Beispiele
Ein Hotel mit 200 Zimmern muss sicheres, isoliertes WiFi für Gäste, Mitarbeiter und ein im Foyer betriebenes Café eines Drittanbieters bereitstellen und dabei nur zwei SSIDs verwenden, um Airtime zu sparen.
Stellen Sie eine SSID namens 'Hotel_Guest' bereit, die mit einer Open+Portal-Authentifizierungsrichtlinie konfiguriert ist, die auf das Captive Portal von Purple verweist. Stellen Sie eine zweite SSID namens 'Hotel_Secure' bereit, die mit WPA3-Enterprise und 802.1X-Authentifizierung konfiguriert ist. Mitarbeiter authentifizieren sich über EAP-TLS, und Purple gibt ein RADIUS-Attribut zurück, das sie dem VLAN 20 zuweist. Das Café nutzt PPSK auf derselben 'Hotel_Secure'-SSID; die Mitarbeiter geben eine eindeutige Passphrase ein, und Purple gibt ein RADIUS-Attribut zurück, das sie dem VLAN 30 zuweist.
Eine große Einzelhandelskette migriert zu Huawei AirEngine und muss sicherstellen, dass ihre bestehende Purple Splashpage in allen Filialen korrekt geladen wird, ohne Sicherheitswarnungen auf modernen Smartphones auszulösen.
Konfigurieren Sie die iMaster NCE-Campus-URL-Vorlage so, dass die erforderlichen Parameter (ap-mac, uaddress, umac, ssid, redirect-url) präzise zugeordnet werden. Erstellen Sie eine umfassende Walled Garden ACL, die DNS- (UDP 53) und HTTPS-Traffic (TCP 443) zu den Domänen von Purple und allen erforderlichen Social-Login-APIs zulässt. Stellen Sie sicher, dass der Controller HTTP-Traffic abfängt und auf die HTTPS-Splashpage umleitet.
Übungsfragen
Q1. Sie haben die Gäste-SSID und die Walled Garden ACL auf dem iMaster NCE-Campus konfiguriert. Wenn Sie die Verbindung testen, erkennt Ihr Telefon das Captive Portal, aber der Bildschirm bleibt leer. Was ist die wahrscheinlichste Ursache?
Hinweis: Überlegen Sie, was das Gerät benötigt, um eine moderne, auf einer Cloud-Plattform gehostete Webseite zu laden.
Musterlösung anzeigen
Der Walled Garden ACL fehlen wahrscheinlich Zulassungsregeln für erforderliche Domänen. Insbesondere muss DNS (UDP 53) zulässig sein, ebenso wie der HTTPS-Zugriff auf die Portal-Domänen von Purple und alle Content Delivery Networks (CDNs), die die Seitenelemente hosten. Wenn Social Login aktiviert ist, müssen diese spezifischen API-Endpunkte ebenfalls vor der Authentifizierung zugelassen werden.
Q2. Ein Mandant, der Ihr PPSK-Netzwerk nutzt, beschwert sich, dass er das Internet nicht erreichen kann. Sie überprüfen die iMaster NCE-Campus-Protokolle und sehen, dass Purple ein RADIUS Access-Accept mit auf 40 gesetztem Tunnel-Private-Group-ID zurückgegeben hat. Das Client-Gerät hat jedoch eine IP-Adresse von 169.254.x.x. Was ist der Konfigurationsfehler?
Hinweis: Die Authentifizierung war erfolgreich, aber das Netzwerk-Routing am Edge ist fehlgeschlagen.
Musterlösung anzeigen
Der Switchport, der den Huawei AirEngine Access Point mit dem Netzwerk verbindet, ist nicht für das Trunking von VLAN 40 konfiguriert. Während Purple den Benutzer erfolgreich autorisiert hat und der Controller den AP angewiesen hat, den Traffic mit VLAN 40 zu taggen, hat der Upstream-Switch die Pakete verworfen, da das VLAN auf dem Trunk nicht zulässig ist. Sie müssen VLAN 40 zur Trunk-Zulassungsliste (allow-pass) auf dem Access-Switch hinzufügen.
Q3. Sie migrieren von einem Altsystem zu Huawei iMaster NCE-Campus. Sie konfigurieren die RADIUS-Servervorlage genau wie auf dem alten System, aber alle Authentifizierungsanfragen schlagen stillschweigend fehl. Was sollten Sie zuerst überprüfen?
Hinweis: Stille Fehler bei RADIUS weisen in der Regel auf eine kryptografische Nichtübereinstimmung hin.
Musterlösung anzeigen
Überprüfen Sie das gemeinsame RADIUS-Geheimnis (Shared Secret). Wenn das in iMaster NCE-Campus konfigurierte Geheimnis nicht exakt mit dem Geheimnis im Purple-Dashboard übereinstimmt, können die RADIUS-Pakete nicht entschlüsselt werden, was zu stillschweigenden Fehlern oder Access-Reject-Meldungen ohne eindeutige Fehlercodes führt. Stellen Sie sicher, dass beim Kopieren des Geheimnisses keine nachfolgenden Leerzeichen vorhanden sind.
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.