Fernwartung Download starten

OPNsense Captive Portal in Produktion: was nach dem Setup wirklich wichtig wird

OPNsenseCaptive PortalGastnetz
OPNsense Captive Portal in Produktion: was nach dem Setup wirklich wichtig wird

Ein Captive Portal einzurichten ist in OPNsense eine Sache von zwei Stunden. Interessant wird es danach: wenn die Logs nach sechs Monaten die Festplatte füllen, der Datenschutzbeauftragte Nachweise anfordert, der Chef das Logo tauschen will und das Marketing fragt, warum neue Mitarbeiter sich im Gastnetz landen statt im Firmennetz. Dieser Beitrag sammelt, was wir bei DATAZONE in zwei Jahren Betrieb an OPNsense-Captive-Portalen in kleinen und mittleren Unternehmen gelernt haben. Der Setup-Teil ist in unserem älteren Beitrag zum OPNsense Captive Portal für Gäste-WLAN beschrieben.

OPNsense Captive Portal in der Produktion: was wirklich zählt

Die klassische Fehleinschätzung lautet, dass ein Gastnetz nach dem initialen Setup erledigt sei. Faktisch beginnt die Arbeit erst dann. Das Portal läuft, Gäste kommen rein, Logs sammeln sich an. Nach drei Monaten merkt niemand mehr, dass das System existiert, bis etwas schiefgeht: ein Mitarbeiter beschwert sich, dass das WLAN langsam ist, ein Anwalt bittet um Logs zu einem bestimmten Datum, oder ein Audit prüft die Datenschutzkonformität. Dann müssen die unsichtbaren Dinge sitzen.

Was die Setup-Anleitungen meistens weglassen

Fast alle Setup-Guides enden bei der ersten erfolgreichen Anmeldung mit einem Voucher. Was danach kommt, muss man sich selbst zusammensuchen. In der Praxis sind das fünf Themen: Log-Rotation, DSGVO-Dokumentation, Authentifizierungs-Backend, Branding-Pflege und das Zusammenspiel mit 802.1X. Keines davon ist technisch sonderlich schwer, aber jedes einzelne kann im Ernstfall erheblichen Ärger machen, wenn es fehlt.

Logging-Rotation: warum die Session-Logs irgendwann weh tun

OPNsense schreibt pro Captive-Portal-Session mehrere Einträge: Login, periodische Updates, Logout, zusätzlich die Firewall-Logs des Gäste-VLANs. Auf einer typischen Appliance mit 50 bis 150 Gästen pro Woche sammeln sich pro Monat zwischen 200 und 800 MB Log-Daten. Bei kleinen Appliances mit 32 GB internem Flash ist das nach zwölf Monaten ein echtes Problem.

Rotation praktisch einrichten

Unter System -> Settings -> Logging steht die Konfiguration für die lokale Rotation. Wichtig sind drei Werte: Max File Size, Max Rotation Count und der Zielpfad. Für Captive-Portal-Betrieb hat sich bewährt, die Rotation nicht nur auf lokale Platte zu machen, sondern per Syslog an einen zentralen Logserver zu kippen. Ein kleiner TrueNAS mit einem dedizierten Dataset als Syslog-Target reicht völlig; dort läuft dann auch die Langzeit-Aufbewahrung und die Zugriffskontrolle.

Konkret: Syslog remote target in OPNsense setzen, auf dem TrueNAS ein Dataset syslog/captive-portal mit Snapshots und Quota anlegen, und einen rsyslog-Container oder einen Graylog-Pod daraufsetzen. Damit ist die lokale Firewall-Platte entlastet, und die Logs sind durchsuchbar.

Was wirklich geloggt werden muss (und was nicht)

Zu loggen sind: Login-Zeitpunkt, Logout oder Session-Timeout, die MAC-Adresse, die zugewiesene IP und optional der verwendete Voucher-Identifier. Zu loggen sind nicht: komplette URL-Historien, Payload-Daten oder DNS-Antworten pro Session. Letzteres ist nicht nur datenschutzrechtlich problematisch, sondern erzeugt auch die Datenmenge, die am Ende die Platte vollschreibt. Das Captive-Portal ist Zugangskontrolle, keine Deep-Packet-Inspection.

DSGVO-Nachweis: was im Audit vorliegen muss

Ein Gastnetz verarbeitet personenbezogene Daten im Sinne der DSGVO, selbst wenn nur MAC-Adressen und Login-Zeiten gespeichert werden. Das wird häufig unterschätzt. In einem Audit oder bei einer Anfrage nach Artikel 15 DSGVO braucht es drei Dinge, und zwar griffbereit.

Verzeichnis von Verarbeitungstätigkeiten

Für das Captive Portal gehört ein eigener Eintrag ins VVT. Enthalten sein müssen: Zweck der Verarbeitung (Zugangskontrolle, Missbrauchsprävention), Rechtsgrundlage (meist Artikel 6 Absatz 1 Buchstabe f, berechtigtes Interesse), Kategorien betroffener Personen (Gäste, externe Dienstleister), Datenkategorien (MAC, IP, Zeitstempel), Speicherdauer und technische/organisatorische Maßnahmen.

