Netzwerk-Firewall-Check-Referenz (Appliance)

Konfigurationsfelder, herstellerspezifische API-Oberflächen, Meldungscodes und unterstützte Plattformen für den Netzwerk-Firewall-Check in octoja.

Netzwerk-Firewall-Check-Referenz (Appliance)

Konfigurationsoptionen und Warnverhalten für den Netzwerk-Firewall-Check (Appliance).

Der Netzwerk-Firewall-Check prüft eine Perimeter-Firewall-Appliance auf Erreichbarkeit, Firmware-Aktualität, Lizenz-/Feature-Key-Ablauf und Sicherheitssignale. Standard-Intervall: 15 Minuten. Der Check unterstützt zehn Hersteller-Oberflächen (Check Point SNMP, FortiGate REST-API, FortiGate SNMP, OPNsense, Securepoint UTM SNMP, Sophos XG / XGS lokal, Sophos XG / XGS SNMP, WatchGuard REST, WatchGuard SNMP und SonicWall SNMP); die in der UI sichtbaren Felder hängen vom gewählten Hersteller ab. Die beiden FortiGate-Oberflächen sind verschieden: Die REST-API-Oberfläche meldet die installierte Firmware-Version und den FortiGuard-Lizenz-Ablauf, während die SNMP-Oberfläche Live-Messwerte liest (CPU, Speicher, Disk, Sessions, VPN-Tunnel, HA-Cluster-Knoten und Interfaces). Die SNMP-Oberflächen unterscheiden sich je Hersteller: WatchGuard (SNMP) liefert CPU, Interfaces und HA; SonicWall (SNMP) liefert CPU, RAM, Interfaces und VPN-Tunnel; Sophos XG / XGS (SNMP) liefert RAM, Disk, Interfaces und VPN-Tunnel; Securepoint UTM (SNMP) liefert CPU, RAM, Sessions, Interfaces, VPN-Tunnel (IPsec, OpenVPN und WireGuard), HA-Sync-Status und Lizenz-Ablauf; Check Point (SNMP) liefert CPU, RAM, Disk, Sessions, Interfaces, VPN-Tunnel, HA und Lizenz-Ablauf.

Hersteller-Matrix

Hersteller	API-Oberfläche	Auth	Erreichbarkeitsziel
FortiGate (REST-API)	FortiOS REST-API über HTTPS (Standard-Port 443)	REST-API-Token (`Authorization: Bearer`)	Appliance direkt
FortiGate (SNMP)	SNMP v2c / v3 (Standard-UDP-Port 161; FORTINET-FORTIGATE-MIB + IF-MIB)	v2c-Community-String oder SNMPv3-Benutzer mit Auth + Privacy	Appliance direkt
OPNsense	OPNsense REST (`/api/core/firmware/*`)	HTTP-Basic mit API-Key + Secret	Appliance direkt
Sophos XG / XGS (lokal)	Sophos XML-API (`/webconsole/APIController`, Port 4444)	Benutzername + Passwort im XML-Request-Body	Appliance direkt
WatchGuard (REST)	WatchGuard Cloud REST (`/rest/platform/allocation/v2/`, `/rest/threatsync/management/v1/`)	OAuth2 client_credentials + `WatchGuard-API-Key`-Header	Regionaler WatchGuard-Cloud-Endpunkt
WatchGuard (SNMP)	SNMP v2c / v3 (Standard-UDP-Port 161)	v2c-Community-String oder SNMPv3-Benutzer mit Auth + Privacy	Appliance direkt
SonicWall (SNMP)	SNMP v2c / v3 (Standard-UDP-Port 161)	v2c-Community-String oder SNMPv3-Benutzer mit Auth + Privacy	Appliance direkt
Sophos XG / XGS (SNMP)	SNMP v2c / v3 (Standard-UDP-Port 161; SOPHOS-XG-MIB + IF-MIB)	v2c-Community-String oder SNMPv3-Benutzer mit Auth + Privacy	Appliance direkt
Securepoint UTM (SNMP)	SNMP v2c / v3 (Standard-UDP-Port 161; SECUREPOINT-MIB + UCD-SNMP-MIB + IF-MIB)	v2c-Community-String oder SNMPv3-Benutzer mit Auth + Privacy	Appliance direkt
Check Point (SNMP)	SNMP v2c / v3 (Standard-UDP-Port 161; CHECKPOINT-MIB + IF-MIB)	v2c-Community-String oder SNMPv3-Benutzer mit Auth + Privacy	Appliance direkt

Konfigurationsfelder

Gemeinsame Felder gelten herstellerübergreifend; die übrigen werden eingeblendet, wenn der passende Hersteller ausgewählt ist.

Gemeinsam

