Files
rust-discovery/deploy/windows/CLIENT.md
T
2026-11-13 23:23:42 +01:00

9.5 KiB
Raw Blame History

Windows-Client: erster nativer Entwicklungsstand

Stand 2026-11-13, Spezifikation 1.15. Windows-11-Gast und Notebook-Host sind verschiedene Geräte. Auf dem Notebook laufen ausschließlich Entwicklungstools; der Client verwendet den endgültigen Cloudserver discovery.ease-technologies.de.

Native HTTPS-Abnahme zusätzlich bestanden — 2026-11-13

Der bestehende LocalService-Agent wurde im festen Fall 3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458 administrativ und versioniert von WSS auf explizites HTTPS umgestellt. Keine neue Identität, kein Enrollment, kein RMM-Job. Tatsächlicher serverseitiger Transport https, zwei frische Heartbeats um 22:21:14.183598 und22:21:45.234313 UTC. Der native Readonly-Journalbeleg bestätigt Integrität, gleiche Identität, monotone Sequenz935→941 und0 ausstehende Inventarereignisse nach konkretem ACK. Tatsächlicher Prozessowner S-1-5-19 (LocalService); unverändertes qualifiziertes Programm, CA, Zertifikat, privater Geräteschlüssel und deren ACLs. Private Schlüssel blieben auf der VM.

Anschließend exakt ursprüngliche WSS-Konfigurationsbytes und ACLs wiederhergestellt, zweimal frischer WSS-Kontakt sowie abgeschlossener Inventar-ACK nachgewiesen. Beide fremden Tenantzugriffe verweigert; vorher/nachher0Jobs/0Outbox/0Grants/ 0offene Versuche. result.json ist verifiziert. Geschützte Belege: devstate/windows-client/transport/3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458/.

Ausgeführt: python3 deploy/windows/transport_acceptance.py start. Der Runner verwendet einen per Hash und SFTP gepinnten Bootstrap-PowerShellcode; prozessbezogenes RemoteSigned ändert keine Maschinen-/Gruppenrichtlinie und keine RMM-Jobausführung. Sieben gezielte lokale Runner-Guards und drei PowerShell-Parserprüfungen bestanden; kein neuer Clientbuild für diese Abnahme. Automatischer Fallback und TLS-Negativfälle sind getrennte folgende Abnahmen. PowerShell-Jobs bleiben bis zu ihren Voraussetzungen gesperrt. Die folgenden Erstnachweise bleiben historisch erhalten.

Tatsächlich nachgewiesen

rmm-agent-windows als eigene Plattform-Crate mit gemeinsamen Domain-/Protobuf- Verträgen und direkt wiederverwendeten WSS-/HTTPS-/TLS-Modulen des Linux-Agenten. Isolierter Docker-Crossbuild mit Rust 1.99.1 für x86_64-pc-windows-gnu: Debug und Release erfolgreich; Windows-target Clippy über alle Targets mit -D warnings erfolgreich. Zwei gezielte Domain-Tests prüfen die unveränderte Linux-Validierung, Windows ohne erfundene Inodes und abgewiesene Plattformmischung. Das sind ergänzende lokale Prüfungen, keine nativen Windows-Dienstnachweise.

Releaseartefakt SHA256 31e360e50b177b4d5729d24e436d4f25aeed7b1a7bd35f2a129841ba1abffd37 auf der tatsächlichen Windows-11-Pro-VM (Version 10.0.26300, x64) gestartet: --native-probe erfolgreich. Hostname und Systemvolume tatsächlich über Win32 lesbar; Bootkennung aus Win32_OperatingSystem.LastBootUpTime abgeleitet statt bei jedem Agentstart neu erzeugt. Inodes ausdrücklich null/nicht anwendbar. Keine Schlüssel oder realen Hostnamen in der veröffentlichten Probeausgabe.

Binärtransfer über bestehendes, hostkeygeprüftes SFTP mit SHA256-Nachprüfung. Große PowerShell-Console-JSON-Eingaben waren als Bootstraptransport ungeeignet (Timeout/Console-Reader-Ausnahme); deshalb nur kleine zeilenbegrenzte Metadaten über stdin. SSH-/Hostkeyprüfung und Reverse-Portgrenzen bleiben unverändert. Artefaktverzeichnisse werden nach Hash neu angelegt, keine vorhandene Identität oder Historie gelöscht. Private Evidenz: devstate/windows-client/.

Nativer Dienst, Inventar und verbleibender Umfang

  • Nativer SCM-Dienstlebenszyklus als LocalService mit eigenem Service-SID-Zugriff auf Zustand und ausschließlich lesbarem Programm/Config.
  • Windows prüft Owner/DACL und verweigert Reparse-Points/breite ACLs. Geräteschlüssel werden nur auf Windows erzeugt; Enrollment über CA- und namensgeprüftes TLS, danach mTLS. Ein verlorener Enrollmentnachweis löst keinen Identitätsreset aus.
  • SQLite mit FULL-Synchronisierung, Prozesssperre, monotoner persistenter Sequenz, konkretem ACK und begrenzter Telemetriequeue. Kein Löschen für Platzgewinn.
  • Separate windows.base-Beobachtungen mit Erhebungszeit/Quelle/Qualität; Server bindet den Scope an die authentisierte Verbindung und deren Capability. Geräte-API zeigt die gespeicherte Quelle statt eines festen Linuxlabels.
  • Ausschließlich windows.base/1 und heartbeat/1 werden angeboten. Kein Jobexecutor, keine PowerShell-Jobfähigkeit, kein privilegierter Helper. Angebote/Startgrants werden verweigert. Es gibt keine Genehmigungsabkürzung.

