Firewall
Diese Seite beschreibt, wie COD Firewalls anbindet, welche Rechte und Einstellungen dafür nötig sind 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 | Firmware-Stand und Updates, Live-Zustand, Erreichbarkeit, VPN-Überblick (WireGuard, IPsec, OpenVPN), Aliase und Zonen, Zertifikate, Regeln (experimentell), Selbstanmeldung |
| Hersteller | AIMdefense, OPNsense, pfSense, DynFi |
| Verbindungen und Richtung | COD-Server zur Firewall: HTTPS-API und SSH. Für die Erreichbarkeit ICMP und TCP. Bei der Selbstanmeldung einmalig Firewall zu COD |
| Zugangsdaten | API-Key und API-Secret, SSH-Benutzer und Passwort, SSH-Port, optional das CA-Zertifikat der Firewall |
| Asset | eingebauter Asset-Typ „Firewall“ |
| Freigaben | Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt. |
Funktionen je Hersteller
| Funktion | AIMdefense | OPNsense | pfSense | DynFi |
|---|---|---|---|---|
| Status, Firmware, Aliase, VPN-Überblick | ja | ja | im Projekt klären | im Projekt klären |
| Zertifikatstabelle, Objektmigration, Alias-Import | ja | ja | nein | nein |
| Selbstanmeldung per Plugin | nein | ja | nein | nein |
| Captive Portal | nein | ja | nein | nein |
Voraussetzungen
An der Firewall
| Anforderung | Warum |
|---|---|
| API-Zugang mit API-Key und API-Secret | Status, Firmware, Aliase, VPN, Zertifikate |
| API-Benutzer mit Administratorrechten (empfohlen) | Mit eingeschränkten Rechten braucht der Benutzer für die Cluster-Darstellung in der Layer-3-Karte mindestens die OPNsense-Rechte „Interfaces: Virtual IPs: Status“ und „System: High Availability“. Die Mindestrechte erhalten Sie im Projekt. |
| SSH mit eigenem Benutzer für COD | Regeln, Konfiguration, Terminal |
| Zugriff auf API und SSH auf die Quelladresse des COD-Servers beschränkt | Alle Abfragen kommen vom COD-Server |
| Erreichbar per ICMP und TCP vom COD-Server | Erreichbarkeitsprüfung |
In COD
- Modul Firewall am Mandanten freigeschaltet.
- Eingebauter Asset-Typ „Firewall“ im Asset-Katalog. Ändern Sie seinen Namen nicht.
- Asset aktiviert, Hersteller gesetzt.
- Mail-Einstellung des Standorts, damit Ausfallmeldungen ankommen.
- Nutzt die Firewall ein Zertifikat aus eigener CA: das CA-Zertifikat in COD hinterlegt.
Einrichtung
Firewall von Hand anlegen
- Legen Sie an der Firewall den API-Benutzer und den SSH-Benutzer für COD an.
- Legen Sie in COD das Asset mit dem Typ „Firewall“ und dem Hersteller an. Aktivieren Sie es.
- Tragen Sie Adresse, API-Key, API-Secret, SSH-Benutzer, Passwort und SSH-Port ein. Bei eigener CA hinterlegen Sie das CA-Zertifikat.
- Prüfen Sie Status und Firmware-Stand in der Übersicht des Moduls.
Selbstanmeldung mit dem OPNsense-Plugin
Eine OPNsense kann sich über das COD-Plugin selbst bei COD anmelden. Den Bezug des Plugins klären Sie mit Ihrem Partner.
- Tragen Sie im Plugin die Adresse von COD ein.
- Melden Sie sich im Plugin mit einem COD-Benutzer, dessen Passwort und dem Einmalcode an.
- Wählen Sie den Standort.
- Wählen Sie den lokalen Benutzer der OPNsense, für den das Plugin einen API-Schlüssel erzeugt.
- Das Plugin sendet Management-Adresse, Port und Schlüssel einmalig an COD.
- Die Firewall erscheint in COD unter „Firewall > Pending“. Übernehmen Sie den Eintrag.
Hinweis: „Reject“ unter „Firewall > Pending“ löscht das Asset. Lehnen Sie nur ab, wenn das Asset weg soll.
Erreichbarkeitsprüfung
- Stellen Sie je Standort den Zeitplan der Prüfung ein (Cron, Vorgabe jede Minute).
- Tragen Sie die Empfänger der Ausfallmeldungen ein.
- Prüfen Sie, ob die Mail-Einstellung des Standorts funktioniert.
Die Prüfung arbeitet mit ICMP und einem TCP-Verbindungsaufbau zum API-Port der Firewall. Ein Throttling je Firewall verhindert wiederholte Mails zum selben Problem.
Technische Details
| Merkmal | Wert |
|---|---|
| Anbindung | HTTPS-API der Firewall. SSH für Regeln, Konfiguration und Terminal |
| Erreichbarkeit | ICMP und TCP vom COD-Server, Zeitplan je Standort, Mail mit Throttling je Firewall |
| VPN | WireGuard, OpenVPN und IPsec über alle Standorte in Tabellen und in einer Topologie-Sicht |
| Aliase und Zonen | zentrale Pflege von Aliasen (IPs, Netze, Ports). Zonen verteilen neue Aliase auf alle Firewalls der Zone. Ein Referenz-Check verhindert das Löschen verwendeter Objekte |
| Layer-3-Karte | Firewalls erscheinen als Knoten, CARP-Paare als Kasten |
| Terminal | SSH-Sitzung im Browser, aufgebaut vom COD-Server |
| Asset | Der Tab „References“ zeigt Firewall-Eintrag, Zabbix-Host, Voucher-Konfiguration und Aufgaben |
Wie schnell meldet COD einen Ausfall
Das hängt vom Zeitplan ab, den Sie je Standort einstellen. Aktiv per Mail gemeldet wird die Erreichbarkeit der Firewall. Den Zustand der VPN-Tunnel sehen Sie in den Tabellen und in der Topologie-Sicht. Alarme aus Ihrer Überwachung kommen von Zabbix. Siehe Monitoring.
Konfigurationssicherung
Das Modul Firewall sichert keine Konfigurationen. Das übernimmt das Modul Backup. Wählen Sie dort eine Firewall aus dem Inventar, füllt COD Adresse und Zugangsdaten einmalig vor.
Bekannte Grenzen
| Grenze | Was Sie tun können |
|---|---|
| Der Regeleditor ist experimentell. Er arbeitet per SSH, ein Fehler beim Anwenden kann eine Firewall offline nehmen | Pflegen Sie Regeln in der Oberfläche der Firewall. Nutzen Sie in COD Aliase und Zonen |
| Die Update-Knöpfe fragen nicht nach | Klicken Sie nur im Wartungsfenster und nach einer aktuellen Sicherung |
| „Reject“ unter „Firewall > Pending“ löscht das Asset | Lehnen Sie nur ab, wenn das Asset weg soll |
| Für VPN-Tunnel gibt es keine Ausfallmeldung | Überwachen Sie Tunnel in Zabbix |
| Der eingebaute Asset-Typ „Firewall“ darf nicht umbenannt werden | Behalten Sie den Namen im Asset-Katalog bei |
| Selbstanmeldung und Captive Portal nur für OPNsense | Andere Firewalls legen Sie von Hand an |
| Zertifikatstabelle, Objektmigration und Alias-Import nur für AIMdefense und OPNsense | Pflegen Sie diese Punkte bei pfSense und DynFi in der Firewall selbst |
| Funktionsumfang für pfSense und DynFi | Den Umfang für Ihre Firewalls klären Sie im Projekt. |
| Mindestrechte des API-Benutzers | Die Mindestrechte erhalten Sie im Projekt. |
Weiterführend
- Modulseite Firewall
- Captive Portal
- Was Ihr Netz für Firewall und Captive Portal braucht
- Netzwerk und MikroTik: Layer-3-Karte
- Fehlerbilder
- Fragen zu den Modulen
- Support: Zuerst hilft Ihr Partner. Technische Rückfragen an extocode stellen Sie über das Helpdesk-Formular.