Feld	Typ	Erforderlich	Standard	Beschreibung
Hersteller	select	Ja	OPNsense	Wählt die zu prüfende Appliance-Oberfläche. Bestimmt, welche Felder angezeigt werden. Optionen: Check Point (SNMP), FortiGate (REST-API), FortiGate (SNMP), OPNsense, Securepoint UTM (SNMP), Sophos XG / XGS (lokal), Sophos XG / XGS (SNMP), WatchGuard (REST), WatchGuard (SNMP), SonicWall (SNMP)
TLS-Zertifikat prüfen	boolean	Nein	false	TLS-Zertifikat der Appliance validieren. Standardmäßig aus, weil Appliances meist ein selbstsigniertes Zertifikat präsentieren. Wird bei WatchGuard (REST), WatchGuard (SNMP), FortiGate (SNMP), SonicWall (SNMP), Sophos XG / XGS (SNMP), Securepoint UTM (SNMP) oder Check Point (SNMP) nicht angezeigt — diese Cloud- und SNMP-Verbindungen nutzen TLS nicht auf diese Weise

OPNsense

Feld	Typ	Erforderlich	Standard	Beschreibung
Host / IP	string	Ja	—	Management-Hostname oder IP (ohne Schema)
API-Port	number	Nein	443	HTTPS-Management-/API-Port. OPNsense erlaubt, die GUI von 443 wegzulegen
API-Key	password	Ja	—	OPNsense-API-Key
API-Secret	password	Ja	—	OPNsense-API-Secret

WatchGuard (REST)

Feld	Typ	Erforderlich	Standard	Beschreibung
Region-Basis-URL	string	Nein	https://api.deu.cloud.watchguard.com	Regionale WatchGuard-Cloud-Basis-URL. EU = `deu`, USA = `usa`
WatchGuard-API-Key	password	Ja	—	API-Key aus WatchGuard Cloud Managed Access
Client-ID (Read-only-Zugang)	string	Ja	—	OAuth2-Client-ID
Client-Secret	password	Ja	—	OAuth2-Client-Secret
Account-ID	string	Ja	—	Account-Identifikator in den WatchGuard-API-Pfaden (`WGC-1-…` oder `ACC-…`)
Soll-Fireware-Version	string	Nein	—	Setzen, um Aktualität zu prüfen. Leer = Dimension überspringen (die Cloud-API liefert latest nicht zuverlässig)
Lizenz-Warnung (Tage)	number	Nein	30	Feature-Key/Lizenz, die innerhalb dieser Tage abläuft, löst eine Warnung aus

Sophos XG / XGS (lokal)

Feld	Typ	Erforderlich	Standard	Beschreibung
Host / IP	string	Ja	—	Hostname oder IP der Appliance
API-Port	number	Nein	4444	Sophos-XML-API-Port
Admin-Benutzer	string	Ja	—	Sophos-Admin-Benutzer mit API-Zugriff
Admin-Passwort	password	Ja	—	Passwort des Admin-Benutzers
Soll-Firmware-Version	string	Nein	—	Vergleich gegen diese Version (z. B. `21.0.0 GA`). Leer = Aktualitäts-Dimension überspringen. Die lokale Sophos-API meldet die neueste verfügbare Version nicht

FortiGate (REST-API)

Feld	Typ	Erforderlich	Standard	Beschreibung
Host / IP	string	Ja	—	Hostname oder IP der Appliance
Verwaltungs-Port	number	Nein	443	HTTPS-Verwaltungs-Port. FortiGate-Admin-Zugang wird häufig von 443 weggelegt
REST-API-Token	password	Ja	—	Token eines Nur-Lese-REST-API-Administrators (System > Administratoren), gesendet als `Authorization: Bearer`
Lizenz-Warnung (Tage)	number	Nein	30	Feature-Key/Lizenz, die innerhalb dieser Tage abläuft, löst eine Warnung aus

FortiGate (SNMP)

Die SNMP-Oberfläche fragt die FortiGate per SNMP nach Live-Messwerten ab. Die Schwellwert-, Interface-, VPN- und HA-Felder unten sind nur für diesen Hersteller sichtbar.