Speicherdauer definieren und einhalten

Ohne konkreten Grund sind sieben Tage ein guter Richtwert für Session-Logs. Wer eine Störerhaftungsabsicherung oder einen konkreten Vorfall dokumentieren muss, kann länger speichern, braucht dann aber eine schriftliche Begründung. Wichtig ist, dass die technische Rotation zur dokumentierten Aufbewahrungsfrist passt. Wenn im VVT „7 Tage” steht und die Logs faktisch zwei Jahre auf der Platte liegen, ist das ein DSGVO-Mangel.

Nutzungsbedingungen auf der Portal-Seite

Die Landing Page ist der richtige Ort für Transparenzhinweise. Wer sich einloggt, muss sehen, welche Daten erfasst werden, wie lange sie gespeichert werden und wer verantwortlich ist. Ein Link auf die Datenschutzerklärung reicht, der Hinweis selbst sollte aber direkt sichtbar sein. Mehr dazu weiter unten im Abschnitt Branding.

Voucher vs. RADIUS: wann der Wechsel sinnvoll wird

Vouchers sind einfach, lokal und für kleine Umgebungen völlig ausreichend. Ab einer bestimmten Größe wird das händische Erzeugen von Voucher-Batches aber zur echten Belastung. Unsere Schwelle in der Praxis liegt bei etwa 20 bis 30 Gästen pro Woche oder wenn mehrere Standorte eine gemeinsame Nutzerbasis brauchen.

Was RADIUS zusätzlich kann

Ein FreeRADIUS auf OPNsense oder auf einem separaten Linux-Host liefert zentralisierte Authentifizierung, Session-Accounting mit Datenvolumen und granulare Rechte pro Nutzer oder Gruppe. Für Mitarbeiter-Zugänge im Gastnetz (BYOD-Geräte, Firmenhandys außerhalb der Domäne) ist RADIUS deutlich bequemer, weil Credentials wiederverwendet werden können und das Deprovisioning zentral läuft.

Die Umstellung ist unkritisch: Das Captive Portal kann beide Methoden gleichzeitig unterstützen. Mitarbeiter authentifizieren sich per RADIUS gegen das AD-angebundene FreeRADIUS, Gäste bekommen weiterhin Voucher am Empfang. Für den Übergang ist das die saubere Lösung.

Wo RADIUS Grenzen hat

RADIUS ersetzt nicht das Captive Portal. Es ist nur das Authentifizierungs-Backend. Die Portal-Seite bleibt, die Nutzerführung bleibt, auch die Firewall-Regeln bleiben. Ein echter Enterprise-Zugang mit 802.1X-Authentifizierung direkt am Access Point ist etwas anderes, dazu gleich mehr.

Branding: Portal-Seite ohne jahrelangen Wildwuchs

Die Standard-Portal-Seite von OPNsense sieht nach OPNsense aus. Für Umgebungen, wo Gäste das Netz nutzen (Besprechungsräume, Empfang, Showroom), ist das selten gewünscht. Die Portal-Seite ist das erste und oft einzige Interface, das Gäste von der IT sehen.

Minimum sinnvoll, Maximum vermeiden

Pragmatisch reichen Logo, kurzer Begrüßungstext, Hinweis auf Nutzungsbedingungen und das Eingabefeld. Alles andere ist Zierde und wird bei jedem OPNsense-Update potenziell zum Wartungsfall, weil Template-Pfade sich ändern können. Wir empfehlen, das Template als eigenes Git-Repo zu pflegen und bei jedem Major-Release von OPNsense einmal gegen die aktuelle Template-Dokumentation zu prüfen.

Mehrsprachigkeit, wenn nötig

Zweisprachig DE/EN reicht in den allermeisten Fällen. Die Umschaltung sollte über einen simplen Link in der Portal-Seite laufen, nicht über Browser-Spracherkennung — letzteres bricht gern, wenn Mobile-Browser andere Headers senden.

Was ins Template nicht gehört

Keine Pflichtfelder für Name, E-Mail oder Telefonnummer von Gästen. Das sammelt Daten, die niemand braucht und die im DSGVO-Audit sofort auffallen. Wer die MAC und den Voucher hat, hat genug für die Zugangskontrolle. Alles weitere ist Marketing-Datensammlung und gehört nicht in eine Zugangsinfrastruktur.

802.1X-Fallback: Captive Portal und Enterprise-WLAN nebeneinander

Mitarbeiter-WLAN gehört in ein 802.1X-authentifiziertes Netz, nicht ins Captive Portal. Trotzdem gibt es Szenarien, wo beides nebeneinander laufen muss: externe Dienstleister mit ihren eigenen Geräten, Besucher mit Laptops, Veranstaltungen mit kurzfristigem Zugang.

Die saubere Architektur

Zwei SSIDs auf den Access Points: eine mit WPA2/WPA3 Enterprise gegen das FreeRADIUS, eine offene SSID mit Captive Portal. Beide landen in getrennten VLANs, beide haben eigene Firewall-Regeln. Das Captive-Portal-VLAN ist strikt auf Internet-Only beschränkt (siehe unseren älteren Beitrag zum Setup des Gästenetzes), das 802.1X-VLAN hat je nach User oder Gruppe differenzierte Regeln.

