Integration der WeChat-Authentifizierung in Captive Portals für Guest WiFi
Dieser Leitfaden erklärt, wie Sie die WeChat OAuth 2.0-Authentifizierung in Captive Portals für Enterprise Guest WiFi integrieren. Er behandelt die Registrierungsanforderungen auf beiden Plattformen, die Scope-Auswahl für die Erfassung von First-Party-Daten, die Netzwerkdurchsetzung via RADIUS Change of Authorization sowie die Compliance mit der GDPR und Chinas PIPL. Betreiber von Standorten in den Bereichen Hotellerie, Einzelhandel und Events finden hier konkrete Implementierungsschritte, praxisnahe Fallstudien und Sicherheitsleitfäden für die skalierte Bereitstellung von WeChat-Logins im Guest WiFi.
Diesen Leitfaden anhören
Podcast-Transkript ansehen
- Executive Summary
- Technischer Deep-Dive: WeChat OAuth 2.0-Architektur
- Die Registrierungsanforderung für zwei Plattformen
- Scope-Auswahl: Datenerfassung vs. Hürden
- UnionID für Multi-Property-Bereitstellungen
- Implementierungsleitfaden
- Mechanismen zur Netzwerkdurchsetzung
- Sicherheitskonfiguration
- In-App-Browser-Erkennung
- Best Practices und Compliance
- GDPR-Compliance
- PIPL-Compliance
- Netzwerksegmentierung
- Fallback-Authentifizierung
- Fallstudien aus der Praxis
- Hotellerie: Luxushotelgruppe
- Einzelhandel: Analysen für Einkaufszentren
- Fehlerbehebung und Risikominderung
- ROI und geschäftliche Auswirkungen

Executive Summary
Wenn sich ein chinesischer Besucher mit Ihrem Unternehmensnetzwerk verbindet und auf ein Captive Portal stößt, das nur E-Mail, Facebook oder einen Gutscheincode anbietet, führt dies zu unmittelbaren Barrieren. WeChat hat laut Tencents Daten von 2024 1,38 Milliarden monatlich aktive Nutzer. Die Integration von WeChat-Login-Funktionen für das Gäste-WiFi ist kein bloßer Komfort für das Gastgewerbe – es ist eine technische Voraussetzung, um First-Party-Daten aus dieser Zielgruppe reibungslos zu erfassen.
Dieser Leitfaden beschreibt im Detail die technische Architektur für die Integration der WeChat OAuth 2.0-Authentifizierung in Captive Portals. Er erläutert die für die Unterstützung von Standard-Mobilbrowsern und dem WeChat-In-App-Browser erforderliche Registrierung auf zwei Plattformen, bewertet die Abwägungen zwischen den Scopes snsapi_base und snsapi_userinfo für die Datenerfassung und beschreibt, wie der Netzwerkzugriff mittels RADIUS Change of Authorization (CoA) oder MAC-Authentifizierungs-Bypass erzwungen wird. Darüber hinaus werden die Sicherheitskonfigurationen und Compliance-Vorgaben – GDPR und Chinas PIPL – behandelt, die für die flächendeckende Implementierung in Infrastrukturen von Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme und Fortinet erforderlich sind.
Technischer Deep-Dive: WeChat OAuth 2.0-Architektur
Ein Captive Portal fängt den HTTP-Verkehr von einem nicht authentifizierten Gerät ab und leitet ihn auf eine Anmeldeseite weiter, die auf einem Portalserver gehostet wird. Durch das Hinzufügen der WeChat-Authentifizierung wird ein Drittanbieter-Identitätsanbieter über das OAuth 2.0-Protokoll in diesen Ablauf integriert – derselbe Standard, der auch von Google, Microsoft Entra ID und Okta für die föderierte Identität verwendet wird.