Feld	Typ	Erforderlich	Standard	Beschreibung
Host / IP	string	Ja	—	Hostname oder IP der Appliance
SNMP-Version	select	Nein	v2c	SNMP-Protokollversion. Optionen: `v2c`, `v3`
SNMP-Port	number	Nein	161	UDP-Port für SNMP
Community (v2c)	string	Nein	public	Lese-Community-String. Wird angezeigt, wenn die SNMP-Version `v2c` ist
SNMPv3-Benutzer	string	Nein	—	SNMPv3-Benutzername. Wird angezeigt, wenn die SNMP-Version `v3` ist
Auth-Protokoll (v3)	select	Nein	SHA-1	SNMPv3-Authentifizierungsprotokoll. Optionen: `Keine`, `SHA-1`, `SHA-256`. Wird angezeigt, wenn die SNMP-Version `v3` ist
Auth-Passwort (v3)	password	Nein	—	Authentifizierungs-Passwort. Wird angezeigt, wenn das Auth-Protokoll nicht `Keine` ist
Privacy-Protokoll (v3)	select	Nein	AES-128	SNMPv3-Verschlüsselungsprotokoll. Optionen: `Keine`, `AES-128`, `AES-192`, `AES-256`. Wird angezeigt, wenn das Auth-Protokoll nicht `Keine` ist
Privacy-Passwort (v3)	password	Nein	—	Privacy-Passwort. Wird angezeigt, wenn das Privacy-Protokoll nicht `Keine` ist
CPU-Warnung (%)	number	Nein	85	CPU-Auslastung auf oder über diesem Wert löst eine Warnung aus
CPU-Kritisch (%)	number	Nein	95	CPU-Auslastung auf oder über diesem Wert löst Critical aus
RAM-Warnung (%)	number	Nein	85	Speicherauslastung auf oder über diesem Wert löst eine Warnung aus
RAM-Kritisch (%)	number	Nein	95	Speicherauslastung auf oder über diesem Wert löst Critical aus
Disk-Warnung (%)	number	Nein	85	Disk-Auslastung auf oder über diesem Wert löst eine Warnung aus
Disk-Kritisch (%)	number	Nein	95	Disk-Auslastung auf oder über diesem Wert löst Critical aus
Interfaces einbeziehen (IF-MIB)	boolean	Nein	true	Interface-Status und In-/Out-Fehlerzähler erfassen
Interfaces, die up sein müssen	array	Nein	—	Namen, ausgewählt aus den beim letzten Lauf erkannten Interfaces. Ist eines betrieblich down, wird Critical gemeldet. Wird angezeigt, wenn Interfaces einbezogen sind
Warnen, wenn ein Interface down ist	boolean	Nein	false	Warnen, wenn ein admin-up Interface betrieblich down ist. Wird angezeigt, wenn Interfaces einbezogen sind
VPN-Tunnel einbeziehen	boolean	Nein	true	VPN-Tunnel-Status erfassen
VPN-Tunnel, die up sein müssen	array	Nein	—	Namen, ausgewählt aus den beim letzten Lauf erkannten Tunneln. Ist einer down/fehlend, wird Critical gemeldet. Wird angezeigt, wenn VPN-Tunnel einbezogen sind
Warnen, wenn ein VPN-Tunnel down ist	boolean	Nein	false	Warnen, wenn ein erkannter Tunnel down ist. Wird angezeigt, wenn VPN-Tunnel einbezogen sind
HA einbeziehen	boolean	Nein	true	HA-Cluster-Knoten-Informationen erfassen
HA Soll-Cluster-Knoten (0 = aus)	number	Nein	0	Critical, wenn weniger HA-Cluster-Knoten sichtbar sind als dieser Wert (ausgefallener Peer). 0 = HA-Alarm aus. Wird angezeigt, wenn HA einbezogen ist

WatchGuard (SNMP)

Die SNMP-Oberfläche fragt eine WatchGuard-Firebox direkt per SNMP ab. Die Oberfläche verwendet dieselben SNMP-Verbindungsfelder wie FortiGate (SNMP), zusätzlich die CPU-, Interface- und HA-Felder unten. RAM-, Disk- und VPN-Messwerte werden auf dieser Oberfläche nicht erfasst.

Feld	Typ	Erforderlich	Standard	Beschreibung
Host / IP	string	Ja	—	Hostname oder IP der Appliance
SNMP-Version / -Port / -Zugangsdaten	group	Nein	v2c, 161	Dieselben SNMP-Verbindungsfelder wie FortiGate (SNMP): Version (`v2c` / `v3`), Port, v2c-Community sowie SNMPv3-Benutzer / Auth-Protokoll / Auth-Passwort / Privacy-Protokoll / Privacy-Passwort
CPU-Warnung (%)	number	Nein	85	CPU-Auslastung auf oder über diesem Wert löst eine Warnung aus
CPU-Kritisch (%)	number	Nein	95	CPU-Auslastung auf oder über diesem Wert löst Critical aus
Interfaces einbeziehen (IF-MIB)	boolean	Nein	true	Interface-Status und In-/Out-Fehlerzähler erfassen
Interfaces, die up sein müssen	array	Nein	—	Namen, ausgewählt aus den beim letzten Lauf erkannten Interfaces. Ist eines betrieblich down, wird Critical gemeldet. Wird angezeigt, wenn Interfaces einbezogen sind
Warnen, wenn ein Interface down ist	boolean	Nein	false	Warnen, wenn ein admin-up Interface betrieblich down ist. Wird angezeigt, wenn Interfaces einbezogen sind
HA einbeziehen	boolean	Nein	true	HA-Cluster-Knoten-Informationen erfassen
HA Soll-Cluster-Knoten (0 = aus)	number	Nein	0	Critical, wenn weniger HA-Cluster-Knoten sichtbar sind als dieser Wert. 0 = HA-Alarm aus. Wird angezeigt, wenn HA einbezogen ist
Soll-Fireware-Version	string	Nein	—	Setzen, um Aktualität gegen diese Version zu prüfen. Leer = Aktualitäts-Dimension überspringen
Lizenz-Warnung (Tage)	number	Nein	30	Feature-Key/Lizenz, die innerhalb dieser Tage abläuft, löst eine Warnung aus

