118 lines
7.7 KiB
Markdown
118 lines
7.7 KiB
Markdown
# 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.
|