Der Authentifizierungsablauf funktioniert wie folgt. Der Gast verbindet sich mit der SSID. Der Access Point oder Wireless Controller erkennt die nicht authentifizierte Sitzung und leitet den HTTP-Verkehr zur Captive Portal-URL weiter. Der Gast wählt auf der Portalseite die WeChat-Anmeldung. Der Portalserver leitet den Browser zum WeChat-Autorisierungsendpunkt unter open.weixin.qq.com weiter und übergibt dabei die AppID, die Redirect-URI, den Antworttyp code und den angeforderten Scope. WeChat wickelt die Authentifizierung auf eigenen Servern ab. Wenn der Gast den In-App-Browser von WeChat mit dem Scope snsapi_base verwendet, erfolgt die Authentifizierung im Hintergrund (Silent Authentication) – es erscheint keine Zustimmungsaufforderung. Bei Verwendung von snsapi_userinfo zeigt WeChat einen Zustimmungsbildschirm an. WeChat leitet dann mit einem temporären Autorisierungscode zurück zur Redirect-URI des Portals weiter. Der Portalserver tauscht diesen Code gegen ein Access Token aus, indem er api.weixin.qq.com/sns/oauth2/access_token aufruft und dabei die AppID, das AppSecret, den Code und den Grant Type authorization_code übergibt. WeChat gibt ein Access Token, ein Refresh Token, die OpenID des Benutzers und den erteilten Scope zurück. Wenn snsapi_userinfo erteilt wurde, führt der Server einen zweiten API-Aufruf durch, um den Spitznamen, das Profilbild, das Geschlecht und die Stadt des Benutzers abzurufen.
Die Registrierungsanforderung für zwei Plattformen
Die meisten Implementierungen scheitern bereits bei der Registrierung. WeChat betreibt zwei separate Entwicklerplattformen, und Enterprise-Bereitstellungen erfordern in der Regel beide.
| Plattform | URL | Erforderlicher Kontotyp | Unterstützter Scope | Browser-Kontext |
|---|---|---|---|---|
| Official Accounts Platform | mp.weixin.qq.com | Service Account | snsapi_base, snsapi_userinfo | WeChat In-App-Browser |
| Open Platform | open.weixin.qq.com | Website Application | snsapi_login | Standard-Mobilbrowser |
Für Gäste, die auf das Portal über den WeChat In-App-Browser zugreifen, benötigen Sie einen Service Account auf der Official Accounts Platform. Ein Subscription Account funktioniert nicht – ihm fehlen die Berechtigungen zur OAuth-Webseiten-Autorisierung. Für Gäste, die über Chrome unter Android oder Safari unter iOS auf das Portal zugreifen, benötigen Sie eine Website Application auf der Open Platform, die den Scope snsapi_login verwendet und dem Benutzer einen QR-Code zum Scannen anzeigt.
In der Praxis nutzen die meisten Standort-Bereitstellungen beide. Ein Gast in einem Hotel öffnet beispielsweise das Portal in Chrome, sieht einen QR-Code, scannt ihn mit WeChat und authentifiziert sich. Oder er folgt einem Link direkt in WeChat, landet im In-App-Browser und wird geräuschlos mit snsapi_base authentifiziert.
Scope-Auswahl: Datenerfassung vs. Hürden