SonicWall (SNMP)

Die SNMP-Oberfläche fragt eine SonicWall-Appliance direkt per SNMP ab. Die Oberfläche verwendet dieselben SNMP-Verbindungsfelder wie FortiGate (SNMP), zusätzlich die CPU-, RAM-, Interface- und VPN-Felder unten. Disk- und HA-Messwerte werden auf dieser Oberfläche nicht erfasst.

Feld	Typ	Erforderlich	Standard	Beschreibung
Host / IP	string	Ja	—	Hostname oder IP der Appliance
SNMP-Version / -Port / -Zugangsdaten	group	Nein	v2c, 161	Dieselben SNMP-Verbindungsfelder wie FortiGate (SNMP): Version (`v2c` / `v3`), Port, v2c-Community sowie SNMPv3-Benutzer / Auth-Protokoll / Auth-Passwort / Privacy-Protokoll / Privacy-Passwort
CPU-Warnung (%)	number	Nein	85	CPU-Auslastung auf oder über diesem Wert löst eine Warnung aus
CPU-Kritisch (%)	number	Nein	95	CPU-Auslastung auf oder über diesem Wert löst Critical aus
RAM-Warnung (%)	number	Nein	85	Speicherauslastung auf oder über diesem Wert löst eine Warnung aus
RAM-Kritisch (%)	number	Nein	95	Speicherauslastung auf oder über diesem Wert löst Critical aus
Interfaces einbeziehen (IF-MIB)	boolean	Nein	true	Interface-Status und In-/Out-Fehlerzähler erfassen
Interfaces, die up sein müssen	array	Nein	—	Namen, ausgewählt aus den beim letzten Lauf erkannten Interfaces. Ist eines betrieblich down, wird Critical gemeldet. Wird angezeigt, wenn Interfaces einbezogen sind
Warnen, wenn ein Interface down ist	boolean	Nein	false	Warnen, wenn ein admin-up Interface betrieblich down ist. Wird angezeigt, wenn Interfaces einbezogen sind
VPN-Tunnel einbeziehen	boolean	Nein	true	VPN-Tunnel-Status erfassen
VPN-Tunnel, die up sein müssen	array	Nein	—	Namen, ausgewählt aus den beim letzten Lauf erkannten Tunneln. Ist einer down/fehlend, wird Critical gemeldet. Wird angezeigt, wenn VPN-Tunnel einbezogen sind
Soll-SonicOS-Version	string	Nein	—	Setzen, um Aktualität gegen diese Version zu prüfen. Leer = Aktualitäts-Dimension überspringen

Sophos XG / XGS (SNMP)

Die SNMP-Oberfläche fragt eine Sophos-XG-/XGS-Appliance direkt per SNMP ab. Die Oberfläche verwendet dieselben SNMP-Verbindungsfelder wie FortiGate (SNMP), zusätzlich die RAM-, Disk-, Interface- und VPN-Felder unten. Die SOPHOS-XG-MIB stellt kein CPU-Objekt bereit, daher werden CPU- und HA-Messwerte auf dieser Oberfläche nicht erfasst.

Feld	Typ	Erforderlich	Standard	Beschreibung
Host / IP	string	Ja	—	Hostname oder IP der Appliance
SNMP-Version / -Port / -Zugangsdaten	group	Nein	v2c, 161	Dieselben SNMP-Verbindungsfelder wie FortiGate (SNMP): Version (`v2c` / `v3`), Port, v2c-Community sowie SNMPv3-Benutzer / Auth-Protokoll / Auth-Passwort / Privacy-Protokoll / Privacy-Passwort
RAM-Warnung (%)	number	Nein	85	Speicherauslastung auf oder über diesem Wert löst eine Warnung aus
RAM-Kritisch (%)	number	Nein	95	Speicherauslastung auf oder über diesem Wert löst Critical aus
Disk-Warnung (%)	number	Nein	85	Disk-Auslastung auf oder über diesem Wert löst eine Warnung aus
Disk-Kritisch (%)	number	Nein	95	Disk-Auslastung auf oder über diesem Wert löst Critical aus
Interfaces einbeziehen (IF-MIB)	boolean	Nein	true	Interface-Status und In-/Out-Fehlerzähler erfassen
Interfaces, die up sein müssen	array	Nein	—	Namen, ausgewählt aus den beim letzten Lauf erkannten Interfaces. Ist eines betrieblich down, wird Critical gemeldet. Wird angezeigt, wenn Interfaces einbezogen sind
Warnen, wenn ein Interface down ist	boolean	Nein	false	Warnen, wenn ein admin-up Interface betrieblich down ist. Wird angezeigt, wenn Interfaces einbezogen sind
VPN-Tunnel einbeziehen	boolean	Nein	true	VPN-Tunnel-Status erfassen
VPN-Tunnel, die up sein müssen	array	Nein	—	Namen, ausgewählt aus den beim letzten Lauf erkannten Tunneln. Ist einer down/fehlend, wird Critical gemeldet. Wird angezeigt, wenn VPN-Tunnel einbezogen sind
Warnen, wenn ein VPN-Tunnel down ist	boolean	Nein	false	Warnen, wenn ein erkannter Tunnel down ist. Wird angezeigt, wenn VPN-Tunnel einbezogen sind
Soll-Firmware-Version	string	Nein	—	Vergleich gegen diese Version (z. B. `21.0.0 GA`). Leer = Aktualitäts-Dimension überspringen. Wird mit der lokalen Sophos-Oberfläche geteilt

