Files
rust-discovery/deploy/windows/CLIENT.md
T
2026-11-13 16:18:04 +01:00

118 lines
7.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Windows-Client: erster nativer Entwicklungsstand
Stand 2026-11-13, Spezifikation 1.9. 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`.
## 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 native Onlinenachweis verwendet WSS;
HTTPS-/Fallbackmodi sind gemeinsam implementiert, nativ auf Windows noch nicht
abgenommen. 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.