Der von Ihnen angeforderte Scope bestimmt, welche Daten Sie erfassen und wie hoch die Hürden für den Gast sind. Dies ist eine entscheidende Abwägung mit Compliance-Implikationen.
snsapi_base gibt nur die OpenID zurück – eine eindeutige Kennung für diesen Benutzer innerhalb Ihres Official Accounts. Es ist keine Zustimmung des Benutzers erforderlich. Die Authentifizierung ist für den Gast unsichtbar. Verwenden Sie dies für wiederkehrende Gäste, deren Profile Sie bereits besitzen, oder wenn Sie reibungslosen Zugriff priorisieren. Unter den Grundsätzen der Datenminimierung von GDPR und PIPL ist snsapi_base einfacher zu rechtfertigen.
snsapi_userinfo gibt die OpenID sowie den Spitznamen, das Profilbild, das Geschlecht und die Stadt des Benutzers zurück. Hierfür ist ein expliziter Einwilligungsbildschirm erforderlich. Verwenden Sie dies für die Erstregistrierung von Gästen, bei der Sie ein Profil erstellen müssen, kombiniert mit einer datenschutzkonformen Einwilligungsebene auf Ihrer Portal-Seite.
UnionID für Multi-Property-Bereitstellungen
Die OpenID ist für die Kombination aus einem Benutzer und einem bestimmten Official Account eindeutig. Eine Hotelgruppe mit 20 Standorten, von denen jeder über einen eigenen Official Account verfügt, sieht 20 verschiedene OpenIDs für denselben Gast. Die UnionID löst dies. Sie ist eine einzige Kennung, die einen Benutzer über alle Official Accounts und Apps hinweg darstellt, die mit demselben Open Platform-Konto verknüpft sind. Verknüpfen Sie Ihre Official Accounts mit Ihrem Open Platform-Konto, und die UnionID wird in der OAuth-Antwort zurückgegeben. Dies ist die Grundlage für die standortübergreifende Gästewiedererkennung.
Implementierungsleitfaden
Mechanismen zur Netzwerkdurchsetzung
Der Erhalt eines OAuth-Tokens beweist die Identität. Er öffnet nicht das Netzwerk. Sie müssen dem Controller signalisieren, den Datenverkehr zuzulassen.
RADIUS Change of Authorization (CoA), definiert in RFC 3576, ist der empfohlene Ansatz für Unternehmen. Nach erfolgreichem OAuth sendet der Portal-Server eine CoA-Anfrage an den Netzwerk-Controller. Der Controller verschiebt das Gerät vom Pre-Authentication-VLAN in das Gast-VLAN. Dies funktioniert mit Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme und Fortinet.
MAC Authentication Bypass (MAB) registriert die MAC-Adresse des Geräts als autorisierten Client in der RADIUS-Datenbank. Der Controller erlaubt den Zugriff basierend auf dieser MAC-Adresse. MAB ist einfacher zu implementieren, aber unzuverlässig: Moderne iOS- und Android-Geräte randomisieren standardmäßig MAC-Adressen, was die Sitzungszuordnung bei der erneuten Verbindung unterbricht.
Die Guest WiFi -Plattform von Purple automatisiert diese Übersetzung. Nach Abschluss des WeChat-OAuth-Vorgangs sendet das Cloud-Overlay von Purple das entsprechende CoA- oder MAB-Signal an die zugrunde liegende Hardware, wodurch eine manuelle VLAN-Konfiguration überflüssig wird.
Sicherheitskonfiguration
Drei Konfigurationen sind unverzichtbar.
- Schützen Sie das AppSecret. Das
AppSecretdarf niemals im clientseitigen JavaScript erscheinen. Es muss auf Ihrem Server verbleiben. Wenn es offengelegt wird, können Angreifer die Identität Ihrer Anwendung annehmen und in Ihrem Namen WeChat-APIs aufrufen. - Implementieren Sie CSRF-Schutz. Generieren Sie einen kryptografisch zufälligen
state-Wert, speichern Sie ihn in der Sitzung des Benutzers und validieren Sie ihn, wenn WeChat zurückleitet. Dies verhindert Cross-Site-Request-Forgery-Angriffe, wie in RFC 6749 definiert. - Registrieren Sie alle Redirect-URI-Varianten. WeChat validiert die Redirect-URI mit Ihrer registrierten Domain. Registrieren Sie jede Subdomain- und Pfad-Variante, die Sie verwenden, einschließlich Staging-Umgebungen, um den Fehler 40029 (ungültiger Code) zu vermeiden.
In-App-Browser-Erkennung
Der In-App-Browser von WeChat setzt einen User-Agent-String, der MicroMessenger enthält. Ihr Portal muss diesen String erkennen und entsprechend weiterleiten: Official Account-Flow für den In-App-Browser, Open Platform QR-Code-Flow für Standard-Browser. Wenn dies nicht erkannt wird, führt dies zu fehlerhaften Darstellungen oder Authentifizierungsfehlern.