Securepoint UTM (SNMP)

Die SNMP-Oberfläche fragt eine Securepoint UTM direkt per SNMP ab. Die Oberfläche verwendet dieselben SNMP-Verbindungsfelder wie FortiGate (SNMP), zusätzlich die CPU-, RAM-, Interface-, VPN- und HA-Felder unten. Disk-Messwerte werden auf dieser Oberfläche nicht erfasst, und es wird keine Soll-Version konfiguriert — die Appliance meldet das verfügbare Update selbst.

Feld	Typ	Erforderlich	Standard	Beschreibung
Host / IP	string	Ja	—	Hostname oder IP der Appliance
SNMP-Version / -Port / -Zugangsdaten	group	Nein	v2c, 161	Dieselben SNMP-Verbindungsfelder wie FortiGate (SNMP): Version (`v2c` / `v3`), Port, v2c-Community sowie SNMPv3-Benutzer / Auth-Protokoll / Auth-Passwort / Privacy-Protokoll / Privacy-Passwort
CPU-Warnung (%)	number	Nein	85	CPU-Auslastung auf oder über diesem Wert löst eine Warnung aus
CPU-Kritisch (%)	number	Nein	95	CPU-Auslastung auf oder über diesem Wert löst Critical aus
RAM-Warnung (%)	number	Nein	85	Speicherauslastung auf oder über diesem Wert löst eine Warnung aus
RAM-Kritisch (%)	number	Nein	95	Speicherauslastung auf oder über diesem Wert löst Critical aus
Interfaces einbeziehen (IF-MIB)	boolean	Nein	true	Interface-Status und In-/Out-Fehlerzähler erfassen
Interfaces, die up sein müssen	array	Nein	—	Namen, ausgewählt aus den beim letzten Lauf erkannten Interfaces. Ist eines betrieblich down, wird Critical gemeldet. Wird angezeigt, wenn Interfaces einbezogen sind
Warnen, wenn ein Interface down ist	boolean	Nein	false	Warnen, wenn ein admin-up Interface betrieblich down ist. Wird angezeigt, wenn Interfaces einbezogen sind
VPN-Tunnel einbeziehen	boolean	Nein	true	VPN-Tunnel-Status erfassen
VPN-Tunnel, die up sein müssen	array	Nein	—	Namen, ausgewählt aus den beim letzten Lauf erkannten Tunneln. Ist einer down/fehlend, wird Critical gemeldet. Wird angezeigt, wenn VPN-Tunnel einbezogen sind
Warnen, wenn ein VPN-Tunnel down ist	boolean	Nein	false	Warnen, wenn ein erkannter Tunnel down ist. Wird angezeigt, wenn VPN-Tunnel einbezogen sind
HA einbeziehen	boolean	Nein	true	Cluster-Zustand und Sync-Status erfassen. Ein nicht synchronisierter Cluster löst eine Warnung aus, ein Fehlerzustand löst Critical aus
Lizenz-Warnung (Tage)	number	Nein	30	Feature-Key/Lizenz, die innerhalb dieser Tage abläuft, löst eine Warnung aus

Check Point (SNMP)

Die SNMP-Oberfläche fragt ein Check-Point-Gateway direkt per SNMP ab. Die Oberfläche verwendet dieselben SNMP-Verbindungsfelder wie FortiGate (SNMP), zusätzlich die CPU-, RAM-, Disk-, Interface-, VPN- und HA-Felder unten.

