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.

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.

Grenzen: Das passive Profil meldet keine Skript-, Root- oder Release-Capability. Der bestehende Linux-Jobpfad verwendet Linux-spezifische Uhren, Helper und Interpreterprüfung. Für Parität benötigt OPNsense eigene native Adapter für den signierten Abgleich, den Startgrant und das Ausführungsjournal sowie einen eigenen signierten Installer-/Updatekanal. Der OPNsense-Gast darf nicht als Linuxziel für APT- oder Bash-Vorlagen angeboten werden.