Files
rust-discovery/deploy/opnsense

OPNsense-Testclient

Test-VM discovery-opnsense auf qemu:///system, 2 vCPU, 1536 MiB RAM, 12 GiB virtuelle Platte. Basis: offizielles Nano-Image OPNsense 26.7 amd64; SHA-256 des komprimierten Images 28d5e2f37e40d87468a924e3006ef10e2ddc6de485b85333d9e3958c84d0cb9d, gegen die Herstellerankündigung verglichen und die Signatur des entpackten Images geprüft. Start bei Bedarf: virsh -c qemu:///system start discovery-opnsense. Konsole: virsh -c qemu:///system console discovery-opnsense. Das LAN 192.168.247.0/24 ist eine isolierte libvirt-Bridge, das WAN 192.168.246.0/24 verwendet NAT. Management vom Notebook: https://192.168.247.1. Der Hostpin stammt aus der seriellen Konsole; Zugangswerte liegen ausschließlich im privaten Zugangsspeicher des ursprünglichen Checkouts.

Quelle und Entwicklungsinstallation

Der OPNsense-eigene Python-Interpreter führt zwei Zipapps aus. Der lokale Collector läuft mit den für PF, VPN-Sockets und Konfiguration nötigen Rechten. Er veröffentlicht ausschließlich den ausgewählten Bestand atomar in /var/db/discovery-observations/inventory.json. Das Dienstkonto discovery kann die Datei lesen, aber weder Collector noch Cache verändern. Nur dieses Konto hält die Geräteidentität und nutzt den ausgehenden HTTPS-Kanal. Für die Erfassung wird keine eingehende Netzwerkverbindung benötigt.

  1. In einer Build-venv grpcio-tools==1.76.0 und protobuf==6.33.5 installieren. python deploy/opnsense/build.py ARTIFAKTORDNER generiert die Protobuf-Bindung aus proto/agent.proto und packt die portable Python-Laufzeit mit ein. python deploy/opnsense/test_agent.py ARTIFAKTORDNER/agent.pyz prüft die Wiederholung einer nicht bestätigten Inventarmeldung mit unveränderter Nachrichtenidentität.
  2. Über den gepinnten Entwicklungszugang agent.pyz, collect.pyz, discovery_agent und den bestätigten öffentlichen CA-Anker des Gerätegateways als ca.pem in einen privaten Stagingordner im Gast übertragen. sh install-dev.sh STAGINGORDNER auf dem Gast ausführen. Diese Strecke ist eine direkte Entwicklungsbereitstellung, kein signierter Releasekanal.
  3. Bei einer frischen Installation in der Discovery-WebUI den Testkunden wählen und einen Einmalcode erzeugen. Den Code über geschützte Standardeingabe an su -m discovery -c '/usr/local/bin/python3 -I /usr/local/libexec/discovery-agent/agent.pyz enroll' übergeben. Danach service discovery_agent start. Bei vorhandener Identität nicht neu enrollen. Der Dienst verwaltet beide Prozesse; rc.conf.local aktiviert sie beim Start.
  4. In Geräte den Hostnamen öffnen. Das Inventar wird ungefähr einmal pro Minute erhoben, der Heartbeat etwa alle 20 Sekunden gesendet. Das Betriebssystem liefert CPU-Zeitdifferenzen und eine RAM-Schätzung aus freien und inaktiven Seiten. Fehlgeschlagene Quellen erscheinen als „Nicht ermittelbar“, ein erfolgreicher leerer Befund gesondert. Pro Liste werden höchstens 128 Zeilen gemeldet; Auszüge sind gekennzeichnet.

Systeminventar: Kern-Bootzeit, VM-Erkennung, verfügbare SMBIOS-Daten, Netzwerkkarten mit MAC und IPs, angemeldete Benutzer und lokale FreeBSD-Pakete mit Version. Bei Software liegt die Obergrenze bei 1024 Paketen.

VPN: Beschreibungen und Aktivierung der OPNsense-Modelle für WireGuard-Instanzen/-Peers, OpenVPN-Instanzen und IPsec-Verbindungen. Separat: WireGuard-Handshakes (kein dauerhafter Online-Status), OpenVPN-Managementstatus und IKE-Sicherheitsassoziationen. Ohne erreichbaren IPsec-Dienst ist der Laufzeitstatus unbekannt. Keine privaten Schlüssel, PSKs, Zertifikate oder vollständige Gerätekonfiguration im Inventar.

Firewall: aktiver PF-Hauptregelsatz in Kernelreihenfolge, einschließlich automatisch erzeugter Regeln. Kein Editor und kein rekursives Auslesen der Anchor-Regelsätze.

Profile: Ohne Worker und Signaturbindung bleibt das Gerät passiv. Mit dem FreeBSD-Worker unterstützt 0.1.0-opnsense.5 genau die feste Kernelabfrage (uname -s\n, posix_sh, erwartete Ausgabe FreeBSD\n, keine Argumente, Dienstkonto, 10 s, 1024 Byte). Unter Geräte → OPNsense-Kernelabfrage lässt sie sich für diese Installation einreichen. Die persönliche WebUI-Genehmigung und der signierte Startgrant sind erforderlich. Root, beliebige Shell-/Bibliotheksskripte und signierte OPNsense-Releases bleiben offen. Das Gerät ist kein Linuxziel.

Probe bereitstellen: Im Gast steht die gepinnte Toolchain unter /opt/discovery-rust. cargo build --locked -p rmm-opnsense-jobs nativ bauen und rmm-opnsense-jobs root-eigen (0555) neben den Zipapps installieren. Auf der bereits aufgenommenen Testinstallation python3 -I pin-probe.py TENANT ASSET AGENT ENROLLMENT_GENERATION ASSIGNMENT_VERSION mit den bestätigten Kennungen aufrufen. Das Skript bezieht den öffentlichen Jobschlüssel über das bestehende Gerätezertifikat und überschreibt keine andere Bindung. Den Agentendienst anschließend neu starten. Der Worker nutzt bestehende Nachrichtenfolgen, den signierten Abgleich und getrennte dauerhafte Start-/Ergebnisjournale. Er läuft ohne Netzwerklistener als discovery. Der native Integrationstest prüft mit eigener Testidentität und eigenem Schlüssel die Ablehnung einer defekten Signatur, erwartete Ausgabe, einen Verbrauch und keine zweite Ausführung bei Wiederzustellung. Das ist ein separater Beleg vom persönlich genehmigten Geräteauftrag.