Feld	Typ	Erforderlich	Standard	Beschreibung
Host / IP	string	Ja	—	Hostname oder IP der Appliance
SNMP-Version / -Port / -Zugangsdaten	group	Nein	v2c, 161	Dieselben SNMP-Verbindungsfelder wie FortiGate (SNMP): Version (`v2c` / `v3`), Port, v2c-Community sowie SNMPv3-Benutzer / Auth-Protokoll / Auth-Passwort / Privacy-Protokoll / Privacy-Passwort
CPU-Warnung (%)	number	Nein	85	CPU-Auslastung auf oder über diesem Wert löst eine Warnung aus
CPU-Kritisch (%)	number	Nein	95	CPU-Auslastung auf oder über diesem Wert löst Critical aus
RAM-Warnung (%)	number	Nein	85	Speicherauslastung auf oder über diesem Wert löst eine Warnung aus
RAM-Kritisch (%)	number	Nein	95	Speicherauslastung auf oder über diesem Wert löst Critical aus
Disk-Warnung (%)	number	Nein	85	Disk-Auslastung auf oder über diesem Wert löst eine Warnung aus
Disk-Kritisch (%)	number	Nein	95	Disk-Auslastung auf oder über diesem Wert löst Critical aus
Interfaces einbeziehen (IF-MIB)	boolean	Nein	true	Interface-Status und In-/Out-Fehlerzähler erfassen
Interfaces, die up sein müssen	array	Nein	—	Namen, ausgewählt aus den beim letzten Lauf erkannten Interfaces. Ist eines betrieblich down, wird Critical gemeldet. Wird angezeigt, wenn Interfaces einbezogen sind
Warnen, wenn ein Interface down ist	boolean	Nein	false	Warnen, wenn ein admin-up Interface betrieblich down ist. Wird angezeigt, wenn Interfaces einbezogen sind
VPN-Tunnel einbeziehen	boolean	Nein	true	VPN-Tunnel-Status erfassen
VPN-Tunnel, die up sein müssen	array	Nein	—	Namen, ausgewählt aus den beim letzten Lauf erkannten Tunneln. Ist einer down/fehlend, wird Critical gemeldet. Wird angezeigt, wenn VPN-Tunnel einbezogen sind
Warnen, wenn ein VPN-Tunnel down ist	boolean	Nein	false	Warnen, wenn ein erkannter Tunnel down ist. Wird angezeigt, wenn VPN-Tunnel einbezogen sind
HA einbeziehen	boolean	Nein	true	ClusterXL-Status erfassen. Ein von null abweichender HA-Status löst eine Warnung aus, der Zustand `down` löst Critical aus
Soll-Gaia-Version	string	Nein	—	Setzen, um Aktualität gegen diese Version zu prüfen (z. B. `R81.20`). Leer = Aktualitäts-Dimension überspringen
Lizenz-Warnung (Tage)	number	Nein	30	Feature-Key/Lizenz, die innerhalb dieser Tage abläuft, löst eine Warnung aus

Meldungscodes

Der Check meldet eine Liste von Problem-Zeilen; der schlechteste Schweregrad wird zum Gesamtergebnis.

Code	Hersteller	Schweregrad	Bedeutung
`offline`	Alle	Kritisch	Appliance nicht erreichbar oder eine Firebox im Account ist getrennt
`outdated`	OPNsense, Sophos, WatchGuard, SonicWall (SNMP), Securepoint UTM (SNMP), Check Point (SNMP)	Warnung	Aktuelle Firmware passt nicht zu latest/target. Detail = `current → target`
`pending-updates`	OPNsense	Warnung	Aktuell, aber der Upgrade-Mirror hat ausstehende Paket-Updates. Detail = Anzahl
`needs-reboot`	OPNsense	Warnung	OPNsense markiert einen ausstehenden Neustart
`update-check-unavailable`	OPNsense	Warnung	Upgrade-Mirror nicht erreichbar; das Aktualitätsverdikt oben ist unzuverlässig. Detail = Verbindungsstatus
`gateway-down`	Sophos	Warnung	Sophos-Device-Info-Gateway-Status ist nicht True. Detail = gemeldeter Status
`no-devices`	WatchGuard	Warnung	WatchGuard-Cloud-Inventar lieferte keine Fireboxes für den Account
`license-expired`	WatchGuard, Securepoint UTM (SNMP), Check Point (SNMP)	Kritisch	Nächster Feature-Key-/Abonnement-Ablauf liegt in der Vergangenheit. Detail = Tage seit Ablauf
`license-expiring`	WatchGuard, FortiGate (REST-API), Securepoint UTM (SNMP), Check Point (SNMP)	Warnung	Nächster Feature-Key-/Abonnement-Ablauf liegt im Warnfenster. Detail = verbleibende Tage
`open-incidents`	WatchGuard	Kritisch	ThreatSync meldet offene Bedrohungsvorfälle. Detail = Anzahl
`cpu-high`	Alle SNMP-Oberflächen außer Sophos XG / XGS (SNMP)	Warnung / Kritisch	CPU-Auslastung hat den Warn- oder Kritisch-Schwellwert erreicht. Detail = `Wert% / Schwellwert%`
`ram-high`	Alle SNMP-Oberflächen außer WatchGuard (SNMP)	Warnung / Kritisch	Speicherauslastung hat den Warn- oder Kritisch-Schwellwert erreicht. Detail = `Wert% / Schwellwert%`
`disk-high`	FortiGate (SNMP), Sophos XG / XGS (SNMP), Check Point (SNMP)	Warnung / Kritisch	Disk-Auslastung hat den Warn- oder Kritisch-Schwellwert erreicht. Detail = `Wert% / Schwellwert%`
`vpn-required-down`	FortiGate (SNMP), Sophos XG / XGS (SNMP), Securepoint UTM (SNMP), Check Point (SNMP)	Kritisch	Ein unter VPN-Tunnel, die up sein müssen gelisteter Tunnel ist down. Detail = Tunnel-Name
`vpn-required-missing`	FortiGate (SNMP), SonicWall (SNMP), Sophos XG / XGS (SNMP), Securepoint UTM (SNMP), Check Point (SNMP)	Kritisch	Ein unter VPN-Tunnel, die up sein müssen gelisteter Tunnel wurde nicht gefunden. Detail = Tunnel-Name
`vpn-any-down`	FortiGate (SNMP), Sophos XG / XGS (SNMP), Securepoint UTM (SNMP), Check Point (SNMP)	Warnung	Einer oder mehrere erkannte Tunnel sind down (wenn Warnen, wenn ein VPN-Tunnel down ist aktiv ist). Detail = Tunnel-Namen
`if-required-down`	Alle SNMP-Oberflächen	Kritisch	Ein unter Interfaces, die up sein müssen gelistetes Interface ist betrieblich down. Detail = Interface-Name
`if-required-missing`	Alle SNMP-Oberflächen	Kritisch	Ein unter Interfaces, die up sein müssen gelistetes Interface wurde nicht gefunden. Detail = Interface-Name
`if-any-down`	Alle SNMP-Oberflächen	Warnung	Eines oder mehrere admin-up Interfaces sind betrieblich down (wenn Warnen, wenn ein Interface down ist aktiv ist). Detail = Interface-Namen
`ha-degraded`	FortiGate (SNMP), WatchGuard (SNMP), Securepoint UTM (SNMP), Check Point (SNMP)	Warnung / Kritisch	Weniger HA-Cluster-Knoten sichtbar als die erwartete Anzahl (FortiGate, WatchGuard — Kritisch, Detail = `sichtbar/erwartet`) oder der Cluster meldet einen beeinträchtigten Sync-/HA-Zustand (Securepoint UTM, Check Point — Kritisch bei Fehler- oder Down-Zustand, sonst Warnung; Detail = der gemeldete Zustand)
`health-not-ok`	Check Point (SNMP)	Warnung	Das Gateway meldet einen von null abweichenden Systemstatus. Detail = der gemeldete Statustext
`firmware-unknown`	Sophos, WatchGuard, SonicWall (SNMP), Check Point (SNMP)	Warnung	Eine Soll-Version ist konfiguriert, aber die aktuelle Firmware-Version konnte nicht gelesen werden. Detail = die konfigurierte Soll-Version