Tatsächlich installiert und gestartet: nativer SCM-Dienst mit eigenem Service-SID unter NT AUTHORITY\LocalService; tatsächlicher Prozessowner S-1-5-19, nicht Administrator/SYSTEM. Eigener Geräteschlüssel auf Windows erzeugt, einmaliges Enrollment erfolgreich und Tokenkopie entfernt; mTLS-Hello und frischer Heartbeat serverseitig bestätigt. Der erste .ps1-Aufruf wurde durch die lokale Ausführungsrichtlinie vor jeder Installerwirkung verweigert. Verzeichnis, Dienst und Identität waren nachweislich nicht angelegt; erst danach kontrollierte Fortsetzung mit explizit prozessbezogenem RemoteSigned wie beim ursprünglichen Bootstrap. Keine Änderung der Maschinen-/Gruppenrichtlinie, keine Jobausnahme.

Native Rust-Testprogramme direkt über den gepinnten SSH-Zugang ausgeführt: 3 Transporttests + 3 Bibliothekstests + 1 ACL-Integrationstest bestanden. Diese prüfen Namens-/URL- Validierung und sichere Fallbackauswahl, echte Windows-Inventardaten, zwei unabhängige stabile Bootabfragen sowie SQLite-Reopen, monotone Sequenz, Prozesssperre, gezielten ACK und Identitätsbindung. Der zusätzliche native ACL-Test weist korrekte ACLs nach und verweigert breite ACLs, NULL-DACLs, falschen Pfadtyp und Reparse-Points an ausschließlich neu erzeugten nichtgeheimen Tempfixtures. PowerShell-Pipelinewrapper warteten bei nativen Testprogrammen; direkte native Ausführung lieferte Exit 0.

Der tatsächliche Online-Lauf fand eine weitere echte Grenze: Migration 0001 beschränkte observations.source_id auf linux.base. Daher bisher Heartbeats, aber kein gespeichertes Windowsinventar. Additive Migration 0013 erweitert nur diesen CHECK auf die beiden validierten Basisscopes. Echter isolierter PostgreSQL- Test der Migrationen 1–13 bestanden: alte Linuxzeile bytegleich, Windows erlaubt, beliebiger Scope verweigert, RLS bei fremdem/fehlendem Kontext und zusammengesetzter Geräte-FK erhalten, keine Jobs/Outbox/Grants. Cloudmigration 0013 anschließend tatsächlich erfolgreich. Der ursprüngliche Windows-Journaleintrag wurde ohne Neuerhebung/Identitätsreset erneut zugestellt und gespeichert: ursprüngliches observed_at bleibt erhalten, received_at ist separat. Geräte-API/MCP melden source_id=windows.base, korrektes Windowsinventar und Inodes null; zwei verschiedene frische Heartbeats und online belegt. Mandant B wurde sowohl für den A-Kontext als auch für seine eigene Mandantensicht mit der fremden Asset-ID abgewiesen. Gerätespezifisch 0 Jobs / 0 Outbox / 0 Startgrants / 0 offene Versuche. Keine WebUI-Genehmigung ausgeführt, weil diese Strecke ausschließlich passive Standardbeobachtungen verarbeitet.

Dieser erste Entwicklungsbuild ist unsigniert. Kein produktiver signierter Installer/MSVC-Supportnachweis, keine Zertifikatsrotations-/Widerrufs-/Proxy- oder Windows-Paket-/Dienstaktionsabnahme. Der erste native Onlinenachweis verwendete WSS. Explizites HTTPS ist inzwischen oben separat nativ abgenommen; automatischer Fallback folgt gesondert. Die passive SCM-/Enrollment-/mTLS-/Inventar-/Mandantentrennungsstrecke sowie die oben benannten nativen Tests sind nun tatsächlich getrennt belegt. Dies ist keine vollständige Windows-/Linux-MVP-Abnahme.

Ausgeführte und geplante Befehle

Tatsächlich ausgeführt: Docker-Build und gezielte Rust-Prüfungen oben sowie python3 deploy/windows/client_bootstrap.py upload-agent --artifact <Release-EXE> und python3 deploy/windows/client_bootstrap.py probe gegen ausschließlich den Windows-Gast. Keine RMM-Jobs oder Genehmigungen wurden dabei erzeugt.

Zusätzlich tatsächlich ausgeführt: native test-lib/test-bin/test-acl, Installer nach nachgewiesenem Nichtstart mit install-after-nonstart und die oben benannte PostgreSQL-Migrationsprüfung sowie passive-acceptance gegen den Cloudserver mit gespeichertem Inventar, zwei Heartbeats, Tenant-B-Verweigerung und Null-Jobgate. Installation ist create-only; bei Teilfehlern Zustand inspizieren und erhalten, nicht blind neu enrollen oder den Bootstrap wiederholen.

Native ergänzende Receiptprüfung: das separate Entwicklungstool examples/passive_state.rs öffnete ausschließlich die vorhandene Windows-SQLite im Read-only-Modus. Integrität ok, feste Geräteidentität identisch, Sequenz 59, 0 ausstehende Inventarereignisse: der konkrete Server-ACK wurde lokal verbucht. Keine neue Erhebung, kein Journalreset und kein neues Enrollment für diesen Nachweis.

Bekannte Darstellungsgrenze des ersten Collectors: os enthält den tatsächlich ausgelesenen Registry-Produktnamen samt DisplayVersion/Build. Auf dieser Windows- 11-Pro-VM lautet der historische Registrywert noch Windows 10 Pro, mit DisplayVersion=26H2; Build=26300. Die unabhängige native CIM-Probe bestätigt Windows 11 Pro. Der Registrywert wird nicht stillschweigend als Marketingversion uminterpretiert; eine einheitliche, quellenbewusste OS-Bezeichnung ist noch offen. Die aktuelle Capability bleibt deshalb ausdrücklich partielles Basisinventar.