Zum Inhalt springen
  •  +49 (861) 88 00 32 00
COD powered by extocode GmbH
  • 0
  • Anmelden
  • English (US) Français Deutsch Español Türkçe
  • Demo öffnen
  • Home
  • COD Überblick
    Plattform
    ÜberblickPlattform: Mandanten und MarkeFunktionsübersichtProbleme & LösungenArchitekturDokumentationIntegrationenPreise
    Betrieb & Netzwerk
    MonitoringNetzwerkNetwork Access Control (NAC)TACACS+Captive PortalFirewall
    Sicherheit & Resilienz
    Governance, Risk & ComplianceBackupHypervisorOTPPasskeeprAutomatisierung
    Lösungen & Mehr
    NIS2 & CompliancecodPassKI-Dokumentation (Zusatzmodul InfraScan)Demo öffnenReferenzenDownloadsFAQ
  • Preise
  • Neuigkeiten
    • Blog
    • Roadmap
  • FAQ
  • Über uns
    • Über uns
    • Karriere
    • Partner
    • Referenzen
  • Academy
  • Kontakt
COD powered by extocode GmbH
  • 0
    • Home
    • COD Überblick
    • Preise
    • Neuigkeiten
      • Blog
      • Roadmap
    • FAQ
    • Über uns
      • Über uns
      • Karriere
      • Partner
      • Referenzen
    • Academy
    • Kontakt
  •  +49 (861) 88 00 32 00
  • English (US) Français Deutsch Español Türkçe
  • Anmelden
  • Demo öffnen
  1. Start
  2. Dokumentation
  3. Module
  4. Firewall

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

MerkmalWert
ZweckFirmware-Stand und Updates, Live-Zustand, Erreichbarkeit, VPN-Überblick (WireGuard, IPsec, OpenVPN), Aliase und Zonen, Zertifikate, Regeln (experimentell), Selbstanmeldung
HerstellerAIMdefense, OPNsense, pfSense, DynFi
Verbindungen und RichtungCOD-Server zur Firewall: HTTPS-API und SSH. Für die Erreichbarkeit ICMP und TCP. Bei der Selbstanmeldung einmalig Firewall zu COD
ZugangsdatenAPI-Key und API-Secret, SSH-Benutzer und Passwort, SSH-Port, optional das CA-Zertifikat der Firewall
Asseteingebauter Asset-Typ „Firewall“
FreigabenDie Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.

Funktionen je Hersteller

FunktionAIMdefenseOPNsensepfSenseDynFi
Status, Firmware, Aliase, VPN-Überblickjajaim Projekt klärenim Projekt klären
Zertifikatstabelle, Objektmigration, Alias-Importjajaneinnein
Selbstanmeldung per Pluginneinjaneinnein
Captive Portalneinjaneinnein

Voraussetzungen

An der Firewall

AnforderungWarum
API-Zugang mit API-Key und API-SecretStatus, 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 CODRegeln, Konfiguration, Terminal
Zugriff auf API und SSH auf die Quelladresse des COD-Servers beschränktAlle Abfragen kommen vom COD-Server
Erreichbar per ICMP und TCP vom COD-ServerErreichbarkeitsprü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

  1. Legen Sie an der Firewall den API-Benutzer und den SSH-Benutzer für COD an.
  2. Legen Sie in COD das Asset mit dem Typ „Firewall“ und dem Hersteller an. Aktivieren Sie es.
  3. Tragen Sie Adresse, API-Key, API-Secret, SSH-Benutzer, Passwort und SSH-Port ein. Bei eigener CA hinterlegen Sie das CA-Zertifikat.
  4. 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.

  1. Tragen Sie im Plugin die Adresse von COD ein.
  2. Melden Sie sich im Plugin mit einem COD-Benutzer, dessen Passwort und dem Einmalcode an.
  3. Wählen Sie den Standort.
  4. Wählen Sie den lokalen Benutzer der OPNsense, für den das Plugin einen API-Schlüssel erzeugt.
  5. Das Plugin sendet Management-Adresse, Port und Schlüssel einmalig an COD.
  6. 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

  1. Stellen Sie je Standort den Zeitplan der Prüfung ein (Cron, Vorgabe jede Minute).
  2. Tragen Sie die Empfänger der Ausfallmeldungen ein.
  3. 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

MerkmalWert
AnbindungHTTPS-API der Firewall. SSH für Regeln, Konfiguration und Terminal
ErreichbarkeitICMP und TCP vom COD-Server, Zeitplan je Standort, Mail mit Throttling je Firewall
VPNWireGuard, OpenVPN und IPsec über alle Standorte in Tabellen und in einer Topologie-Sicht
Aliase und Zonenzentrale 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-KarteFirewalls erscheinen als Knoten, CARP-Paare als Kasten
TerminalSSH-Sitzung im Browser, aufgebaut vom COD-Server
AssetDer 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

GrenzeWas Sie tun können
Der Regeleditor ist experimentell. Er arbeitet per SSH, ein Fehler beim Anwenden kann eine Firewall offline nehmenPflegen Sie Regeln in der Oberfläche der Firewall. Nutzen Sie in COD Aliase und Zonen
Die Update-Knöpfe fragen nicht nachKlicken Sie nur im Wartungsfenster und nach einer aktuellen Sicherung
„Reject“ unter „Firewall > Pending“ löscht das AssetLehnen 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 werdenBehalten Sie den Namen im Asset-Katalog bei
Selbstanmeldung und Captive Portal nur für OPNsenseAndere Firewalls legen Sie von Hand an
Zertifikatstabelle, Objektmigration und Alias-Import nur für AIMdefense und OPNsensePflegen Sie diese Punkte bei pfSense und DynFi in der Firewall selbst
Funktionsumfang für pfSense und DynFiDen Umfang für Ihre Firewalls klären Sie im Projekt.
Mindestrechte des API-BenutzersDie 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.
← Zurück: TACACS+Weiter: Captive Portal →
Folgen Sie uns
​
  • COD Überblick
  • Funktionen
  • Demo
  • Preise
  • Integrationen
  • NIS2
  • codPass
  • Referenzen

Hilfe

  • FAQ
  • Dokumentation
  • Downloads
  • Kontakt

Kotzinger Straße 21 • 83278 Traunstein • Deutschland

  • ​+49 (861) 88 00 32 00
  • ​info@extocode.com
Datenschutz Impressum ​
Copyright © extocode GmbH
English (US) Français Deutsch Español Türkçe

Wir verwenden Cookies auf dieser Website, um Ihnen ein besseres Nutzererlebnis zu bieten. Datenschutz-Richtlinien

Ablehnen Zustimmen