*outdated löst bei Sophos, WatchGuard, SonicWall (SNMP) und Check Point (SNMP) nur aus, wenn die passende Soll-Version konfiguriert ist. OPNsense und Securepoint UTM (SNMP) brauchen keine Soll-Version — die Appliance meldet das verfügbare Upgrade selbst. FortiGate (REST-API) meldet nur die installierte Firmware-Version, deshalb entfällt die Aktualitäts-Dimension auf dieser Oberfläche.

Fehlercodes

Wenn der Check selbst nicht laufen kann (fehlerhafte Konfiguration, Authentifizierungsfehler, nicht erreichbare API), meldet er statt Problem-Zeilen einen der folgenden Fehlercodes. Die Check-Detailansicht zeigt die passende Meldung.

Code	Bedeutung
`invalid-vendor`	Unbekannter oder nicht konfigurierter Hersteller
`check-failed`	Unerwarteter Fehler beim Ausführen des Checks
`opnsense-config-required`	OPNsense benötigt Host, API-Key und API-Secret
`opnsense-auth-failed`	OPNsense-Authentifizierung fehlgeschlagen (API-Key/Secret prüfen)
`sophos-config-required`	Sophos benötigt Host, Benutzername und Passwort
`sophos-auth-failed`	Sophos-Authentifizierung fehlgeschlagen (Benutzername/Passwort prüfen)
`sophos-unparseable`	Sophos lieferte eine nicht auswertbare Antwort
`sophos-no-deviceinfo`	Sophos-Antwort enthielt keine DeviceInfo (API-Benutzer hat evtl. keinen Zugriff)
`watchguard-config-required`	WatchGuard benötigt Basis-URL, API-Key, Client-ID/-Secret und Account-ID
`watchguard-token-failed`	WatchGuard-Token-Anfrage fehlgeschlagen
`watchguard-no-access-token`	WatchGuard-Token-Antwort enthielt kein Access-Token
`watchguard-unreachable`	WatchGuard-Cloud nicht erreichbar
`watchguard-auth-failed`	WatchGuard-Autorisierung fehlgeschlagen (API-Key / Account-ID prüfen)
`watchguard-listing-failed`	WatchGuard-Geräteliste fehlgeschlagen
`fortigate-config-required`	FortiGate benötigt Host und ein REST-API-Token
`fortigate-auth-failed`	FortiGate-Authentifizierung fehlgeschlagen (API-Token prüfen)
`fortigate-snmp-config-required`	FortiGate (SNMP) benötigt einen Host
`watchguard-snmp-config-required`	WatchGuard (SNMP) benötigt einen Host
`sonicwall-snmp-config-required`	SonicWall (SNMP) benötigt einen Host
`sophos-snmp-config-required`	Sophos (SNMP) benötigt einen Host
`securepoint-snmp-config-required`	Securepoint (SNMP) benötigt einen Host
`checkpoint-snmp-config-required`	Check Point (SNMP) benötigt einen Host

