144 lines
9.5 KiB
Markdown
144 lines
9.5 KiB
Markdown
# 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](../../docs/windows-job-boundary.md)
|
||
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.
|