Skip to content

OPNsense Firewalls ​

Das OPNsense-Modul verwaltet Ihre Firewall-Infrastruktur. Es bietet Echtzeit-Monitoring, Update-Management und Konfigurations-Backups fuer alle OPNsense-Installationen.

Uebersicht ​

Host-Tabelle ​

SpalteBeschreibung
KundeZugeordneter Kunde
NameAnzeigename der Firewall (im Detail-Panel editierbar)
StandortStandort des Kunden (ab v3.38.0, vorher Freitext), standardmaessig ausgeblendet
HostnameHostname der Firewall
OPNsense VersionInstallierte OPNsense-Version
EditionCommunity (Versionen YY.1 / YY.7) oder Business (YY.4 / YY.10), aus der Version abgeleitet; auch im Detail-Panel unter Informationen (ab v3.31.3)
Agent VersionVersion des DATAZONE Agents
WAN IPOeffentliche WAN-Adresse
UptimeBetriebszeit seit letztem Neustart
CPU / RAM / DiskAktuelle Auslastung als Fortschrittsbalken
Letzte AntwortZeitpunkt des letzten Agent-Heartbeats
Letzte Config-AenderungZeitpunkt der letzten Konfigurationsaenderung
GatewaysStatus der konfigurierten Gateways (farbig)
WebUIDirektlink zur OPNsense-Weboberflaeche

Status-Erkennung ​

Eine Firewall gilt als offline, wenn innerhalb des doppelten Heartbeat-Intervalls kein Heartbeat empfangen wird. Das Heartbeat-Intervall wird vom Agent gemeldet (heartbeat_interval) und die Offline-Erkennung berechnet sich als heartbeat_interval × 2. Standard: 2x 30s = 60s.

Dynamische Erkennung

Im Gegensatz zu den anderen Modulen (fester 120s-Timeout) passt sich die OPNsense-Offline-Erkennung dynamisch an das tatsaechliche Heartbeat-Intervall des Agents an.

Host hinzufuegen ​

Per Agent (empfohlen) ​

  1. Installieren Sie den Agent auf der OPNsense (siehe Agent-Installation)
  2. Der Agent erkennt automatisch, dass es sich um ein FreeBSD/OPNsense-System handelt
  3. Die Firewall erscheint im OPNsense-Modul

Manuell (API-basiert) ​

  1. Klicken Sie auf Firewall hinzufuegen
  2. Geben Sie folgende Daten ein:
    • Kunde - Zuordnung zu einem Kunden
    • Hostname - Anzeigename
    • Host - IP-Adresse oder FQDN
    • API Key und API Secret - OPNsense API-Zugangsdaten

API-Zugang einrichten

In der OPNsense-Weboberflaeche unter System > Zugang > Benutzer koennen Sie API-Keys erstellen. Der Benutzer benoetigt Leserechte auf die gewuenschten Bereiche.

Detail-Panel ​

Klicken Sie auf eine Firewall in der Tabelle, um das Detail-Panel zu oeffnen.

Das Detail-Panel enthaelt 9 Haupttabs am oberen Rand. Der Tab Uebersicht enthaelt zusaetzlich 7 Subtabs fuer detaillierte Systeminformationen.

Haupttabs ​

TabIconBeschreibung
UebersichtMonitorSysteminformationen mit Subtabs (siehe unten)
ChecksClipboardCheckHealth-Check-Ergebnisse und -Status
JobsListTodoLaufende und abgeschlossene Aufgaben
ShellTerminalRemote-Terminal zur OPNsense-Shell
LogFileTextAusfuehrungsprotokolle aller Aktionen
GruppenTagsGruppenzugehoerigkeit verwalten
UpdatesRefreshCwUpdate-Verlauf und Zeitplaene
AgentCpuAgent-Status, Logs und Verwaltung
LoeschenTrash2Firewall aus DATAZONE Control entfernen

Tab: Uebersicht ​

Die Uebersicht zeigt im oberen Bereich die wichtigsten Metriken (CPU, RAM, Disk, Uptime) als Karten an. Darunter befinden sich editierbare Felder (Name, Kunde, Beschreibung) und die Subtab-Navigation.

Subtab: Hardware ​

  • CPU-Modell, Kerne, Taktfrequenz
  • RAM-Groesse und -Auslastung
  • Festplatten mit Groesse und Belegung
  • BIOS-Informationen

Subtab: Interfaces ​

  • Alle Netzwerk-Interfaces mit Status (UP/DOWN)
  • Interface-Name (WAN, LAN, OPT1, etc.)
  • IP-Adressen (IPv4 und IPv6)
  • Durchsatz und Paketstatistiken
  • VLAN-Konfigurationen

Subtab: VPN ​

Uebersicht aller VPN-Verbindungen, aufgeteilt in drei Bereiche:

OpenVPN:

  • Server- und Client-Instanzen mit Status (up/down)
  • Verbundene Clients pro Server
  • Durchsatz und Verbindungsdauer
  • Beschreibungen aus der OPNsense config.xml

IPsec:

  • Phase-1- und Phase-2-Tunnel
  • Verbindungsstatus und Uptime
  • Remote-Gateway und lokale/remote Subnetze

WireGuard:

  • Peers mit Status und letztem Handshake
  • Erlaubte IPs und Endpoint-Informationen
  • Uebertragene Daten pro Peer

Subtab: Routen (seit v1.3.0) ​

  • Komplette Routing-Tabelle der Firewall
  • Ziel-Netzwerk, Gateway, Interface
  • Metrik und Flags
  • Statische und dynamische Routen

