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.
- In einer Build-venv
grpcio-tools==1.76.0undprotobuf==6.33.5installieren.python deploy/opnsense/build.py ARTIFAKTORDNERgeneriert die Protobuf-Bindung ausproto/agent.protound packt die portable Python-Laufzeit mit ein.python deploy/opnsense/test_agent.py ARTIFAKTORDNER/agent.pyzprüft die Wiederholung einer nicht bestätigten Inventarmeldung mit unveränderter Nachrichtenidentität. - Über den gepinnten Entwicklungszugang
agent.pyz,collect.pyz,discovery_agentund den bestätigten öffentlichen CA-Anker des Gerätegateways alsca.pemin einen privaten Stagingordner im Gast übertragen.sh install-dev.sh STAGINGORDNERauf dem Gast ausführen. Diese Strecke ist eine direkte Entwicklungsbereitstellung, kein signierter Releasekanal. - 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. Danachservice discovery_agent start. Bei vorhandener Identität nicht neu enrollen. Der Dienst verwaltet beide Prozesse;rc.conf.localaktiviert sie beim Start. - 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.