Erfasste Metriken

vendor — der für den Renderer zurückgegebene Hersteller-String
online — Appliance ist erreichbar / mindestens eine Firebox ist verbunden
firmwareCurrent — aktuell installierte Firmware-Version (best-effort über JSON-Formen der Hersteller)
firmwareLatest — neueste von OPNsense oder Securepoint UTM gemeldete Version oder der konfigurierte Soll-String für Sophos, WatchGuard, SonicWall und Check Point
upToDate — true/false/null (null, wenn die Aktualitäts-Dimension nicht ausgewertet wurde)
licenseExpiresAt — nächster Feature-Key-/Abonnement-Ablauf (WatchGuard, FortiGate (REST-API), Securepoint UTM und Check Point), ISO-8601
openAlerts — ThreatSync-Offene-Vorfälle-Anzahl, wenn verfügbar (nur WatchGuard)
issues — Liste von {severity, code, detail}-Einträgen, die zum Ergebnis beigetragen haben

Die SNMP-Oberflächen liefern zusätzlich die folgenden Live-Messwerte; welche davon gefüllt sind, hängt davon ab, was die Hersteller-MIB bereitstellt.

sysName / model / osVersion / uptimeDays — Appliance-Identität und Laufzeit
cpuPercent / memPercent / diskPercent — CPU-, Speicher- und Disk-Auslastung in Prozent
memTotalMB / diskTotalMB — Gesamt-Speicher- und Disk-Kapazität
sessionCount — Anzahl aktiver Sessions
vpnTunnels plus vpnTunnelsTotal / vpnTunnelsUp / vpnTunnelsDown — Status je Tunnel und Summen
haMode / haGroup / haNodes / haNodeCount — HA-Modus, -Gruppe und CPU/Speicher je Knoten
interfaces plus ifTotal / ifUp / ifDown und ifInErrors / ifOutErrors — Interface-Status und aggregierte Fehlerzähler

Plattform-Unterstützung

Der Check läuft auf dem octoja-Agenten; die Agent-Plattform ist irrelevant — entscheidend ist die Erreichbarkeit der Appliance bzw. Cloud.

Agent-Plattform	Unterstützt
Windows	Ja
macOS	Ja
Linux	Ja

Du kannst den Check auch einem Netzwerkgerät zuweisen — einer Firewall, die ohne Agent in octoja registriert ist. octoja füllt Host / IP dann aus der IP-Adresse dieses Geräts, und der Check läuft auf dem Agenten, der als Überwachungsgerät hinterlegt ist.

Hinweise

Der Check läuft alle 15 Minuten auf dem Agenten. Das Intervall ist nicht durch den Benutzer konfigurierbar.
HTTP-Timeout je API-Aufruf beträgt 30 Sekunden.
Der OPNsense-Ablauf löst vor dem Statuslesen einen frischen Firmware-Check aus und wartet dann 4 Sekunden — die OPNsense-API liefert einen gecachten Status, bis ein Check ausdrücklich angestoßen wird.
Der WatchGuard-Parser ist tolerant gegen Feldnamen-Variationen zwischen Mandanten: connectionStatus / status, fireboxVersion / osVersion, featureKeyExpiration / expirationDate und so weiter.
Der Versionsvergleich ignoriert Groß- und Kleinschreibung und vergleicht ganze Versionsbestandteile: Die laufende Version gilt als aktuell, wenn sie der Soll-Version entspricht oder sie an einer Bestandteilsgrenze fortsetzt. 12.7.1 erfüllt die Soll-Version 12.7, und 21.0.0 GA erfüllt 21.0.0, während 20.0.2 die Soll-Version 2 nicht erfüllt. Setze Soll-Firmware-Version auf ein kürzeres Präfix, um Patch-Revisionen durchzulassen.
OPNsense- und Sophos-Feature-Key-/Lizenz-Ablauf wird aktuell nicht ausgewertet. Die Lizenz-Dimension gilt für WatchGuard, FortiGate (REST-API), Securepoint UTM (SNMP) und Check Point (SNMP).
Die Sophos-XML-API erwartet die Zugangsdaten im Request-Body, nicht in Headern — octoja escapt Benutzereingaben über den XML-Serialisierer, bevor sie gepostet werden.
SNMP-Schwellwerte werden so normalisiert, dass der Warn-Wert nie höher als der Kritisch-Wert ist — bei verdrehter Eingabe vertauscht octoja sie.
FortiGate-(SNMP)-VPN-Tunnel-Status wird je Tunnel-Name aggregiert: Ein Tunnel gilt als up, wenn einer seiner Selektoren up ist.
Die SNMP-Interface-Erfassung überspringt Software-Loopback-Interfaces. Ein erforderliches Interface, das admin-up, aber betrieblich down ist, wird als down gemeldet.

Siehe auch: Einen Netzwerk-Firewall-Check (Appliance) konfigurieren