Best Practices und Compliance
GDPR-Compliance
Wenn Sie europäische Besucher bedienen oder in Europa tätig sind, gilt die GDPR für die Daten, die Sie über WeChat OAuth erheben. Sie müssen eine Rechtsgrundlage für die Verarbeitung festlegen – in der Regel eine Einwilligung oder berechtigte Interessen. Sie müssen vor der Authentifizierung eine klare Datenschutzerklärung auf dem Captive Portal bereitstellen. Sie müssen Auskunfts- und Löschanfragen nachkommen. Ein detailliertes Compliance-Framework finden Sie unter The Compliance Playbook: GDPR and Guest WiFi Data Privacy .
PIPL-Compliance
Das chinesische Gesetz zum Schutz persönlicher Daten (PIPL) gilt, wenn Sie personenbezogene Daten chinesischer Staatsbürger verarbeiten. Ähnlich wie die GDPR erfordert das PIPL eine klare Zweckbindung, Datenminimierung und eine dokumentierte Rechtsgrundlage. snsapi_base ist im Rahmen der Datenminimierung einfacher zu rechtfertigen als snsapi_userinfo. Was auch immer Sie erheben, dokumentieren Sie Ihre Rechtsgrundlage und Aufbewahrungsfrist vor dem Go-Live.
Netzwerksegmentierung
Isolieren Sie den WiFi-Gastdatenverkehr mithilfe von VLAN-Segmentierung von Ihrem Unternehmensnetzwerk. Über WeChat authentifizierte Gäste sollten in einem dedizierten Gast-VLAN landen, das nur Internetzugang bietet – kein Zugriff auf interne Systeme. Dies entspricht den PCI-DSS-Anforderungen zur Isolierung von Karteninhaber-Datenumgebungen und allgemeinen Sicherheitsrichtlinien für Unternehmen. Weitere Informationen zur Segmentierungsarchitektur finden Sie unter Bandwidth Management: A Practical Guide for 2026 .
Fallback-Authentifizierung
Wenn die API von WeChat nicht verfügbar ist, muss Ihr Portal auf eine alternative Anmeldemethode weiterleiten. Lassen Sie Gäste nicht vor einem leeren Bildschirm stehen. Ein Fallback auf E-Mail oder SMS sichert die Kontinuität. Dies ist besonders wichtig für Standorte in den Bereichen Transport und Healthcare , in denen Konnektivität eine Dienstleistungspflicht darstellt.
Fallstudien aus der Praxis
Hotellerie: Luxushotelgruppe
Ein Luxushotel mit 400 Zimmern in London beherbergt einen erheblichen Anteil an Gästen aus dem chinesischen Festland. Ihr bestehendes Captive Portal erforderte eine E-Mail-Adresse und eine SMS-Verifizierung. Chinesische Mobilfunknummern empfangen häufig keine SMS von europäischen Anbietern, und viele Gäste haben keine lokale E-Mail-Adresse auf ihrem Gerät konfiguriert. Das Ergebnis war eine Absprungrate von 60 % am Portal.
Das Hotel registrierte ein Service-Konto auf der Official Accounts Platform und eine Website-Anwendung auf der Open Platform. Das Portal erkennt den User-Agent MicroMessenger und löst snsapi_base für Nutzer des In-App-Browsers aus – die Verbindung wird in weniger als drei Sekunden und ohne Zustimmungsbildschirm hergestellt. Gäste, die über Chrome oder Safari zugreifen, sehen einen QR-Code. Bei Folgeaufenthalten wird dieselbe OpenID erkannt und der Gast wird lautlos erneut authentifiziert. Das CRM des Hotels protokolliert den erneuten Besuch, was eine gezielte Kommunikation vor der Ankunft ermöglicht. Weitere Informationen zur Bereitstellung von WiFi im Gastgewerbe finden Sie unter Hospitality .
Einzelhandel: Analysen für Einkaufszentren
Ein großes Einkaufszentrum möchte demografische Daten von chinesischen Käufern erfassen, um den Mietermix und Marketingentscheidungen zu unterstützen. Benötigt werden Herkunftsstadt, Geschlecht und Besuchsbeurteilung. snsapi_base reicht hierfür nicht aus – benötigt wird snsapi_userinfo. Das Portal fordert den vollständigen userinfo-Bereich an. Der Gast sieht einen WeChat-Zustimmungsbildschirm und tippt auf "Zulassen". Die Analyseplattform des Einkaufszentrums, die in Purple's WiFi Analytics integriert ist, erhält einen Stream verifizierter demografischer Daten. An Samstagnachmittagen stammen 40 % der WiFi-Nutzer aus einer bestimmten Region. Diese Daten beeinflussen direkt, welche Marken für Pop-up-Events angesprochen werden. Weitere Informationen zu WiFi-Bereitstellungen im Einzelhandel finden Sie unter Retail .
Fehlerbehebung und Risikominderung
Die fünf häufigsten Fehlerszenarien bei WeChat-OAuth-Captive Portal-Bereitstellungen sind wie folgt:
Abweichung des Redirect-URI (Fehler 40029). WeChat validiert den Redirect-URI gegen die registrierte Domain. Jede Abweichung bei Subdomain, Pfad oder Protokoll führt dazu, dass der Code-Austausch fehlschlägt. Registrieren Sie jede Variante, einschließlich Staging-Umgebungen.
Offenlegung des AppSecret. Das Einbetten des AppSecret in clientseitigen Code ist der schwerwiegendste Sicherheitsfehler. Verlagern Sie die gesamte Logik für den Token-Austausch auf den Server.
Fehlender CSRF-Schutz. Wenn die Validierung des state-Parameters weggelassen wird, bleibt das Portal anfällig für Cross-Site Request Forgery (CSRF). Generieren Sie pro Sitzung einen kryptografisch zufälligen Wert und validieren Sie diesen beim Callback.
Fehlgeschlagene In-App-Browser-Erkennung. Wird MicroMessenger im User-Agent nicht erkannt, wird Nutzern von In-App-Browsern der falsche OAuth-Flow angezeigt, was zu Fehlern führt.
MAC-Adressen-Randomisierung unterbricht MAB-Sitzungen. Moderne mobile Betriebssysteme randomisieren MAC-Adressen. Gäste, die eine MAB-basierte Durchsetzung nutzen, verlieren ihre Sitzung bei der erneuten Verbindung. Aktualisieren Sie auf RADIUS CoA für ein zuverlässiges Sitzungsmanagement. Für Anleitungen zur sicheren WiFi-Konfiguration siehe What Is Secure WiFi: Essential Guide for Business 2026 .
ROI und geschäftliche Auswirkungen
Die Bereitstellung der WeChat-Login-Gast-WiFi-Funktionalität hat drei messbare Auswirkungen.
Höhere Authentifizierungsraten. Durch den Wegfall der Fehlerquelle bei der SMS-Verifizierung und der Erforderlichkeit der E-Mail-Eingabe steigt der Prozentsatz der chinesischen Besucher, die sich erfolgreich verbinden. Eine Abbruchquote von 60 % ist eine realistische Baseline für Portale ohne WeChat-Unterstützung.
Qualität von First-Party-Daten. Über WeChat authentifizierte Profile enthalten eine verifizierte OpenID und mit snsapi_userinfo demografische Attribute, die direkt von der Social-Media-Plattform stammen. Diese Daten fließen in Analyseplattformen ein, um zielgerichtetes Marketing ohne Abhängigkeit von Third-Party-Cookies zu ermöglichen.
Reduzierter Support-Aufwand. Ein reibungsloser Login reduziert Support-Anrufe bei Rezeption und IT von internationalen Gästen, die Verbindungsprobleme beheben.
Purple ist in über 80.000 Standorten im Einsatz und verarbeitete im Jahr 2024 440 Millionen Logins (interne Daten von Purple). Die Plattform ist ISO 27001-zertifiziert, GDPR- und CCPA-konform und weist eine Verfügbarkeit von 99,999 % auf. Für Standorte in den Bereichen Retail und Hospitality verwandelt die WeChat-Authentifizierung das Netzwerk von einer Kostenstelle in einen zuverlässigen Kanal zur Erfassung von First-Party-Daten.
Schlüsseldefinitionen
Captive Portal
Eine Webseite, die den HTTP-Verkehr von einem nicht authentifizierten Gerät abfängt und erfordert, dass der Benutzer mit ihr interagiert, bevor der Netzwerkzugriff gewährt wird.
Die primäre Benutzeroberfläche, auf der dem Gast die WeChat-Anmeldeoption angezeigt wird. Der Portalserver hostet diese Seite und steuert den OAuth-Flow.
OAuth 2.0
Ein Autorisierungsprotokoll nach Industriestandard (RFC 6749), das es einer Drittanbieteranwendung ermöglicht, im Namen eines Benutzers eingeschränkten Zugriff auf einen HTTP-Dienst zu erhalten.
Das zugrunde liegende Protokoll, das WeChat verwendet, um Authentifizierungstoken an den Portalserver zu übertragen, ohne die Benutzeranmeldedaten offenzulegen. Dasselbe Protokoll wird auch von Microsoft Entra ID, Okta und Google Workspace verwendet.
OpenID
Eine eindeutige alphanumerische Kennung, die einem bestimmten WeChat-Benutzer für ein bestimmtes Official Account zugewiesen wird.
Wird als Primärschlüssel verwendet, um wiederkehrende Gäste in der WiFi-Analysedatenbank zu identifizieren. Ändert sich je nach Official Account – verwenden Sie die UnionID für eine standortübergreifende Erkennung.
UnionID
Eine einzige WeChat-Kennung, die einen Benutzer über alle Official Accounts und Apps hinweg repräsentiert, die mit demselben Open-Platform-Konto verknüpft sind.
Unerlässlich für Hotelgruppen, Einzelhandelsketten und Stadionbetreiber mit mehreren Standorten, die denselben Gast über ihr gesamtes Portfolio hinweg wiedererkennen müssen.
RADIUS CoA (Change of Authorization)
Eine Erweiterung des RADIUS-Protokolls (RFC 3576), die es einem RADIUS-Server ermöglicht, die Autorisierungsattribute einer aktiven Sitzung dynamisch zu ändern.
Die sichere Methode, um ein Gastgerät nach erfolgreicher WeChat-Anmeldung von einem isolierten Pre-Authentifizierungs-VLAN in das aktive Internet-VLAN zu verschieben. Unterstützt von Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme und Fortinet.
snsapi_base
Ein WeChat-OAuth-Scope, der nur die OpenID des Benutzers zurückgibt und keine Zustimmungserklärung des Benutzers erfordert.
Der empfohlene Scope für die erneute Authentifizierung wiederkehrender Gäste. Im Rahmen der Grundsätze der Datenminimierung der GDPR und PIPL einfacher zu begründen.
snsapi_userinfo
Ein WeChat-OAuth-Scope, der die OpenID, den Spitznamen, das Profilbild, das Geschlecht und die Stadt des Benutzers zurückgibt und einen expliziten Einwilligungsbildschirm erfordert.
Wird für die Erstregistrierung von Gästen verwendet, wenn demografische Daten für Analysen benötigt werden. Erfordert eine dokumentierte Rechtsgrundlage gemäß GDPR und PIPL.
PIPL (Personal Information Protection Law)
Chinas umfassende Datenschutzgesetzgebung, die im November 2021 in Kraft getreten ist und die Verarbeitung personenbezogener Daten von natürlichen Personen in China regelt.
Gilt, wenn Standorte Daten von chinesischen Staatsbürgern über WeChat OAuth verarbeiten. Erfordert eine klare Einwilligung, Zweckbindung, Datenminimierung und einen Löschmechanismus.
AppSecret
Ein vertraulicher kryptografischer Schlüssel, der von WeChat während der Anwendungsregistrierung ausgegeben wird und zur Authentifizierung von API-Aufrufen vom Portalserver verwendet wird.
Muss ausschließlich serverseitig gespeichert werden. Eine Offenlegung im clientseitigen JavaScript ermöglicht es Angreifern, sich als die Anwendung auszugeben und WeChat APIs missbräuchlich aufzurufen.
Ausgearbeitete Beispiele
Ein Luxushotel mit 400 Zimmern in London verzeichnet eine Absprungrate von 60 % auf dem Portal bei Gästen aus Festlandchina. Das aktuelle Portal erfordert eine E-Mail- und SMS-Verifizierung. Der IT-Leiter muss eine WeChat-Authentifizierung implementieren und gleichzeitig die GDPR-Compliance sowie die Netzwerksicherheit gewährleisten.
Schritt 1: Registrieren Sie ein Service-Konto auf der WeChat Official Accounts Platform (mp.weixin.qq.com) und eine Website-Anwendung auf der WeChat Open Platform (open.weixin.qq.com). Schritt 2: Konfigurieren Sie das Portal so, dass es den MicroMessenger-User-Agent-String erkennt. Wenn dieser erkannt wird, lösen Sie den OAuth-Flow „snsapi_base“ für eine stille Authentifizierung aus. Wenn er nicht erkannt wird, zeigen Sie den QR-Code-Flow an. Schritt 3: Fügen Sie der Portalseite einen GDPR-konformen Datenschutzhinweis und ein Zustimmungs-Kontrollkästchen hinzu, bevor der WeChat-Login-Button aktiv wird. Der Hinweis muss Folgendes angeben: erhobene Daten (nur OpenID), Zweck (Zugang zum Guest WiFi und Erkennung von wiederkehrenden Besuchen) und Speicherdauer. Schritt 4: Nach erfolgreichem OAuth-Token-Austausch sendet der Portal-Server eine RADIUS CoA-Anfrage an den Cisco Meraki-Controller, wodurch das Gastgerät vom Pre-Auth-VLAN in das segmentierte Guest-VLAN verschoben wird. Schritt 5: Speichern Sie die OpenID zusammen mit der MAC-Adresse des Geräts in der Gästedatenbank. Bei nachfolgenden Besuchen löst die zurückkehrende OpenID eine stille Re-Authentifizierung aus.
Ein Einkaufszentrum möchte über das Guest WiFi Geschlechts- und Stadtdaten von chinesischen Käufern erfassen, um diese in seine Analyseplattform einzuspeisen. Derzeit wird ein MAC Authentication Bypass für das bestehende Portal verwendet, das auf HPE Aruba-Hardware läuft.
Schritt 1: Registrieren Sie ein Service-Konto auf der WeChat Official Accounts Platform. Schritt 2: Konfigurieren Sie das Portal so, dass es den Scope „snsapi_userinfo“ verwendet, um Geschlecht und Stadt abzurufen. Schritt 3: Fügen Sie einen eindeutigen Zustimmungsbildschirm hinzu, der den Mehrwert erklärt: kostenloses WiFi im Austausch für den Zugriff auf Profildaten. Die Zustimmung muss sowohl nach der GDPR als auch nach der PIPL explizit und detailliert erfolgen. Schritt 4: Nach der Authentifizierung registriert der Portal-Server die MAC-Adresse des Geräts in der RADIUS-Datenbank. Der HPE Aruba-Controller erlaubt den Zugriff via MAB. Schritt 5: Dokumentieren Sie die Rechtsgrundlage (Zustimmung), den Zweck (Standortanalysen und Marketing) und die Speicherdauer (24 Monate) in einem Datenverarbeitungsregister. Bieten Sie einen Mechanismus zur Datenlöschung an.
Übungsfragen
Q1. Sie stellen ein Captive Portal in einem Stadion bereit. Sie möchten, dass sich wiederkehrende Dauerkarteninhaber, die sich zuvor authentifiziert haben, bei nachfolgenden Besuchen automatisch verbinden, ohne einen Anmeldebildschirm zu sehen. Welchen WeChat OAuth-Scope sollten Sie für den Re-Authentifizierungs-Flow implementieren und warum?
Hinweis: Überlegen Sie, welcher Scope eine stille Authentifizierung ermöglicht, ohne dass der Benutzer bei jedem Besuch zur Zustimmung aufgefordert wird.
Musterlösung anzeigen
Verwenden Sie snsapi_base. Dieser Scope gibt nur die OpenID des Benutzers zurück und erfordert keine Zustimmungsaufforderung, was eine stille Re-Authentifizierung ermöglicht. Beim ersten Besuch speichern Sie die OpenID im Profil des Fans. Bei nachfolgenden Besuchen erkennt das Portal die wiederkehrende OpenID über snsapi_base, bestätigt die Übereinstimmung und gibt ein RADIUS CoA aus, um den Zugriff zu gewähren – und das alles, ohne dass der Fan einen Anmeldebildschirm sieht. Dies steht auch im Einklang mit den Prinzipien der GDPR-Datenminimierung, da Sie keine zusätzlichen Daten sammeln, die über das für die Authentifizierungsfunktion erforderliche Maß hinausgehen.
Q2. Während des Tests leitet Ihr Portal erfolgreich zu WeChat weiter, der Benutzer erteilt seine Zustimmung und WeChat leitet zurück zu Ihrem Portal. Die Protokolle des Portal-Servers zeigen jedoch den OAuth-Fehler 40029 (ungültiger Code). Was ist der wahrscheinlichste Konfigurationsfehler und wie beheben Sie ihn?
Hinweis: WeChat validiert das Ziel, an das der Autorisierungscode gesendet wird, streng anhand einer registrierten Liste.
Musterlösung anzeigen
Die wahrscheinlichste Ursache ist eine Diskrepanz bei der Redirect-URI. WeChat validiert die Redirect-URI im OAuth-Request mit der auf der Plattform registrierten autorisierten Domain. Wenn der Portal-Server eine andere Subdomain, einen anderen Pfad oder HTTP anstelle von HTTPS verwendet, schlägt der Code-Austausch mit dem Fehler 40029 fehl. Lösung: Melden Sie sich auf der WeChat-Entwicklerplattform an, navigieren Sie zu den Einstellungen Ihres Service-Kontos oder Ihrer Website-Anwendung und fügen Sie jede von Ihnen verwendete Redirect-URI-Variante hinzu – einschließlich Staging-Subdomains, unterschiedlicher Pfade und HTTPS-Versionen. Stellen Sie sicher, dass der Parameter redirect_uri in Ihrem OAuth-Request exakt mit einer der registrierten URIs übereinstimmt, einschließlich URL-Encoding.
Q3. Ein IT-Manager schlägt vor, das WeChat AppSecret in das Front-End-JavaScript des Captive Portals einzubetten, um den Token-Austausch direkt über den Client-Browser zu beschleunigen. Warum müssen Sie diesen Vorschlag ablehnen und wie sieht die korrekte Architektur aus?
Hinweis: Bedenken Sie die Sicherheitsimplikationen der Offenlegung kryptografischer Schlüssel in öffentlich zugänglichem Code.
Musterlösung anzeigen
Lehnen Sie diesen Vorschlag ab. Das AppSecret ist ein vertraulicher kryptografischer Schlüssel. Die Einbettung in clientseitiges JavaScript macht es für jeden sichtbar, der den Quellcode der Seite anzeigt oder den Netzwerkverkehr abfängt. Ein Angreifer kann das AppSecret extrahieren, sich als die Anwendung ausgeben, WeChat-APIs im Namen des Standorts aufrufen, auf Benutzerdaten zugreifen und möglicherweise das gesamte offizielle Konto gefährden. Die korrekte Architektur: Die clientseitige Portalseite empfängt den Autorisierungscode von WeChat und leitet ihn über einen serverseitigen API-Aufruf an den Portal-Server weiter. Der Portal-Server hält das AppSecret in einer sicheren Umgebungsvariable und führt den Token-Austausch mit der API von WeChat durch. Das AppSecret verlässt niemals den Server.
Q4. Eine Hotelgruppe mit 15 Standorten in ganz Europa möchte ein einheitliches Gästeprofil erstellen, das erkennt, wenn derselbe chinesische Gast in verschiedenen Hotels übernachtet. Jedes Hotel hat sein eigenes offizielles WeChat-Konto. Welche WeChat-Kennung sollten sie verwenden und welche Konfiguration ist erforderlich?
Hinweis: Die OpenID ist kontospezifisch. Es gibt eine andere Kennung, die für die kontoübergreifende Erkennung konzipiert ist.
Musterlösung anzeigen
Verwenden Sie die UnionID. Die OpenID ändert sich pro offiziellem Konto, sodass derselbe Gast 15 verschiedene OpenIDs in 15 Konten hat. Die UnionID ist eine stabile Kennung, die einen Benutzer über alle offiziellen Konten und Apps hinweg darstellt, die mit demselben Open-Platform-Konto verknüpft sind. Erforderliche Konfiguration: Verknüpfen Sie alle 15 offiziellen Konten mit einem einzigen WeChat Open-Platform-Konto. Sobald sie verknüpft sind, wird die UnionID in der OAuth-Antwort zurückgegeben, wenn der Benutzer mindestens eines der verknüpften Konten autorisiert hat. Verwenden Sie die UnionID als Primärschlüssel im Gäste-CRM, um standortübergreifende Profile zu erstellen und wiederkehrende Gäste zu erkennen, unabhängig davon, welchen Standort sie besuchen.
Weiterlesen in dieser Reihe
Einrichtung eines Captive Portals auf Starlink: Ein Leitfaden für abgelegene und maritime Standorte
Dieser Leitfaden beschreibt detailliert, wie Sie die native Starlink-Hardware umgehen und ein Cloud-gesteuertes Captive Portal mithilfe von Enterprise-Routing-Geräten integrieren. Sie erfahren, wie Sie die CGNAT-Einschränkung überwinden, eine VLAN-Segmentierung erzwingen, Bandbreitenbeschränkungen von Satelliten verwalten und die Einhaltung gesetzlicher Vorschriften sicherstellen.
Captive Portal Best Practices: Design für hohe Conversion und Compliance
Dieser technische Leitfaden bietet IT-Managern, Netzwerkarchitekten und Leitern des Standortbetriebs ein vollständiges Konzept für die Bereitstellung von Captive Portalen, die Netzwerksicherheit mit hoher User Conversion verbinden. Er deckt die gesamte Architektur ab, von der VLAN-Segmentierung und RADIUS-Authentifizierung bis hin zur GDPR-konformen Einwilligungserklärung und der Auswahl der Authentifizierungsmethode. Basierend auf den betrieblichen Erfahrungen von Purple in über 80.000 Standorten und 440 Millionen Logins im Jahr 2024 ist jede Empfehlung durch reale Bereitstellungsdaten untermauert.
How to Optimize Captive Portals for Maximum Network Security and User Conversion
Dieser Leitfaden bietet eine vollständige technische Blaupause für die Optimierung von Captive Portals in Unternehmensstandorten und deckt Netzwerksegmentierungsarchitektur, die Auswahl von Authentifizierungsmethoden, GDPR-konformes Einwilligungsdesign und die Conversion-Optimierung ab. Er richtet sich an IT-Manager, Netzwerkarchitekten und CTOs in Hotels, Einzelhandelsketten, Stadien und Organisationen des öffentlichen Sektors, die Netzwerksicherheit mit der Erfassung von First-Party-Daten in Einklang bringen müssen. Purple betreibt eine Captive Portal-Infrastruktur an über 80.000 Standorten mit 440 Millionen Logins im Jahr 2024, und die hier vorgestellten Frameworks spiegeln diese betriebliche Erfahrung wider.