From b6d7bf4a93d2f009f7c8405dfb9bb7bc176cb993 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Sat, 21 Nov 2026 12:36:44 +0100 Subject: [PATCH] Record the update of the OPNsense 24.7 firewall: heartbeat, inventory and script worker Co-Authored-By: Claude Opus 5.5 --- docs/mvp-completion-plan.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index f5a7ca6..f331b38 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -54,7 +54,7 @@ Alle acht Versuche lieferten Exitcode 0. Bei beiden Neustarts wurde die Wiederan | Gerätetyp in der Übersicht | Spalte „Type“ nach „Hostname“ mit `physical`, `virtual` und `hypervisor`. Erkannte Proxmox-VE-Hosts zeigen `Proxmox VE` als OS. Am 18. November wurde `c599baa` auf dem öffentlichen Server aktiviert. Der Serverrunner bestätigte API, Gateway und öffentlichen API-Dienst mit Binärhash `4f9c8c60…`. Der öffentliche WebUI-Index stimmte mit dem gebauten Bundle überein. Die unveränderten Geräteidentitäten meldeten nach regulärem signierten Update `virtual` auf Linux mit `0.1.0-mvp.7` um 16:45 UTC und Windows mit `0.1.17` um 16:47 UTC. Geräteliste, Details, Mobilansicht mit 390 px und Historie sind in der öffentlichen WebUI geprüft. Beide Pakete sind in Development A und B und als Starter für leere Kataloge veröffentlicht. Die Typen `physical` und `hypervisor` sind mit Testdaten geprüft. Die Feldabnahme auf einem physischen Gerät und einem Proxmox-VE-Host steht aus. [Inventarprojektion](../crates/server/src/devices.rs) · [Geräteansicht](../web/src/devices.tsx) | | Hostzuordnung bei VMs | Die WebUI zeigt einen zugeordneten Hypervisor direkt an der VM. Der Browsertest prüfte Zuordnung, Verlinkung, Entfernen und den Hetzner-Platzhalter bei 390 px Breite. In PostgreSQL wurden die Page-Grenze, archivierte Hypervisoren und die Trennung der Kunden geprüft. 80 WebUI-Tests, vier Browsertests und fünf Rust-Gerätetests bestanden. Revision `bcd3bd8` wurde am 18. November um 21:43 UTC mit Schema 43 aktiviert. Der Serverrunner bestätigte die TLS-Healthchecks und der öffentliche Index entsprach dem Build. In der öffentlichen WebUI zeigten zwei vorhandene Hetzner-VMs den Platzhalter auf Desktop und Mobil. Die Auswahl war im Gerätedetail verfügbar. Der Bestand enthielt zum Prüfzeitpunkt keinen registrierten Hypervisor. [Geräteansicht](../web/src/device-hypervisor.tsx) · [Hostsuche](../crates/server/src/hypervisors.sql) | | Gruppierte Geräteübersicht | Der Bestand zeigt je Hypervisor einen Block mit Host und eingerückten VMs, danach „Hetzner Cloud“, „Physische Geräte“ und „Nicht zugeordnet“. Am 20. November bestanden 87 WebUI-Tests, darunter vier zur Gruppierung (Reihenfolge, Host außerhalb der Seite, Kundentrennung, manuell zugeordneter Host), und die lokale Browsersuite mit dem angepassten Zuordnungstest bei 390 px Breite. Desktop- und Mobildarstellung wurden mit Beispieldaten im Browser angesehen. Eine Sichtprüfung mit persönlicher Sitzung auf dem Entwicklungsserver steht aus. [Gruppierung](../web/src/device-groups.ts) · [Geräteliste](../web/src/devices.tsx) | -| OPNsense-Aufnahme per HTTPS | Am 21. November wurde Revision `7201b18` aktiviert, das OPNsense-Paket `0.1.0-opnsense.6` mit nativem Worker auf dem Server abgelegt und der öffentliche Ingress um die OPNsense-Pfade ergänzt. Öffentlich: `/install/opnsense.sh` 200, Paketmetadaten und Dateien ohne gültigen Code 401, nicht gelistete Dateinamen 404. Auf der Test-VM `discovery-opnsense` (Kunde `9d730e0a-…`) lud der Befehl das Skript mit `fetch`, prüfte das Paket und aktualisierte die Programmdateien. Danach entsprachen `agent.pyz`, `collect.pyz` und `rmm-opnsense-jobs` den SHA-256 des Servers. Identität, Gerätschlüssel, Job-Bindung und Root-Policy waren unverändert, Agent, Collector und Root-Helper liefen, und die Firewall meldete sich mit neuer Verbindungsgeneration und Version `0.1.0-opnsense.6`. Ein ungültiger Code brach vor jeder Änderung ab. 87 WebUI-Tests und die Browsersuite bestanden. **Erstaufnahme, 21. November:** Eine neue Firewall mit OPNsense 24.7 (FreeBSD 14.1, Kunde `8285325f-…`) wurde aufgenommen, meldete Erfolg, erschien aber nicht in der WebUI. Der im FreeBSD-15-Testgast gelinkte Worker verlangte `FBSD_1.9` und lud dort nicht (`ld-elf.so.1 … version FBSD_1.9 … not found`). Der Agent baute den Kanal deshalb alle 30 Sekunden neu auf, ohne Heartbeat oder Inventur zu senden, und der Installer prüfte nur Version und Verbindungsgeneration. Mit Revision `93429e4` setzt der Agent (`0.1.0-opnsense.7`) die Skriptfähigkeiten eine Stunde aus und sendet weiter Telemetrie. Der Worker wird mit [dev_opnsense_worker.py](../tools/dev_opnsense_worker.py) gegen die pkgbase-Bibliotheken von FreeBSD 14.1 gelinkt (höchstens `FBSD_1.7`), und der Installer prüft das Laden des Workers und wartet auf einen Heartbeat. Belegt: Der neue Worker lud mit `LD_BIND_NOW=1` in `/tmp` der 24.7-Firewall und im Testgast, und der native Worker-Test bestand im Testgast unter `discovery`. Auf `discovery-opnsense` liefen Agent `0.1.0-opnsense.7` und der bisherige Worker mit fortlaufenden Heartbeats bei stabiler Verbindungsgeneration (die Root-Policy dort pinnt den bisherigen Worker-Hash). Die Aktualisierung der 24.7-Firewall steht noch aus. [Installer](../crates/server/src/bootstrap/opnsense_install.py) · [Paketauslieferung](../crates/server/src/bootstrap/opnsense.rs) | +| OPNsense-Aufnahme per HTTPS | Am 21. November wurde Revision `7201b18` aktiviert, das OPNsense-Paket `0.1.0-opnsense.6` mit nativem Worker auf dem Server abgelegt und der öffentliche Ingress um die OPNsense-Pfade ergänzt. Öffentlich: `/install/opnsense.sh` 200, Paketmetadaten und Dateien ohne gültigen Code 401, nicht gelistete Dateinamen 404. Auf der Test-VM `discovery-opnsense` (Kunde `9d730e0a-…`) lud der Befehl das Skript mit `fetch`, prüfte das Paket und aktualisierte die Programmdateien. Danach entsprachen `agent.pyz`, `collect.pyz` und `rmm-opnsense-jobs` den SHA-256 des Servers. Identität, Gerätschlüssel, Job-Bindung und Root-Policy waren unverändert, Agent, Collector und Root-Helper liefen, und die Firewall meldete sich mit neuer Verbindungsgeneration und Version `0.1.0-opnsense.6`. Ein ungültiger Code brach vor jeder Änderung ab. 87 WebUI-Tests und die Browsersuite bestanden. **Erstaufnahme, 21. November:** Eine neue Firewall mit OPNsense 24.7 (FreeBSD 14.1, Kunde `8285325f-…`) wurde aufgenommen, meldete Erfolg, erschien aber nicht in der WebUI. Der im FreeBSD-15-Testgast gelinkte Worker verlangte `FBSD_1.9` und lud dort nicht (`ld-elf.so.1 … version FBSD_1.9 … not found`). Der Agent baute den Kanal deshalb alle 30 Sekunden neu auf, ohne Heartbeat oder Inventur zu senden, und der Installer prüfte nur Version und Verbindungsgeneration. Mit Revision `93429e4` setzt der Agent (`0.1.0-opnsense.7`) die Skriptfähigkeiten eine Stunde aus und sendet weiter Telemetrie. Der Worker wird mit [dev_opnsense_worker.py](../tools/dev_opnsense_worker.py) gegen die pkgbase-Bibliotheken von FreeBSD 14.1 gelinkt (höchstens `FBSD_1.7`), und der Installer prüft das Laden des Workers und wartet auf einen Heartbeat. Belegt: Der neue Worker lud mit `LD_BIND_NOW=1` in `/tmp` der 24.7-Firewall und im Testgast, und der native Worker-Test bestand im Testgast unter `discovery`. Auf `discovery-opnsense` liefen Agent `0.1.0-opnsense.7` und der bisherige Worker mit fortlaufenden Heartbeats bei stabiler Verbindungsgeneration (die Root-Policy dort pinnt den bisherigen Worker-Hash). Um 11:34 UTC lief der öffentliche Installer mit einem neuen Einmalcode desselben Kunden auf der 24.7-Firewall als Aktualisierung (Identität und Bindung blieben, der Code wurde nicht verbraucht) und meldete Erfolg erst nach dem Heartbeat. Danach lief der neue Worker (`4100f1d5…`) unter `discovery`, das Systemlog zeigte keinen Fehler mehr, die Verbindungsgeneration blieb bei 354 und der Server führte Version `0.1.0-opnsense.7` mit `run_script`, fortlaufendem `last_contact_at` und `opnsense.base`-Snapshots der Qualität `valid` (11:34:47, 11:35:47). [Installer](../crates/server/src/bootstrap/opnsense_install.py) · [Paketauslieferung](../crates/server/src/bootstrap/opnsense.rs) | | Installationsbefehl für Proxmox VE | Proxmox VE 9.2 enthält kein `sudo`. Auf dem Testhost am 21. November geprüft: `curl` und `python3` vorhanden, `sudo` fehlt. Der Linux-Befehl der WebUI brach dort deshalb ab. **Gerät aufnehmen** zeigt bei verfügbarem x86-64-Release zusätzlich den Block „Proxmox VE“ mit demselben Installer ohne `sudo` für eine Root-Shell, mit und ohne `--enable-admin-scripts`. 87 WebUI-Tests und der angepasste Browsertest der Aufnahmebefehle bestanden. [Aufnahme](../web/src/main.tsx) · [Proxmox-Host](../deploy/proxmox/README.md) | | Von der Auswahl zur Ausgabe | Die WebUI bindet die ausgewählte Skriptversion, zeigt den Inhalt vor Genehmigung und verlinkt das Ergebnis je Gerät. Ein abgelehnter Antrag erzeugte null Jobs. [Auftragsablauf](evidence/webui-auftragsablauf-20261117.json) · [Ergebnislinks und Entscheidungen](evidence/webui-order-history-20261118.json) Auf OTRS ARM64 wurde der Root-Skript-Helper nachträglich mit dem HTTPS-Installer aktiviert. Die zentrale Geräteregel bindet das berechtigte WebUI-Konto an diese Installation und den signierten Helper. Die öffentliche WebUI-Vorschau akzeptierte Root für OTRS. Die Probe blieb bei einer Vorschau und erzeugte null Anträge, Jobs, Outbox-Einträge und Startgrants. [OTRS-Nachweis](evidence/linux-arm64-otrs-root-helper-20261118.json) | | Frische Installation und periodisches Agentupdate | Beide VMs wurden über HTTPS aufgenommen und übernahmen anschließend ein signiertes Folgepaket mit derselben Geräteidentität. Auf Windows ist der öffentliche GNU-Kanal einschließlich Prüfung des offiziellen Schlüssels belegt. [Linux](evidence/linux-public-installer-update-20261117.json) · [Windows GNU](evidence/windows-gnu-official-vm-20261118.json). ARM64 erweitert denselben HTTPS-Installer mit automatischer Architekturerkennung. Release `0.1.0-arm64.1` ist veröffentlicht und als Starter verfügbar. Auf Ubuntu 22.04.5 ARM64 wurden die öffentlichen Downloads, die Signaturprüfung, die Ablehnung einer veränderten Agentdatei und der native Start aller drei Dateien im Prüfmodus beobachtet. OTRS ist mit Gerätezertifikat aufgenommen und meldet authentisierte Heartbeats. Die erste Kontaktprüfung wartet seit der Korrektur auf das Zertifikat. Der öffentliche Installer lief auf OTRS erneut ohne Traceback und ohne neuen Einmalcode. Der ARM64-Katalogabruf ist bestätigt. Ein späterer Versionswechsel auf ARM64 steht aus. [ARM64-Release](evidence/linux-arm64-installer-20261118.json) · [Geräteaufnahme und Nachtest](evidence/linux-arm64-enrollment-heartbeat-20261118.json) |