Wenn 802.1X ausfällt

Das kommt vor: Zertifikat auf dem Access Point abgelaufen, RADIUS-Server down, Supplicant-Problem auf einem Client-Gerät. In diesem Fall sollte das Captive Portal nicht als Fallback für produktive Clients dienen. Besser ist ein dokumentierter manueller Prozess: Gerät kurzzeitig via Voucher ins Gastnetz, dann Problem lösen. Das Captive Portal als „Notfall-Backup” für produktive Clients auszulegen führt dazu, dass es dauerhaft als Backup missbraucht wird — und damit die Netzsegmentierung aushebelt.

Monitoring beider Netze

Für den Betrieb hilft es, beide Netze im gleichen Monitoring zu haben. Zabbix oder Checkmk auf OPNsense über SNMP, dazu die FreeRADIUS-Logs im zentralen Logging. Dann sieht man auch, wenn plötzlich produktive Clients im Captive-Portal-Netz auftauchen, was ein starkes Signal für ein ungelöstes 802.1X-Problem ist.

Betrieb: was wirklich einmal im Quartal passiert

Alles bisher Gesagte ist Grundlagenarbeit. Was im laufenden Betrieb konkret passiert: Voucher-Vorrat prüfen und nachgenerieren, abgelaufene Sessions aufräumen, Log-Rotation kontrollieren, einmal pro Quartal die DSGVO-Dokumentation gegen den Ist-Zustand abgleichen, Portal-Template bei OPNsense-Updates nachziehen. Nichts davon ist dramatisch, aber ohne feste Verantwortlichkeit bleibt es liegen. Wir übernehmen das für unsere Kunden im Rahmen unseres IT-Service, und die Erfahrung ist deutlich: Was nicht verantwortet wird, verrottet.

Weiterführende Themen: Für Umgebungen, wo das Gäste-WLAN auf eine TrueNAS-basierte Dokumentenablage für Nutzungsbedingungen zugreifen soll, bauen wir eine saubere Trennung über Reverse-Proxy mit Allowlisting der Captive-Portal-Allowed-Addresses. Und wer sein Netz grundsätzlich sauber segmentieren will, findet im Beitrag VLAN-Konzepte für KMU den passenden Rahmen.

FAQ zum Produktionsbetrieb von OPNsense Captive Portal

Wie lange sollten Session-Logs aufbewahrt werden?

Als Richtwert sieben Tage, dokumentiert im Verzeichnis der Verarbeitungstätigkeiten. Längere Aufbewahrung braucht eine konkrete Begründung (laufende Ermittlungen, Vorfallsdokumentation). Wichtig ist, dass die technische Rotation zur dokumentierten Frist passt.

Wann lohnt der Umstieg von Vouchern auf RADIUS?

Faustregel: Ab 20 bis 30 regelmäßigen Gästen pro Woche, bei mehreren Standorten mit gemeinsamer Nutzerbasis, oder sobald Mitarbeiter mit eigenen Geräten (BYOD) regelmäßig ins Gastnetz müssen. Beide Methoden lassen sich parallel betreiben, der Umstieg ist nicht alles-oder-nichts.

Darf das Captive Portal E-Mail oder Telefonnummer der Gäste erfassen?

Technisch möglich, datenschutzrechtlich problematisch. Für die reine Zugangskontrolle sind MAC und Voucher ausreichend. Zusätzliche Daten brauchen eine klare Rechtsgrundlage und sind im Audit begründungspflichtig. Wir raten in der Regel ab.

Was passiert mit dem Captive Portal bei einem OPNsense-Update?

Die Grundfunktion bleibt stabil, aber Custom-Templates können bei Major-Updates (Jahresversionen) Anpassung brauchen. Deswegen Template als Git-Repo pflegen und bei jedem Major-Update einmal gegenprüfen. Minor-Updates sind in der Regel unkritisch.

Kann das Captive Portal als Fallback für 802.1X-Ausfälle dienen?

Technisch ja, als Konzept nein. Wenn das produktive 802.1X-WLAN regelmäßig ins Captive Portal „ausweicht”, hebelt das die Segmentierung aus und erzeugt falsche Sicherheitsannahmen. Besser: 802.1X robust aufsetzen, Captive Portal strikt für Gäste.

Wie aufwendig ist der laufende Betrieb realistisch?

Für ein typisches KMU mit einem Standort und 50 bis 150 Gästen pro Woche sind das etwa ein bis zwei Stunden pro Quartal: Voucher-Nachschub, Log-Kontrolle, DSGVO-Dokumentation prüfen. Bei mehreren Standorten entsprechend mehr. Wichtig ist feste Verantwortlichkeit — ohne die wird genau diese Routine zuerst eingespart.

Mehr zu diesen Themen:

IT-Beratung gewünscht?

Kontaktieren Sie uns für eine unverbindliche Beratung zu Proxmox, OPNsense, TrueNAS und mehr.

Jetzt Kontakt aufnehmen