Captive Portal
Diese Seite beschreibt, wie COD Gast-Voucher für das Captive Portal einer OPNsense erzeugt, was Sie dafür einrichten und wo die Grenzen liegen.
Was das Modul leistet, steht auf der Modulseite.
Stand: November 2026, COD 3.8.6
Inhalt der Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Überblick
| Merkmal | Wert |
|---|---|
| Zweck | Gast-Voucher für das Captive Portal der Firewall erzeugen, ausgeben und entwerten |
| Firewall | nur OPNsense |
| Verbindung und Richtung | COD-Server zur Firewall über deren API. Die Firewall ist im Modul Firewall angebunden |
| Voucher | Gültigkeitsdauer, Ablaufzeit, Gruppenkennung. Viele Voucher in einem Schritt |
| Ausgabe | QR-Code für den Gast-Login, QR-Code für den WLAN-Beitritt, PDF einzeln oder gesammelt |
| Rechte | Lesen, Erstellen, Ändern und Löschen getrennt vergebbar |
| Ablage | Voucher-Passwörter verschlüsselt in der Datenbank von COD |
| Freigaben | Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt. |
Voraussetzungen
| Voraussetzung | Wo |
|---|---|
| OPNsense im Modul Firewall angebunden, mit Asset-Typ „Firewall“ und API-Zugang | COD |
| Captive Portal mit einer Zone auf der OPNsense eingerichtet | Firewall |
| Gäste-WLAN mit SSID und PSK | WLAN |
| Voucher-Konfiguration am Firewall-Asset mit Zone, SSID, PSK, Gateway und Redirect | COD |
| Modul Captive Portal am Mandanten freigeschaltet, Rollen für die Ausgabe der Voucher | COD |
Einrichtung
- Binden Sie die OPNsense im Modul Firewall an. Siehe Firewall.
- Richten Sie auf der OPNsense das Captive Portal mit einer Zone ein.
- Legen Sie in COD die Voucher-Konfiguration am Firewall-Asset an. Tragen Sie Zone, SSID, PSK, Gateway und Redirect vollständig ein.
- Legen Sie eine Rolle für die Personen an, die Voucher ausgeben, etwa den Empfang. Vergeben Sie nur die nötigen Rechte, meist Lesen und Erstellen.
- Erzeugen Sie Voucher: Anzahl, Gültigkeitsdauer, Ablaufzeit und Gruppenkennung.
- Geben Sie die Voucher als QR-Code oder PDF aus.
Die Voucher-Konfiguration steht danach am Firewall-Asset im Tab „References“.
Technische Details
| Merkmal | Wert |
|---|---|
| Ablauf | Jeder Voucher läuft auf der Firewall nach seiner Ablaufzeit von selbst ab |
| Sofort entwerten | „Expire“ für einzelne Voucher, „Drop Expired“ für abgelaufene |
| Bereinigung | Ein nächtlicher Lauf bereinigt die Datenbank von COD |
| QR-Codes | einer für den Gast-Login, einer für den WLAN-Beitritt per SSID |
| Delegation | Rechte für Lesen, Erstellen, Ändern und Löschen getrennt. Die ausgebende Person braucht keinen Zugang zur Firewall |
| Suche | Voucher gehören zu den Quellen der globalen Suche. Der Treffer öffnet den Datensatz |
Bekannte Grenzen
| Grenze | Was Sie tun können |
|---|---|
| Nur für OPNsense | Für andere Firewalls nutzen Sie deren eigene Gästeverwaltung |
| Die Voucher-Konfiguration braucht Zone, SSID, PSK, Gateway und Redirect | Tragen Sie alle Angaben vollständig ein, bevor Sie Voucher erzeugen |
| Rechte gelten je Standort, nicht je Firewall | Wer Voucher erstellen darf, darf das für alle Firewalls des Standorts. Teilen Sie Standorte entsprechend |
Weiterführend
- Modulseite Captive Portal
- Firewall anbinden
- Was Ihr Netz für Firewall und Captive Portal braucht
- Fehlerbilder
- Fragen zu den Modulen
- Support: Zuerst hilft Ihr Partner. Technische Rückfragen an extocode stellen Sie über das Helpdesk-Formular.