Subtab: Zertifikate (seit v1.3.0) ​

  • ACME-Zertifikate (Let's Encrypt) und selbstsignierte SSL-Zertifikate
  • Ablaufdatum mit farblicher Hervorhebung (rot wenn bald ablaufend)
  • Zertifikats-Details: Common Name, Aussteller, Seriennummer
  • Cache-Intervall: 6 Stunden

Subtab: Dienste (seit v1.3.0) ​

Zwei Bereiche:

OPNsense-Dienste:

  • Alle konfigurierten OPNsense-Dienste mit Status (Running/Stopped), Dienste mit mehreren Instanzen (z. B. OpenVPN) mit Instanz-Nummer
  • Ab 3.37.0: Starten, Stoppen, Neu starten je Dienst mit Rueckfrage (nur Admins oder Recht Dienste verwalten im Modul OPNsense - auch vom Backend erzwungen, Firewall online). Der Agent nutzt dafuer die OPNsense-API /api/core/service/<aktion>/<name>[/<id>] (bzw. configctl service ...), nicht systemctl - vorher schlug das auf OPNsense immer fehl. Nach der Aktion prueft der Agent, ob der Dienst laeuft bzw. gestoppt ist, und meldet sonst einen Fehler
  • Gesperrte Kerndienste (Schloss-Symbol) lassen sich nur neu starten - der Agent lehnt Stoppen ab; configd kann nie gestoppt werden

Nginx Virtual Hosts (falls Nginx-Plugin installiert):

  • Konfigurierte Nginx-Server-Eintraege
  • Server-Name, Port, SSL-Status
  • Upstream-Konfigurationen
  • Cache-Intervall: 1 Stunde

Subtab: Backups ​

Ab v3.42.0 fuehrt Control einen Verlauf der config.xml jeder Firewall (Config-Versionen).

Was gespeichert wird: die komplette /conf/config.xml. Eine neue Version entsteht nur, wenn sich die Datei geaendert hat (Vergleich per SHA-256 mit der neuesten Version). Der Agent meldet bei gleichem Stand nur den Hash, die Datei wird dann gar nicht uebertragen. Passt der gemeldete Hash nicht zur neuesten gespeicherten Version, fordert Control das Backup genau einmal mit Inhalt neu an; meldet auch dieser Versuch nur einen unpassenden Hash, schlaegt der Task fehl (kein weiterer automatischer Versuch, ab v3.48.13).

Wann gesichert wird (Anlass in der Liste):

AnlassWann
NachtsJede Nacht um opn_backup_nightly_time (Standard 02:30, Zeitzone wie bei den Benachrichtigungen) fuer jede Firewall, die online ist
Vor UpdateBevor ein Update-Lauf den Node zum ersten Mal anfasst. Schlaegt das Backup fehl, laeuft das Update trotzdem weiter (Hinweis im Log)
Vor AenderungVor jeder Aenderung aus Control: Regeln, NAT, Aliase, Kategorien, WireGuard
ManuellKnopf Jetzt sichern
Vor / Nach WiederherstellungStand direkt vor einer Wiederherstellung und etwa sechs Minuten danach (nach dem Neustart)

Verschluesselung: Die Datei enthaelt Passwort-Hashes, private Schluessel und PSKs. Control speichert sie nur verschluesselt (Fernet, Schluessel aus SCRIPT_VAULT_KEY in der .env, derselbe wie fuer Script-Geheimnisse). Fehlt der Schluessel, wird gar nichts gespeichert und der Reiter zeigt einen Hinweis. Wird SCRIPT_VAULT_KEY geaendert, lassen sich alte Versionen nicht mehr lesen. Im Task-Ergebnis und im Log steht nie der Inhalt, nur Groesse und Hash.

Aufbewahrung: opn_backup_retention_days (Standard 90 Tage). Die neueste Version je Firewall bleibt immer, ebenso eine Version, aus der in den letzten 7 Tagen wiederhergestellt wurde.

Liste: Zeitpunkt, Anlass, Groesse, OPNsense-Version, von wem. Je Zeile:

  • Aenderungen zeigt, was sich gegenueber der vorherigen Version geaendert hat (Unified Diff, gruen = neu, rot = entfernt). Passwoerter, Schluessel, PSKs, API-Secrets und OpenVPN-Schluessel sind auf beiden Seiten ausgeblendet ([maskiert 1a2b3c4d]). Aendert sich so ein Wert, aendert sich der Kurzcode – du siehst also, dass sich z. B. ein PSK geaendert hat, aber nicht den Wert.
  • Herunterladen liefert die echte, vollstaendige config.xml (mit allen Geheimnissen) – sicher aufbewahren.
  • Wiederherstellen spielt die Version auf die Firewall zurueck (siehe unten).

Rechte:

WasRecht
Liste sehenOPNsense Anzeigen (Subtab Backups)
Jetzt sichernSchreibrecht im Modul (Tasks/Bearbeiten)
Aenderungen + HerunterladenConfig-Backups lesen (opnsense.config_backup)
WiederherstellenConfig wiederherstellen (opnsense.config_restore) plus Schreibrecht im Modul

Die beiden neuen Rechte stecken nicht in "alle Subtabs" und nicht in den Rollen Operator, Support oder Viewer – Admins haben sie, alle anderen nur, wenn sie ausdruecklich vergeben werden. Kundengebundene Benutzer sehen nur Firewalls ihres Kunden. Download, Vergleich und Wiederherstellen stehen im Audit-Log. Auch der Reiter Dateien gibt /conf (config.xml und /conf/backup) ohne Config-Backups lesen nicht heraus – ab v3.48.14 bei keiner Datei-Aktion, also auch nicht per Umbenennen, Hochladen oder Auflisten.

Wiederherstellen – Ablauf:

  1. Knopf Wiederherstellen in der Zeile, Namen der Firewall eintippen.
  2. Control legt zuerst eine Sicherung des aktuellen Stands an (Anlass Vor Wiederherstellung), dann die Wiederherstellung. Der Agent fuehrt beide nacheinander aus, die Sicherung zuerst.
  3. Der Agent prueft die Version (Pruefsumme, gueltiges XML mit <opnsense>), legt die bisherige Datei zusaetzlich als /conf/backup/config-<Zeit>-datazone.xml auf der Firewall ab, schreibt die neue Datei atomar und plant einen Neustart in einer Minute. Das Ergebnis meldet er vor dem Neustart.
  4. Nach dem Neustart sichert Control den neuen Stand (Anlass Nach Wiederherstellung).

Voraussetzungen: Agent 3.42.0 oder neuer, Firewall online. Auf der Firewall und ihrem HA-Partner darf nichts anderes laufen (Update-Lauf, Neustart, Agent-Update, eine andere Wiederherstellung – auch keine, die vor weniger als 10 Minuten fertig wurde, denn dieser Node startet gerade neu). Umgekehrt fasst ein Update-Lauf das Paar in diesen 10 Minuten nicht an. Stammt die Version aus einer anderen Hauptversion (z. B. 25.7 statt 26.1), zeigt der Dialog eine Warnung und verlangt einen eigenen Haken. Die Wiederherstellung wird nur ausgefuehrt, wenn der Agent sie innerhalb von 30 Minuten abholt; meldet er 10 Minuten lang kein Ergebnis, gilt sie als fehlgeschlagen (Stand auf der Firewall pruefen). Ab Agent 3.48.3 spielt der Agent sie nur innerhalb von 5 Minuten nach dem Abholen ein (z. B. wenn er vorher noch einen langen Task abarbeitet) - danach lehnt er sie ab, ohne etwas zu aendern, damit eine als fehlgeschlagen gemeldete Wiederherstellung nie spaeter doch noch einen Neustart ausloest. Waehrend des Austauschs haelt der Agent dieselbe Dateisperre wie OPNsense selbst; beim Sichern liest er die Datei unter dieser Sperre und speichert nur vollstaendiges XML. Sobald das Ergebnis bei Control angekommen ist, startet er sofort neu (der Neustart in einer Minute bleibt als Rueckfall). Der Inhalt der Version wird erst beim Abholen durch den Agent eingesetzt und steht nie in den Task-Parametern.

HA-Paar

Ist die Firewall Teil eines HA-Paars, zeigt der Dialog eine Warnung und verlangt einen zusaetzlichen Haken. Mit aktiver Config-Synchronisation kann der Partner den wiederhergestellten Stand uebernehmen oder ihn beim naechsten Sync mit seinem eigenen Stand ueberschreiben. Stelle die Version am besten auf dem Node her, von dem aus synchronisiert wird, und pruefe danach beide Firewalls.

Das alte Feld Aenderungsbeschreibungen gibt es nicht; was sich geaendert hat, zeigt Aenderungen.

Vergleich (ab v3.47.0) ​

Mit anderer Firewall vergleichen (oben im Subtab Backups) stellt zwei Firewalls gegenüber – oder zwei Versionen derselben Firewall, wenn du links und rechts dieselbe Firewall mit verschiedenen Versionen wählst. Standard ist jeweils die neueste Config-Version. Aus dem HA-Kasten im Reiter Updates öffnet Paar vergleichen denselben Dialog direkt mit beiden Nodes (siehe HA-Synchronisation prüfen).

Anders als Änderungen (Zeilen-Diff) vergleicht Control hier strukturiert je Bereich und ordnet Objekte über Merkmale zu, die auf beiden Firewalls gleich sind – nie über die UUID, die auf jeder Firewall anders ist:

BereichZuordnungHinweise
AliaseNameInhalt ohne Reihenfolge verglichen
Filter-RegelnInterface + Aktion + Beschreibung (ohne Beschreibung: Protokoll/Quelle/Ziel/Port)Legacy- und MVC-Regeln; Sequenz, Ersteller und Zeitstempel zählen nicht
NATArt (Port-Forward, Outbound, 1:1, NPT) + Interface + Beschreibungplus Outbound-Modus
InterfacesSchlüssel (wan, lan, opt1 …)Beschreibung, Gerät, Adressen, Gateway, MTU …
SystemAllgemein / DNS / NTPHostname ausgenommen
Unbound DNSOverrides über Host + Domain bzw. NameLegacy- und MVC-Einstellungen
WireGuard, IPsecName bzw. BeschreibungSchlüssel und PSKs nur maskiert
Benutzer und GruppenNamenur Namen, keine Hashes, Schlüssel oder API-Keys
ZertifikateBeschreibungnur Name und Ablaufdatum, nie Schlüsselmaterial

Je Bereich zeigt Control nur links, nur rechts, unterschiedlich (Tabelle Objekt · Feld · links · rechts) und wie viele Objekte gleich sind. Mit den Chips oben blendest du Bereiche aus. Verweise auf andere Objekte (z. B. Kategorien einer Regel) und Interface-Schlüssel werden als Namen angezeigt, damit sie zwischen Firewalls vergleichbar sind. Passwörter, Schlüssel und PSKs sind maskiert wie bei Änderungen – gleicher Kurzcode heißt gleicher Wert.

Recht: Config-Backups lesen (opnsense.config_backup), kundengebundene Benutzer sehen nur Firewalls ihres Kunden (beide Seiten). Jeder Vergleich steht im Audit-Log (opn_config_compare). API: GET /api/opnsense/compare?a=<id>&b=<id>[&va=<version>][&vb=<version>][&sections=aliases,rules].

Vorlagen (ab 3.46.0) melden ihre Abweichungen weiterhin selbst unter OPNsense › Vorlagen.

Subtab: Dateien (ab v3.30.0) ​

Dateimanager im Browser wie bei Windows und Linux (Agent ab 3.19.0, Firewall online). Ordner durchsuchen und Dateien herunterladen (Recht Dateien), hochladen, umbenennen, löschen und Ordner anlegen (Recht Dateien verwalten). Ab v3.42.0 brauchen Downloads aus /conf (config.xml und /conf/backup, ebenso /cf/conf und ZIPs uebergeordneter Ordner) zusaetzlich das Recht Config-Backups lesen (opnsense.config_backup), weil diese Dateien Passwort-Hashes und Schluessel enthalten. Ab v3.48.14 gilt diese Sperre fuer jede Datei-Aktion, nicht nur fuer Downloads: Ohne das Recht kannst du /conf und /cf/conf weder auflisten noch dort Ordner anlegen, loeschen, hochladen oder hinein- bzw. herausverschieben (Umbenennen prueft Quelle und Ziel). Beim Auflisten eines uebergeordneten Ordners ist conf ausgeblendet, auch ein Symlink, der nach /conf zeigt. Dasselbe gilt fuer /var/log/filter* (Recht Firewall-Log durchsuchen) und /tmp/dz-capture-* (Recht Paketmitschnitt). Pfade mit .. lehnt Control ab. Control prueft das immer; Agents ab 3.48.14 pruefen es zusaetzlich auf der Firewall am echten Pfad (Symlinks aufgeloest).

  • Rolle Support darf nur lesen und herunterladen, Operator und Administratoren auch ändern.
  • Geschützt vor Löschen und Umbenennen: u. a. /conf, /conf/config.xml, /usr/local, /usr/local/etc, /usr/local/opnsense, /var/db, /var/log, /etc/rc.conf und die Agent-Dateien (ab Agent 3.30.0; ältere Agents schützen die allgemeinen Unix-Ordner).
  • Änderungen an Konfigurationsdateien wirken erst nach Neuladen des Dienstes bzw. werden von OPNsense beim nächsten Speichern überschrieben. Die Konfiguration selbst nur über die OPNsense-Oberfläche ändern.

Unbound DNS Statistiken (seit v1.3.0) ​

In der Uebersicht werden Unbound DNS-Statistiken als Karten angezeigt (falls Unbound aktiv):

  • Gesamtanzahl Abfragen
  • Cache-Hit-Rate
  • Top angefragte Domains

Tab: Checks ​

Zeigt alle der Firewall zugewiesenen Health-Checks mit ihrem aktuellen Status:

  • OK (gruen), Warning (gelb), Critical (rot), Unknown (grau)
  • Letztes Pruefungsergebnis und Zeitstempel
  • Direktlink zur Check-Konfiguration

Siehe Health-Checks fuer Details.

Tab: Jobs ​

Alle Jobs, die diese Firewall betreffen (direkt, ueber Gruppe, Kunde oder "Alle"). Ausfuehren, pausieren, bearbeiten und loeschen direkt in der Liste.

Neuer Job oeffnet ab v3.31.3 dasselbe Formular wie die Jobs-Seite des Moduls, mit dieser Firewall als Ziel: Major-Upgrade mit Ziel Neueste Version oder bestimmter Version, HA-Optionen, Checks und Playbooks. Das Ziel laesst sich im Formular aendern.

Tab: Shell ​

Remote-Terminal zur OPNsense-Shell direkt im Browser. Nutzt den Agent fuer eine sichere WebSocket-Verbindung.

  • Volles interaktives Terminal
  • FreeBSD-Shell (csh/sh)
  • Root-Zugriff

Tab: Log ​

Chronologische Ausfuehrungsprotokolle aller Aktionen auf dieser Firewall:

  • Zeitstempel, Aktion, Benutzer
  • Ergebnis (Erfolg/Fehler)
  • Detail-Ausgabe aufklappbar

Tab: Gruppen ​

Verwalten der Gruppenzugehoerigkeit dieser Firewall:

  • Aktuelle Gruppen mit farbigen Badges
  • Gruppen hinzufuegen/entfernen

Siehe Gruppen.

Tab: Updates ​

  • HA-Kasten (bei CARP-Nodes): Rolle, Partner, Reboot ausstehend; Aktionen HA-Paar: Update, HA-Paar: Update + Reboot (rollierend), CARP-Maintenance aktivieren/aufheben
  • Einzel-Node-Buttons: System Update (ohne Reboot), Update + Reboot, Major Upgrade (startet einen Lauf, Ziel Neueste oder eine Version, Sprung fuer Sprung)
  • Versions-Info: OPNsense, Agent, Kernel, verfuegbares Update, naechste Major-Version

Tab: Agent ​

  • Agent-Status (Online/Offline) und Version
  • Agent-Konfiguration anzeigen
  • Agent-Logs einsehen
  • Agent neustarten

Tab: Loeschen ​

Firewall dauerhaft aus DATAZONE Control entfernen.

Achtung

Diese Aktion kann nicht rueckgaengig gemacht werden. Der Agent auf der Firewall wird dadurch nicht deinstalliert.

VPN-Management (seit v2.2.3) ​

Das OPNsense-Modul bietet eine zentrale Verwaltungsoberflaeche fuer WireGuard-VPN direkt in DATAZONE Control. Erreichbar ueber den VPN-Tab in der OPNsense-Modulansicht (neben der Host-Tabelle).

VPN-Uebersicht ​

Die VPN-Tabelle zeigt alle VPN-Instanzen ueber alle Firewalls hinweg. Die Ansicht aggregiert WireGuard, OpenVPN und IPsec-Tunnel zentral in einer Tabelle.

SpalteBeschreibung
KundeZugeordneter Kunde
FirewallName der Firewall
InstanzName der VPN-Instanz
TypWG RW (Road Warrior), WG S2S (Site-to-Site), OpenVPN, IPsec
InterfaceWireGuard-Interface (wg0, wg1, etc.)
PortListening-Port
Tunnel-NetzwerkIP-Bereich des Tunnels
PeersAnzahl konfigurierter Peers
Aktive PeersAnzahl aktuell verbundener Peers
StatusOnline/Offline

Typ-Filter: Filtern Sie nach VPN-Typ (Alle, WireGuard, OpenVPN, IPsec) mit Zaehler-Badges.

WireGuard-Instanzen ​

Neue Instanz erstellen ​

Klicken Sie auf Neue Instanz, um eine WireGuard-Instanz auf einer Firewall anzulegen:

FeldBeschreibung
FirewallZiel-Firewall (nur online + API-ready)
NameName der WireGuard-Instanz
PortListening-Port (Standard: 51820)
Tunnel-NetzwerkIP-Adresse und Subnetz (z.B. 10.10.10.1/24)
DNS fuer ClientsDNS-Server fuer Client-Konfigurationen
WAN-Regel erstellenErstellt eine UDP-Firewall-Regel auf dem WAN-Interface
Allow-All auf WireGuard-InterfaceErlaubt allen Traffic durch den Tunnel

Firewall-Regeln getrennt

Die WAN-Regel (Port oeffnen) und die Allow-All-Regel (Traffic erlauben) sind getrennt steuerbar. So koennen Sie den Port oeffnen, aber den Traffic auf dem WireGuard-Interface manuell in OPNsense einschraenken.

Peer hinzufuegen ​

Klicken Sie auf eine Instanz und waehlen Sie Peer hinzufuegen:

FeldBeschreibung
NameName des Peers (z.B. Mitarbeiter-Name)
Tunnel-IPIP-Adresse des Peers im Tunnel-Netzwerk
DNSDNS-Server fuer den Peer
MTUNur wenn abweichend von 1420
Split TunnelNur bestimmte Netze durch den Tunnel routen (LAN-Subnetze automatisch erkannt)

Nach dem Erstellen wird eine Client-Konfiguration mit QR-Code angezeigt, die direkt in WireGuard-Apps importiert werden kann.

Private Key

Der private Schluessel des Peers wird nur einmalig nach dem Erstellen angezeigt. Er kann nicht erneut abgerufen werden. Speichern Sie die Konfiguration oder scannen Sie den QR-Code sofort.

Tunnel-Modus ​

ModusBeschreibung
Full TunnelGesamter Traffic wird durch den VPN-Tunnel geleitet (0.0.0.0/0, ::/0)
Split TunnelNur bestimmte Netzwerke werden geroutet. LAN-Subnetze der Firewall werden automatisch als Vorschlaege angezeigt und koennen per Klick hinzugefuegt werden.

Instanz-Detail ​

Klicken Sie auf eine VPN-Instanz, um das Detail-Panel zu oeffnen.

WireGuard-Instanzen:

  • Instanz-Name, Interface, Typ-Badge und Status
  • Zugehoerige Firewall mit Direktlink
  • Peer-Tabelle mit Status, Name, Allowed IPs, Endpoint, letztem Handshake und Traffic (RX/TX)
  • Instanz aktivieren/deaktivieren
  • Einstellungen anzeigen (Name, Interface, Port, Tunnel-Netzwerk, UUIDs)

IPsec-Instanzen:

  • Phase-2/Child-SA Tabelle mit lokalen und Remote-Netzwerken
  • Verschluesselungs- und Hash-Details
  • Remote-Gateway, IKE-Version, DH-Gruppe, Lifetime, NAT-T Status

Peer-Aktionen ​

Fuer jeden WireGuard-Peer stehen folgende Aktionen zur Verfuegung:

AktionBeschreibung
Aktivieren/DeaktivierenPeer voruebergehend deaktivieren ohne ihn zu loeschen
Allowed IPs bearbeitenDie erlaubten IP-Bereiche des Peers aendern
Konfiguration/QR-CodeClient-Konfiguration anzeigen (nur direkt nach Erstellung)
LoeschenPeer dauerhaft entfernen

Allowed IPs bearbeiten:

  • Chips-basierte Verwaltung mit Hinzufuegen/Entfernen
  • Schnell-Buttons fuer gaengige Bereiche: 0.0.0.0/0, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16
  • Freie Eingabe beliebiger IP-Bereiche

Site-to-Site Wizard (seit v2.2.3) ​

Der Site-to-Site Wizard erstellt automatisch einen WireGuard-Tunnel zwischen zwei OPNsense-Firewalls in drei Schritten:

Schritt 1: Firewalls waehlen

  • Zwei Online-Firewalls mit API-Bereitschaft auswaehlen
  • Erkannte LAN-Subnetze werden automatisch angezeigt

Schritt 2: Konfiguration

FeldBeschreibung
Tunnel-SubnetzPoint-to-Point-Netz. Vorschlag: das nächste freie /30 aus 10.0.80.0/22
PortWireGuard-Port auf beiden Seiten. Vorschlag: der nächste freie ab 51830, erlaubt sind 1024–65535
VerbindungsmodusGleichberechtigt, A=Primaer oder B=Primaer
EndpointsIP oder DNS-Name ohne Port (abhaengig vom Verbindungsmodus). Vorbelegt mit der externen IP der Firewall
Netze A → B / B → AWelche lokalen Subnetze durch den Tunnel geroutet werden. Die erkannten LANs stehen als Chips zum Anklicken darüber, das LAN-Interface ist vorgewählt. Weitere Netze trägst du mit Komma getrennt ein
WAN-RegelUDP-Port oeffnen - ab 3.33.0 nur auf der Seite, die Verbindungen annimmt (bei A/B = Primaer nur dort)
Allow-AllAllen Tunnel-Traffic erlauben. Ab 3.33.0 wird die Wahl beachtet (vorher kam die Regel immer)

Seit v3.66.4 geht es erst weiter, wenn die Eingaben stimmen: Tunnelnetz und Netze mit Präfix (z. B. 192.168.1.0/24), Port im erlaubten Bereich und ein Endpunkt für jede Firewall, die Verbindungen annimmt. Netze dürfen sich nicht mit dem Tunnelnetz überschneiden. Dieselbe Prüfung macht auch der Server, bevor er etwas auf den Firewalls anlegt.

Schritt 3: Zusammenfassung und Ausfuehrung

Der Wizard fuehrt automatisch aus:

  1. Schluesselgenerierung auf beiden Firewalls
  2. WireGuard-Instanzen mit den generierten Schluesseln erstellen
  3. Peers auf beiden Seiten mit PSK (Pre-Shared Key) anlegen
  4. Firewall-Regeln erstellen (falls aktiviert)

Verbindungsmodus (seit v2.2.10) ​

ModusBeschreibung
GleichberechtigtBeide Firewalls haben feste IPs. Beide koennen die Verbindung initiieren. Beide bekommen Endpoint + Keepalive konfiguriert.
A = PrimaerFirewall A hat eine feste IP (Zentrale). Firewall B (Aussenstelle, dynamische IP) verbindet sich zu A. Nur A braucht einen Endpoint. B bekommt PersistentKeepalive=25.
B = PrimaerUmgekehrt: B hat feste IP, A verbindet sich zu B.

Dynamische IP

Waehlen Sie den Primaer-Modus, wenn ein Standort keine feste IP hat. Der sekundaere Standort verbindet sich immer zum primaeren und haelt den Tunnel mit PersistentKeepalive offen.

Site-to-Site Verbindung loeschen ​

Im Instanz-Detail-Panel einer S2S-Verbindung kann der gesamte Site-to-Site Link geloescht werden. Dabei werden automatisch:

  • Zugehoerige Firewall-Regeln (WAN + Allow-All) entfernt - ab 3.37.0 zuerst, solange die Instanz noch existiert (vorher blieb die Allow-All-Regel stehen, weil ihr WG-Interface nicht mehr gefunden wurde)
  • Peers auf beiden Seiten geloescht
  • WireGuard-Instanzen auf beiden Firewalls entfernt

Scheitert der Aufbau einer S2S-Verbindung, loescht Control ab 3.37.0 die zwischengespeicherten privaten Schluessel und den PSK sofort (vorher nur nach erfolgreichem Aufbau).

Seit 3.48.3:

  • Loeschen waehrend des Aufbaus: Noch nicht abgeholte Aufbau-Schritte verfallen sofort (sie laufen nie mehr), alles bereits Angelegte wird ueber die gespeicherten IDs entfernt. Fuehrt der Agent gerade einen Aufbau-Schritt aus, lehnt Control das Loeschen fuer diesen Moment ab (HTTP 409, in einer Minute erneut loeschen) - sonst bliebe auf der Firewall eine Instanz ohne Zuordnung zurueck. Ein Schritt, der seit 15 Minuten ohne Ergebnis haengt, blockiert nicht.
  • Scheitert eine Seite des Aufbaus, verfaellt auch der noch offene Schritt der anderen Seite.
  • Private Schluessel und PSK werden aus Task-Ergebnis und -Parametern entfernt, bevor irgendetwas gespeichert wird, ebenso bei verfallenen oder abgebrochenen Aufbau-Tasks (alte Eintraege einmalig beim Start).

WireGuard: ehrliche Rueckmeldung (ab 3.37.0)

OPNsense meldet Eingabefehler mit HTTP 200 und result: failed. Der Agent wertet das jetzt bei allen WireGuard-Aufgaben aus (Instanz, Peer, Zuordnung zur Instanz, Neukonfiguration, Firewall-Regeln) und meldet den Task als fehlgeschlagen. Ein halb angelegter Peer bzw. eine halb angelegte Instanz wird wieder entfernt. Peers aktivieren/deaktivieren und Allowed IPs aendern behaelt die Zuordnung zur Instanz (OPNsense hat sie bei Teil-Updates sonst entfernt). Der Pre-Shared Key eines neuen Road-Warrior-Peers wird im Browser erzeugt und mitgeschickt - er fehlt damit nie in der Client-Konfiguration. Aktivieren/Deaktivieren richtet sich nach dem Zustand aktiviert, nicht nach verbunden: ein nicht verbundener Peer laesst sich deaktivieren.

Rechte und Update-Sperre (ab 3.33.0)

Regeln, NAT, Aliase, Kategorien und WireGuard aendern darf nur, wer im Modul OPNsense Bearbeiten oder Tasks hat (Leserecht reicht nicht) und die Firewall im eigenen Kundenbereich sieht. Waehrend eines Update-Laufs auf der Firewall werden Aenderungen mit einem Hinweis abgelehnt, damit kein Filter-Reload in den Neustart faellt. Ungueltige Regel- oder Peer-IDs lehnt Control ab. Die getrennte Wahl "nur Allow-All ohne WAN-Regel" braucht Agent ab 3.33.0; aeltere Agents wuerden den Port mit oeffnen, deshalb legt Control dann keine Regel an.

Firewall-Regeln (seit v2.3.0) ​

Das OPNsense-Modul bietet eine zentrale Verwaltung fuer Firewall-Regeln, Aliase, Kategorien und NAT-Regeln direkt in DATAZONE Control. Erreichbar ueber den Rules-Tab in der OPNsense-Modulansicht.

Uebersicht ​

Die Rules-Uebersicht zeigt alle Firewalls mit der Anzahl ihrer Regeln, aufgeschluesselt nach Typ (Pass, Block, Reject).

Klicken Sie auf eine Firewall, um den Regel-Editor zu oeffnen. Dieser enthaelt 5 Tabs:

TabBeschreibung
RulesFilter-Regeln (Hauptregeln)
AliasesAliase verwalten
CategoriesKategorien verwalten
NAT SourceOutbound-NAT-Regeln (Source NAT)
NAT Port ForwardPort-Weiterleitungen

Commit-Workflow

Alle Aenderungen an Regeln, Aliasen und NAT-Regeln werden zunaechst lokal gespeichert. Erst durch Klick auf Commit werden die Aenderungen auf die Firewall uebertragen. Mit Discard koennen nicht-commitete Aenderungen verworfen werden.

Uebernehmen: Absicherung und Rueckmeldung (ab 3.37.0) ​

Automatischer Rollback bei Regeln und Source NAT. Vor der ersten Aenderung legt der Agent einen Savepoint an (/api/firewall/filter/savepoint bzw. /api/firewall/source_nat/savepoint) und uebernimmt mit dieser Revision (.../apply/<revision>). OPNsense setzt die Regeln nach 60 Sekunden selbst zurueck, wenn der Rollback nicht abgebrochen wird. Der Agent baut nach dem Uebernehmen eine neue Verbindung zu Control auf; erst wenn das klappt, bricht er den Rollback ab (.../cancelRollback/<revision>) und prueft auf der Firewall, dass der Rollback-Timer wirklich beendet ist. Ist Control nicht erreichbar, endet der Task mit Verbindung nach dem Uebernehmen verloren - OPNsense setzt die Aenderung nach 60 s automatisch zurueck.

BereichAutomatischer RollbackVerbindungspruefung
Filter-Regelnja (OPNsense 25.7 / 26.1)ja
Source NATja (OPNsense 25.7 / 26.1)ja
Port-Weiterleitungen (API ab OPNsense 26.1)nein - eigenes OPNsense-Modell (DNat), das der Rollback nicht erfasstja, bei Verlust deutlicher Hinweis
Aliase, Kategorienneinnein

OPNsense 26.7

Ab OPNsense 26.7 gibt es Savepoint und Rollback in der API nicht mehr. Der Agent erkennt das und uebernimmt dann ohne automatischen Rollback; die Verbindungspruefung laeuft weiter und meldet einen Verlust als Fehler.

Laeuft noch der Rollback-Timer einer vorherigen Aenderung (60 s), lehnt der Agent ab: Rollback einer vorherigen Aenderung laeuft noch - bitte 60 s warten (OPNsense wuerde sonst keinen neuen Timer starten). Direkt nach dem Uebernehmen prueft er, dass der eigene Timer wirklich laeuft; sonst meldet er ehrlich, dass kein Rollback aktiv ist. Als Erreichbarkeit zaehlt nur eine echte Antwort von Control (nicht z. B. eine Fehlerseite eines Proxys).

Port-Weiterleitungen sind ueber die API erst ab OPNsense 26.1 verfuegbar; aeltere Versionen melden dies klar.

Position neuer Eintraege. Neue Regeln und NAT-Eintraege kommen ans Ende (hoechste vorhandene Sequenz + 100), so wie die Liste sie anzeigt - aeltere OPNsense-Versionen haetten sie sonst mit Sequenz 1 ganz nach vorn gesetzt. Beim Bearbeiten wird die Position nie mitgeschickt; nur das Verschieben aendert sie. Konnte der Agent die Kategorien eines Eintrags nicht lesen, werden sie beim Bearbeiten nicht ueberschrieben.

Ehrliches Ergebnis. Jede Aenderung wird einzeln ausgewertet (OPNsense meldet Eingabefehler mit HTTP 200 und result: failed). Schlaegt das Uebernehmen (apply) fehl, ist der Task fehlgeschlagen. Nach dem Uebernehmen zeigt der Reiter einen Hinweis mit allen fehlgeschlagenen Aenderungen; nur erfolgreiche Aenderungen werden in die Liste uebernommen, neue Eintraege bekommen sofort ihre echte ID. Kommt binnen 2,5 Minuten keine Rueckmeldung (z. B. Agent offline), steht dort Ergebnis unbekannt - nach dem naechsten Heartbeat neu laden. Ein neu angelegter, noch nicht uebernommener Eintrag kann vorher aktiviert/deaktiviert werden; der Zustand geht mit der Neuanlage mit.

Reihenfolge. Nur wenn Regeln verschoben wurden, schickt Control die gewuenschte Reihenfolge mit. Der Agent aendert dann nur die Sequenz der Regeln, deren Position sich wirklich geaendert hat (vorher wurden bei jedem Uebernehmen alle Regeln neu nummeriert - je Regel eine Konfigurations-Revision).

Netze von Interfaces. OPNsense speichert LAN net als lan und LAN address als lanip. Control zeigt die Klartext-Namen und setzt sie beim Uebernehmen richtig um (vorher wurde lannet gesendet, das OPNsense ablehnt). Interface-Namen kommen ab 3.37.0 nur noch aus den direkten Eintraegen unter <interfaces> der config.xml.

Filter-Regeln (Rules) ​

Der Rules-Tab zeigt alle Firewall-Regeln der ausgewaehlten Firewall mit visuellen Statusindikatoren.

Filtern und Suchen ​

  • Action-Filter: Alle, Pass, Block, Reject
  • Interface-Filter: Dropdown mit allen verfuegbaren Interfaces
  • Kategorie-Filter: Dropdown mit allen konfigurierten Kategorien
  • Freitextsuche: Durchsucht alle sichtbaren Spalten

Regel-Anzeige ​

Jede Regel zeigt folgende Informationen:

FeldBeschreibung
#Sequenz-Nummer (Reihenfolge)
AktivAktiviert/Deaktiviert (Toggle)
ActionPass (gruen), Block (rot) oder Reject (orange)
RichtungIn oder Out
InterfaceNetzwerk-Interface (WAN, LAN, etc.)
ProtokollTCP, UDP, ICMP, etc.
QuelleQuell-Adresse oder Alias (mit NOT-Indikator)
ZielZiel-Adresse oder Alias (mit NOT-Indikator)
GatewayZugewiesenes Gateway
LogOb die Regel protokolliert wird
KategorienZugewiesene Kategorien als farbige Chips
BeschreibungFreitext-Beschreibung

Regeln erstellen ​

Klicken Sie auf Regel hinzufuegen, um eine neue Regel zu erstellen. Waehlen Sie optional eine Vorlage:

VorlageBeschreibung
LeerLeere Regel zum manuellen Ausfuellen
Allow HTTP/HTTPSWeb-Traffic erlauben (Port 80/443)
Allow SSHSSH-Zugriff erlauben (Port 22)
Allow DNSDNS-Abfragen erlauben (Port 53)
Allow ICMPPing erlauben
Allow SMTPE-Mail-Versand erlauben (Port 25/587)
Allow WireGuardWireGuard-VPN erlauben
Allow OpenVPNOpenVPN-VPN erlauben
Allow IPsecIPsec-VPN erlauben
Block AllAllen Traffic blockieren

Regel bearbeiten ​

Das Bearbeitungsformular ist in Abschnitte gegliedert:

Organisation:

  • Aktiviert/Deaktiviert
  • Kategorien zuweisen
  • Beschreibung

Interface:

  • Interface-Auswahl (inkl. "Floating (all)" fuer alle Interfaces)
  • Interface invertieren (NOT)

Filter:

  • Quick-Regel (optimierte Verarbeitung)
  • Action: Pass, Block, Reject
  • Richtung: In, Out
  • IP-Version: IPv4, IPv6, IPv4+IPv6
  • Protokoll: Any, TCP, UDP, TCP/UDP, ICMP, ESP, AH, GRE, IGMP, PIM, OSPF

Quelle:

  • Quell-Adresse ueber Netzwerk-Selektor (siehe unten)
  • Quelle invertieren (NOT)
  • Quell-Port

Ziel:

  • Ziel-Adresse ueber Netzwerk-Selektor
  • Ziel invertieren (NOT)
  • Ziel-Port

Erweitert:

  • Gateway-Auswahl
  • Protokollierung aktivieren

Netzwerk-Selektor ​

Der Netzwerk-Selektor ist ein intelligentes Dropdown, das verschiedene Adress-Typen gruppiert:

GruppeOptionen
Allgemeinany (beliebig), (self) (Firewall selbst)
Interface-AdressenIP-Adresse jedes Interfaces (z.B. LAN address, WAN address)
Interface-NetzwerkeSubnetz jedes Interfaces (z.B. LAN net, WAN net)
AliaseAlle konfigurierten Aliase
Einzelner Host oder NetzwerkManuelle Eingabe einer IP/Subnetz

Regeln sortieren ​

Die Reihenfolge der Regeln bestimmt die Verarbeitungsprioriaet. Verwenden Sie die Pfeil-Buttons (hoch/runter), um Regeln neu zu ordnen.

Geschuetzte Regeln ​

Regeln mit DATAZONE-PROTECT in der Beschreibung sind geschuetzt und koennen nicht bearbeitet, deaktiviert oder geloescht werden.

Ab 3.37.0 legt Control keine DATAZONE-PROTECT-Regeln mehr an (vorher beim ersten Uebernehmen eine Regel fuer alle Ports vom Control-Server). Bestehende Regeln bleiben unveraendert und weiter geschuetzt. Schutz vor dem Aussperren sind jetzt Savepoint/Rollback und die Verbindungspruefung nach dem Uebernehmen (siehe oben) - die Verbindung des Agents zu Control laeuft ausgehend.

Ist die Regelliste der Firewall nicht lesbar, uebernimmt der Agent nichts und meldet den Grund (sicherer Abbruch statt Loeschen ohne Pruefung).

Aliase ​

Aliase sind benannte Gruppen von IP-Adressen, Netzwerken oder URLs, die in Firewall-Regeln verwendet werden koennen. Sie vereinfachen die Regelverwaltung erheblich.

Alias-Typen ​

TypBeschreibungBeispiel
Host(s)Einzelne IP-Adressen oder Hostnamen192.168.1.100, server.example.com
Network(s)IP-Subnetze in CIDR-Notation192.168.1.0/24, 10.0.0.0/8
URL Table (IPs)URL die eine IP-Liste liefertBlocklisten-URLs
URL TableURL die eine gemischte Liste liefertExterne Filterlisten
GeoIPLaender-basierte IP-BereicheLaendercodes
ExternalExtern verwaltete AliaseExterne Quellen

Alias erstellen/bearbeiten ​

FeldBeschreibung
NameEindeutiger Name (nur Buchstaben, Zahlen, Unterstrich)
TypAlias-Typ (siehe oben)
BeschreibungOptionale Beschreibung
InhaltIP-Adressen, Netzwerke oder URLs (eine pro Zeile)
KategorienAuswahl aus den vorhandenen Kategorien (ab 3.37.0 Mehrfachauswahl statt Freitext)
Protokoll-FilterAny, IPv4 oder IPv6 (bei URL-Typen)
Update-IntervallAktualisierungsfrequenz fuer URL-basierte Aliase

Aliase in Regeln verwenden

Erstellte Aliase erscheinen automatisch im Netzwerk-Selektor der Firewall-Regeln unter der Gruppe "Aliase".

Kategorien ​

Kategorien dienen zur Organisation von Firewall-Regeln und Aliasen. Sie koennen farblich markiert werden.

  • Erstellen: Name und Farbe festlegen
  • Bearbeiten: Name und Farbe aendern
  • Loeschen: Kategorie entfernen (Zuweisungen werden aufgeloest)

Kategorien werden als farbige Chips in der Regel- und Alias-Uebersicht angezeigt.

Im Regel- und Alias-Editor waehlt man ab 3.37.0 aus den vorhandenen Kategorien (Chips zum An-/Abwaehlen). Neue Kategorien erst im Reiter Kategorien anlegen und uebernehmen. OPNsense speichert Kategorien als IDs; der Agent setzt die Namen beim Uebernehmen in IDs um, unbekannte Namen fuehren zu einer klaren Fehlermeldung (vorher wurden Namen gesendet und von OPNsense abgelehnt).

Die Seite Aliase und der Reiter Aliase der Firewall-Regeln verhalten sich nach dem Uebernehmen gleich (Hinweis mit Fehlern, nur Erfolgreiches wird uebernommen).

NAT Source (Outbound NAT) ​

Outbound-NAT-Regeln steuern die Quell-Adressenuebersetzung fuer ausgehenden Traffic.

Vorlagen ​

VorlageBeschreibung
LeerLeere Regel
Outbound LANStandard-NAT fuer LAN-Traffic
Outbound All InterfacesNAT fuer alle Interfaces

Regel-Felder ​

FeldBeschreibung
AktiviertRegel aktivieren/deaktivieren
InterfaceAusgehendes Interface
IP-VersionIPv4, IPv6 oder beide
ProtokollNetzwerk-Protokoll
QuelleQuell-Netzwerk (mit NOT und Netzwerk-Selektor)
ZielZiel-Netzwerk (mit NOT und Netzwerk-Selektor)
Ziel-PortZiel-Port
Ziel-IP (Translation)Uebersetzte Quell-Adresse
Ziel-Port (Translation)Uebersetzter Quell-Port
LogProtokollierung aktivieren
BeschreibungFreitext-Beschreibung

NAT Port Forward ​

Port-Forward-Regeln leiten eingehenden Traffic an interne Server weiter.

Vorlagen ​

VorlageBeschreibung
LeerLeere Regel
Port Forward HTTPHTTP-Weiterleitung (Port 80)
Port Forward HTTPSHTTPS-Weiterleitung (Port 443)
Port Forward RDPRDP-Weiterleitung (Port 3389)
Port Forward SSHSSH-Weiterleitung (Port 22)

Regel-Felder ​

FeldBeschreibung
AktiviertRegel aktivieren/deaktivieren
InterfaceEingehendes Interface (typisch: WAN)
IP-VersionIPv4, IPv6 oder beide
ProtokollNetzwerk-Protokoll
QuelleQuell-Adresse (mit NOT und Netzwerk-Selektor)
Quell-PortQuell-Port
ZielExterne Ziel-Adresse (mit NOT und Netzwerk-Selektor)
Externer PortPort auf dem Interface (oeffentlicher Port)
Ziel-IP (Redirect)Interner Server (IP-Adresse)
Interner PortPort auf dem internen Server
LogProtokollierung aktivieren
BeschreibungFreitext-Beschreibung

Beispiel: Webserver weiterleiten

Um einen internen Webserver (192.168.1.100:443) oeffentlich erreichbar zu machen, erstellen Sie eine Port-Forward-Regel auf dem WAN-Interface mit externem Port 443 und Ziel-IP 192.168.1.100, interner Port 443.

IPsec MSS-Clamping (seit v3.6.0) ​

Bei IPsec-Tunneln brauchen grosse TCP-Pakete oft MSS-Clamping. Der Grund ist der IPsec-Overhead von 50 bis 80 Byte, bei PPPoE oder DS-Lite kommt eine kleinere WAN-MTU hinzu, auch wenn ein Router wie eine Fritzbox davor sitzt. Ohne Clamping haengen typischerweise SMB, RDP oder HTTPS ueber den Tunnel, waehrend Ping funktioniert. Standard ist eine Regel unter Firewall > Einstellungen > Normalisierung auf der Schnittstelle IPsec (enc0). Sie deckt alle Tunnel und kuenftige Netze ab.

Dafuer gibt es zwei System-Scripts und einen vordefinierten Check:

BausteinWirkung
OPNsense IPsec MSS-Clamping CheckNur lesend. Prueft vorhandene Regeln und deren Abdeckung je Tunnel-Remote-Netz, misst die WAN-Pfad-MTU per DF-Ping zur Gegenstelle oder ins Internet, zaehlt Fragmentierung und testet die Pfad-MTU durch jeden aktiven Tunnel
OPNsense IPsec MSS-Clamping aktivierenLegt die Regel auf enc0 mit max-mss an und laedt den Filter neu. Ab v3.11.0 nimmt es je Firewall den Wert SUGGESTED_MSS aus dem letzten Ergebnis des Checks, ohne Ergebnis 1350. Vorhandene enc0-Regel wird nur angepasst, LAN-seitige Regeln bleiben unveraendert, vorher wird ein config.xml-Backup erstellt
Check „IPsec MSS-Clamping“Vordefinierter Health-Check mit dem Check-Script und dem Aktivieren-Script als Remediation. Auto-Remediation ist standardmaessig aus

Ergebnisse des Checks:

ErgebnisExit-CodeBedeutung
CLAMPING_OK0Regel auf enc0 vorhanden und aktiv
NO_IPSEC0IPsec ist nicht aktiv
CLAMPING_NONSTANDARD1Alle Remote-Netze werden nur ueber LAN-seitige Regeln geclampt. Funktioniert, muss aber pro Netz gepflegt werden und greift nur fuer das jeweilige Interface
CLAMPING_TOO_HIGH1max-mss auf enc0 ist groesser als der empfohlene Wert
CLAMPING_RECOMMENDED1Keine Regel, aber kein Messbeweis. Clamping trotzdem empfohlen
CLAMPING_PARTIAL2Nur ein Teil der Remote-Netze ist LAN-seitig abgedeckt
CLAMPING_NEEDED2Keine Regel und WAN- bzw. Tunnel-MTU unter 1500 oder ICMP „Fragmentierung noetig“ empfangen

Fuer Custom Fields gibt der Check die Zeilen FIELD:MSS_STATUS, FIELD:MSS_CLAMP, FIELD:WAN_PMTU und FIELD:SUGGESTED_MSS aus. Antwortet die Gegenstelle nicht auf Ping, misst der Check den eigenen Uplink ueber 1.1.1.1, 8.8.8.8 oder 9.9.9.9. Das Aktivieren-Script uebernimmt SUGGESTED_MSS automatisch je Firewall (siehe Werte aus Checks an Scripts uebergeben) und schreibt den verwendeten Wert ins Log. Nach erfolgreichem Lauf prueft der Check die Firewall automatisch erneut. Fuer einen festen Wert eine Kopie des Aktivieren-Scripts anlegen, die Zeile # DZ-CHECK-VAR entfernen und MSS setzen. Fuer route-basierte Tunnel (VTI, ipsecX) gilt die enc0-Regel nicht, dort die MSS direkt an der Schnittstelle setzen.

Legacy-Migration IPsec und Firewall-Regeln (seit v3.6.3) ​

Neuere OPNsense-Versionen lagern die alten Seiten fuer IPsec-Tunnel (Phase 1/2) und Firewall-Regeln in Legacy-Plugins aus. Vor Updates sollten beide auf die neuen Bereiche VPN > IPsec > Connections und Firewall > Rules umgestellt werden. Dafuer gibt es je einen Probelauf und eine Ausfuehren-Variante:

ScriptWirkung
OPNsense IPsec Legacy-Migration (Probelauf)Nur lesend. Zeigt je aktivem Legacy-Tunnel die geplante Connection mit IDs, Proposals, Children, PSK und WAN-Regeln, und was manuell bleibt
OPNsense IPsec Legacy-Migration (ausfuehren)Legt Connections, PSK und WAN-Regeln an, deaktiviert die Legacy-Phase-1 und laedt IPsec und Filter neu
OPNsense Regel-Migration Legacy -> Rules (Probelauf)Nur lesend, ab OPNsense 26.1. Simuliert den Import aller Legacy-Regeln und listet Regeln, die nicht uebernommen werden koennen
OPNsense Regel-Migration Legacy -> Rules (ausfuehren)Legt alle Legacy-Regeln als neue Regeln an, deaktiviert die Legacy-Regeln und laedt den Filter neu

IPsec: Das Mapping folgt dem Legacy-Rendering von OPNsense selbst. Krypto, IDs, Lifetimes und Reqids bleiben gleich, unter IKEv2 werden mehrere Phase-2-Eintraege wie bisher zu einem Child zusammengefasst. Da OPNsense die automatischen WAN-Regeln fuer IKE (UDP 500/4500) und ESP nur fuer Legacy-Tunnel erzeugt, legt die Migration diese Regeln als neue Firewall-Regeln an. Nicht automatisch migriert werden Mobile/Road-Warrior, EAP und XAuth, route-basierte Tunnel (VTI), Transport-Modus und Phase 2 mit NAT. War ein Tunnel vor der Migration aufgebaut und kommt er nicht innerhalb von 90 Sekunden wieder hoch, spielt das Script die alte Konfiguration automatisch zurueck.

Regeln: Die Migration nutzt den OPNsense-eigenen Konverter und behaelt die UUID jeder Regel. Ein erneuter Lauf aktualisiert statt zu duplizieren. Die migrierten Regeln werden hinter bereits vorhandene neue Regeln einsortiert, damit die bisherige Reihenfolge erhalten bleibt. Es werden nur alle Regeln gemeinsam migriert. Kann eine Regel nicht uebernommen werden, bricht das Script ohne Aenderung ab. Nach dem Neuladen prueft es, ob jede vorher aktive Regel wieder im Regelwerk ist und Control erreichbar bleibt, sonst folgt ein automatisches Rollback.

In beiden Faellen bleiben die Legacy-Eintraege deaktiviert in der Konfiguration. Vorher wird ein Backup unter /conf/backup/ angelegt. Die Probelaeufe sind als vordefinierte Checks OPNsense Legacy-IPsec und OPNsense Legacy-Firewall-Regeln angelegt, damit der Stand ueber alle Firewalls sichtbar ist. Der Check OPNsense Legacy-IPsec ist seit v3.12.0 nur dann kritisch, wenn aktive Legacy-Tunnel da sind, aber das Plugin os-strongswan-legacy fehlt. Dann baut OPNsense diese Tunnel nicht auf. Migrierbare Tunnel und Tunnel mit manuellen Punkten sind eine Warnung. Nach der Migration meldet der Check OK, denn deaktivierte Legacy-Regeln zaehlen nicht mehr. Ein erneuter Lauf aendert dann nichts und laedt den Filter nicht neu. Bereits migrierte Regeln werden nie durch ihre deaktivierte Legacy-Kopie ueberschrieben.

Sicherheits-Grundcheck und verwundbare Pakete (seit v3.40.0) ​

Zwei vordefinierte Checks, beide nur lesend. Sie laufen erst, wenn du sie über einen Job verteilst (Automatisierung → Jobs, Typ Check). Auto-Remediation gibt es nicht.

OPNsense Sicherheits-Grundcheck bewertet nur, was sich sicher aus /conf/config.xml ablesen lässt. Aliase in Regeln werden nicht aufgelöst (dann keine Wertung).

PrüfungErgebnis
Web-GUI aus dem WAN erreichbar: aktive Pass-Regel auf WAN (auch floating mit WAN), Quelle any, Ziel (self), WAN-Adresse oder any, Port leer oder GUI-Port, Protokoll TCP/any – und die GUI lauscht auf allen Interfaces oder auf WAN. Legacy-Regeln und Regeln ab 26.1 (Firewall: Rules)kritisch
SSH aktiv mit Root-Login und Passwort-AnmeldungWarnung
Web-GUI per http statt httpsWarnung
TLS-Minimum der GUI unter TLS 1.2 (nur wenn in der erzeugten lighttpd-Konfiguration ablesbar, sonst unknown)Warnung
2FA (TOTP-Server in der GUI-Anmeldung), Benutzer mit Shell, Benutzer mit API-Schlüsselnnur Info (FIELD)

Nicht geprüft wird, ob root noch das Standardpasswort hat – das lässt sich aus dem gespeicherten Hash nicht zuverlässig feststellen. Auch das Alter von API-Schlüsseln steht nicht in der config.xml. FIELD-Ausgaben: GUI_WAN_EXPOSED, GUI_PROTOCOL, SSH_ENABLED, SSH_ROOT_PASSWORD, TLS_MIN, GUI_2FA, SHELL_USERS, API_KEY_USERS. Exit 0 = OK, 1 = Warnung, 2 = kritisch, 3 = keine OPNsense / nicht auswertbar.

OPNsense verwundbare Pakete (pkg audit) führt pkg audit -F -q aus (lädt die Schwachstellen-Datenbank). Klappt der Download nicht, nimmt der Check die vorhandene Datenbank (FIELD:VULN_DB=cached). Exit 0 = keine verwundbaren Pakete, 2 = verwundbare Pakete installiert (Liste im Log und in FIELD:PACKAGES, gekürzt), 3 = Prüfung nicht möglich. Abhilfe ist in der Regel ein OPNsense-Update; bleiben Pakete gemeldet, gibt es noch keinen Fix.

Alarme für Zertifikate, Gateways und VPN (seit v3.40.0) ​

Control meldet ablaufende ACME-Zertifikate, gestörte Gateways und – nur auf Wunsch – getrennte IPsec-Tunnel und WireGuard-Standorte. Im Reiter VPN und in der VPN-Übersicht schaltest du die Überwachung je Tunnel mit Überwachen ein, die Pill überwacht zeigt den Zustand. Im Reiter Übersicht → Gateways steht der Verlauf der letzten 30 Tage. Details: Benachrichtigungen.

Vorlagen (ab 3.46.0) ​

Unter OPNsense > Vorlagen legst du einen Alias, eine Filter-Regel oder eine Outbound-NAT-Regel (Source NAT) einmal an und spielst sie auf viele Firewalls aus. Control verwaltet die Vorlage danach: es prüft regelmäßig, ob sie auf jeder Firewall noch stimmt, und meldet Abweichungen. Überschrieben wird nie automatisch – angeglichen wird nur, wenn du es auslöst.

Ziel ​

Eine Vorlage gilt für eine oder mehrere Firewalls, eine OPNsense-Gruppe, einen Kunden oder alle Firewalls (auch später hinzukommende). Kundengebundene Benutzer sehen nur die Vorlagen ihres Kunden und können als Ziel nur ihren Kunden oder einzelne eigene Firewalls wählen. Anlegen, Ändern und Ausspielen brauchen wie jede Änderung an einer Firewall OPNsense Bearbeiten oder Tasks; zum Ansehen reicht das Leserecht.

Markierung ​

Jedes ausgespielte Objekt bekommt am Anfang seiner Beschreibung die Markierung [DZT:<Nr>] (Nummer der Vorlage), z. B. [DZT:12] DATAZONE-Admins. Daran findet Control das Objekt wieder – auch wenn es auf der Firewall umbenannt oder verschoben wurde. Entfernt jemand die Markierung, erkennt Control das Objekt noch an seiner gemerkten UUID und zeigt es als abweichend.

Aliase haben auf einer Firewall eindeutige Namen. Gibt es dort schon einen Alias mit dem Namen der Vorlage, aber ohne Markierung, steht die Firewall auf Konflikt: Control fasst ihn nicht an. Mit Übernehmen wird der vorhandene Alias markiert und auf den Inhalt der Vorlage angeglichen.

Platzhalter für Interfaces ​

In Regeln und Outbound-NAT schreibst du Interfaces als WAN, LAN oder mit der Interface-Beschreibung (z. B. GAST). Netze heißen LAN net, WAN address usw., daneben gehen any, (self), Aliase und Netze wie 10.0.0.0/8. Control setzt je Firewall das passende Interface ein (Beschreibung aus der config.xml; heißt das WAN-Interface z. B. „Internet“, wird WAN darauf aufgelöst, sofern der Agent den Schlüssel meldet). Gibt es ein Interface auf einer Firewall nicht, steht sie auf fehlgeschlagen mit dem Grund – dort wird nichts ausgespielt.

Status je Firewall ​

StatusBedeutung
aktuellObjekt vorhanden und gleich der Vorlage
abweichendObjekt vorhanden, aber Felder weichen ab (welche, steht im Hinweis)
fehltObjekt nicht auf der Firewall
KonfliktAlias gleichen Namens ohne Markierung (oder von einer anderen Vorlage)
läuftAusspielen/Entfernen läuft gerade
fehlgeschlagenPlatzhalter nicht auflösbar oder letztes Ausspielen fehlgeschlagen (Grund im Hinweis)
Agent zu altAgent unter 3.37.0 – Vorlagen werden dort nicht ausgespielt
verwaistVorlage gelöscht oder Firewall nicht mehr im Ziel, das Objekt ist aber noch da
keine DatenDie Firewall hat noch keine Regel-/Alias-Daten gemeldet

Verglichen werden nur die Felder, die die Vorlage festlegt; Listen wie der Inhalt eines Alias unabhängig von der Reihenfolge. Die Prüfung läuft beim Öffnen der Seite, mit Jetzt prüfen und stündlich im Hintergrund. Grundlage sind die Daten, die der Agent mit dem Heartbeat schickt (bis zu 5 Minuten alt).

Ausspielen und Angleichen ​

Ausspielen (für alle Ziele oder je Firewall) zeigt zuerst eine Vorschau: je Firewall Anlegen, Angleichen, Nichts zu tun oder warum es nicht geht (offline, Agent zu alt, Update-Lauf aktiv, Konflikt). Erst nach der Bestätigung (ab 5 Firewalls mit Tippbestätigung) legt Control je Firewall einen Task an – über denselben Weg wie die Firewall-Regeln: Schreibrecht und Kundenscope werden geprüft, während eines Update-Laufs ist die Firewall gesperrt, und vorher wird die config.xml gesichert. Filter-Regeln und Outbound-NAT laufen mit dem automatischen Rollback aus 3.37.0.

Neue Regeln landen am Ende der Regelliste der Firewall. Die Reihenfolge änderst du bei Bedarf in den Firewall-Regeln; beim Angleichen bleibt die Position unverändert. Nötig ist Agent 3.37.0 oder neuer.

Entfernen nur ausdrücklich ​

Control löscht nie selbst etwas auf einer Firewall. Wird eine Vorlage gelöscht oder fällt eine Firewall aus dem Ziel, bleibt das Objekt dort und steht auf verwaist. Dann wählst du je Firewall:

  • Von Firewall entfernen – das Objekt wird (nach Rückfrage) über seine UUID gelöscht. Wird ein Alias noch von Regeln benutzt, lehnt OPNsense das ab.
  • Nicht mehr verwalten – das Objekt bleibt unverändert, Control prüft es nicht mehr.

Eine gelöschte Vorlage verschwindet aus der Liste, sobald keine Firewall mehr verwaist ist.

Diagnose (ab 3.48.0) ​

Im Detail einer Firewall liegt unter Netzwerk der Reiter Diagnose. Alles wird beim Öffnen bzw. auf Knopfdruck live vom Agent geholt (Agent-RPC) – Control speichert nichts davon und ändert nichts an der Firewall. Läuft auf der Firewall ein Agent älter als 3.48.0, zeigt der Reiter Agent-Update nötig; stoße dann im Reiter Agent ein Update an.

Interfaces ​

Pakete, Bytes, Fehler und Drops je Richtung sowie Kollisionen für jedes Interface (netstat -i -b -d -n --libxo json, ohne libxo die Textausgabe). Die Namen aus der Konfiguration (WAN, LAN, Gäste …) stehen über dem Gerätenamen (igb0, vlan0.10). Werte größer 0 bei Fehlern, Drops und Kollisionen sind rot. Die Zähler laufen seit dem letzten Neustart der Firewall – mit Aktualisieren siehst du, ob sie gerade steigen.

ARP/NDP ​

Die ARP-Tabelle (IPv4, arp -an) und die NDP-Tabelle (IPv6, ndp -an) in einer Liste mit IP, MAC, Interface, Ablaufzeit und Typ. Hostnamen kommen aus den DHCP-Leases, soweit bekannt. Das Suchfeld filtert nach IP, MAC, Name und Interface; oben schaltest du zwischen allen, ARP und NDP um.

DHCP-Leases ​

Alle Leases der DHCP-Server, die auf der Firewall laufen, in einer Liste – mit IP, MAC, Hostname, Interface, Beginn, Ende, Typ (dynamisch/statisch) und Server:

ServerQuelle
ISC DHCPconfigctl dhcpd list leases 4, Reservierungen aus der Konfiguration (auch ohne aktuelles Lease als „reserviert“)
Kea (ab OPNsense 24.1)configctl kea list leases4, sonst die Lease-Datei /var/db/kea/dhcp4.leases; Reservierungen sind „statisch“
Dnsmasq (ab OPNsense 25.1)/var/db/dnsmasq.leases; Leases ohne Ablauf sind „statisch“

Oben steht je Server die Anzahl. Kann ein Server nicht gelesen werden, erscheint ein gelber Hinweis mit dem Grund. Der Reiter DHCP in der Übersicht zeigt weiter den Stand aus dem letzten Heartbeat (nur ISC).

Firewall-Log ​

Sucht im pf-Firewall-Log der Firewall (/var/log/filter/filter_*.log, neueste Datei zuerst, Feldaufbau wie in der OPNsense-Oberfläche). Filter:

  • Zeitraum 15 Minuten, 1 Stunde oder 24 Stunden
  • Aktion alle, erlaubt (pass) oder blockiert (block)
  • Interface und Protokoll
  • Quell-/Ziel-IP – eine ganze Adresse trifft genau diese, mit Präfix ein Netz (10.0.0.0/24), sonst genügt ein Teil der Adresse (z. B. 192.168.10.)
  • Quell-/Ziel-Port – muss genau passen
  • Zeilen – Standard 500, höchstens 2000

Jede Zeile zeigt Zeit, Interface, Aktion, Richtung, Protokoll (bei TCP mit Flags), Quelle und Ziel mit Port sowie den Namen der Regel (aus dem laufenden Regelwerk, sonst die Regel-ID). Je Firewall läuft immer nur eine Suche, und je Suche liest der Agent höchstens 96 MB Log; reicht das nicht, sagt Control das – dann den Zeitraum verkleinern oder Filter setzen. Im Log stehen nur Regeln mit aktivierter Protokollierung.

Paketmitschnitt ​

Startet tcpdump auf einem Interface der Firewall und stellt das Ergebnis als .pcap zum Herunterladen bereit (öffnen z. B. mit Wireshark).

  • Grenzen: höchstens 120 Sekunden, 10000 Pakete und 20 MB – was zuerst erreicht ist, beendet den Mitschnitt. Je Paket werden die ersten 1600 Bytes gespeichert. Je Firewall läuft immer nur ein Mitschnitt; ein laufender lässt sich stoppen. Auf der Firewall liegen höchstens 3 Mitschnitte bzw. 60 MB, und in /tmp müssen mindestens 100 MB frei sein – sonst lehnt der Agent den Start mit einem Hinweis ab.
  • Agent-Neustart: tcpdump läuft unter timeout und endet spätestens 5 Sekunden nach der Grenze, auch wenn der Agent mittendrin neu startet. Beim Start beendet der Agent übrig gebliebene Mitschnitte und zeigt vorhandene Dateien wieder an (Status „fertig (Agent-Neustart)“), damit du sie herunterladen oder löschen kannst.
  • Filter: nur ein fester Wortschatz ist erlaubt – host, net, port, portrange, src, dst, proto, less, greater, ether host, vlan, Protokolle wie tcp, udp, icmp, icmp6, ip, ip6, arp, esp, gre, carp, dazu and, or, not und Klammern, als Werte IP-Adressen, Netze, MAC-Adressen und Zahlen. Beispiel: host 10.0.0.5 and tcp port 443. Alles andere (Sonderzeichen, Optionen wie -w, Dateinamen, Rechner-Namen) lehnt der Agent ab; der Filter wird nie über eine Shell ausgeführt.
  • Promiscuous ist standardmäßig aus – du siehst den Verkehr von und zur Firewall sowie den, den sie routet.
  • Löschen: Nach dem Herunterladen löscht Control die Datei sofort von der Firewall. Spätestens eine Stunde nach dem Ende löscht der Agent sie selbst, auch nach einem Neustart des Agents. Mit Löschen geht es sofort.
  • Die Dateien liegen auf der Firewall unter /tmp/dz-capture-<ID>.pcap.

Rechte ​

RechtBereichStandard
Diagnose (opnsense.diagnostics)Interfaces, ARP/NDP, DHCP-LeasesOperator und Support, nicht Viewer
Firewall-Log durchsuchen (opnsense.firewall_log)Firewall-Lognur Admins oder ausdrücklich vergeben
Paketmitschnitt (opnsense.capture)Starten, Stoppen, Herunterladen, Löschennur Admins oder ausdrücklich vergeben

Firewall-Log und Mitschnitt enthalten Verbindungsdaten bzw. Inhalte des Kundenverkehrs. Diese Rechte kommen deshalb nie über „alle Unter-Reiter“ (*.subtabs) und stehen in keiner Standardrolle außer Administrator. Auch der Reiter Dateien hält sich daran: Ohne das jeweilige Recht sind /var/log/filter* und /tmp/dz-capture-* dort gesperrt (Herunterladen, ZIP des Elternordners, Umbenennen, Löschen, Hochladen) und beim Auflisten ausgeblendet. Kundengebundene Benutzer sehen nur Firewalls ihres Kunden. Im Audit-Log stehen jede Log-Suche (mit Filtern), jeder Start, jedes Stoppen und Löschen sowie jeder Download eines Mitschnitts. Der Reiter Diagnose erscheint, sobald eines der drei Rechte vorhanden ist; die Bereiche darin richten sich nach dem jeweiligen Recht.

Kontextmenue ​

Rechtsklick auf eine Firewall in der Tabelle bietet Schnellaktionen:

  • Details oeffnen - Detail-Panel anzeigen
  • WebUI oeffnen - OPNsense-Weboberflaeche im neuen Tab
  • Shell oeffnen - Remote-Terminal starten
  • Tunnel starten - Schnellzugriff auf Tunnel-Vorlagen
  • Update starten - Firmware-Update ausloesen
  • Script ausfuehren - Script aus der Bibliothek ausfuehren

Tunnel-Vorlagen ​

VorlageZielportBeschreibung
OPNsense WebUI443Zugriff auf die Weboberflaeche
Agent SSH22SSH ueber den Agent
SSH22Direkter SSH-Zugriff
VNC5900VNC-Fernzugriff
HTTP80HTTP-Weiterleitung
CustomFreiBeliebiger Port

Update-Zeitplaene und Update-Laeufe ​

Seit v3.7.0 laufen OPNsense-Updates als Update-Laeufe mit echter Nachpruefung - HA-Paare (CARP) werden rollierend aktualisiert: BACKUP zuerst, Health-Check, Settle-Zeit, dann der MASTER mit CARP-Maintenance (geplanter Failover). Details, Fehlerverhalten und Optionen: OPNsense HA-Updates.

TypBeschreibungReboot
System UpdateNur Pakete; Base/Kernel bleibt als Reboot ausstehend offennie
Update + RebootPakete + Base/Kernel, Reboot nur wenn OPNsense ihn verlangt; HA rollierendwenn noetig
Major UpgradeSprung fuer Sprung bis zur Zielversion oder Neueste (z. B. 23.7 → 26.7)zwei Reboots je Sprung

Die HA-Spalte der Firewall-Tabelle zeigt die CARP-Rolle (MASTER / BACKUP / MAINT / INIT) mit dem HA-Partner im Tooltip. Das Ergebnis jedes Laufs steht im Jobs-Tab (Banner, Status-Punkt, letzte Laeufe je Zeitplan, Lauf-Details mit Fortsetzen/Abbrechen).

Zeitplaene koennen einmalig oder wiederkehrend (taeglich, woechentlich, monatlich, Cron) konfiguriert werden. Siehe Update-Zeitplaene.

Weitere Aktionen ​

AktionBeschreibung
BackupKonfigurations-Backup (config.xml) erstellen
Config-SyncKonfiguration zwischen HA-Firewalls synchronisieren

DATAZONE Control Documentation