227 lines
15 KiB
Markdown
227 lines
15 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`.
|
||
|
||
## Aktueller Dienst dauerhaft auf Auto — 2026-11-13
|
||
|
||
Nach dem bestandenen Fallbacktest wurde die bestehende VM im separaten Fall
|
||
`422562e8-18eb-4865-977d-ab2af65f510b` dauerhaft auf `transport=auto` gestellt.
|
||
WSS bleibt bevorzugt; zwei frische WSS-Heartbeats und ein konkretes Inventar-ACK
|
||
sind unter dem tatsächlichen LocalService (`S-1-5-19`) nativ nachgewiesen.
|
||
Binary, Geräteidentität, CA, Zertifikat, Schlüssel, ACLs und Telemetriehistorie
|
||
blieben erhalten. Beide Server-Testhooks bleiben deaktiviert; Serverkonfiguration
|
||
und Rootpolicy wurden bei dieser Umstellung nicht verändert. Windows bleibt bei
|
||
0 Jobs/Outbox/Grants/ungeklärten Wirkungen, Linux unverändert bei 30/30/26/0.
|
||
|
||
Der verifizierte geschützte Beleg liegt unter
|
||
`devstate/windows-client/auto-default/422562e8-18eb-4865-977d-ab2af65f510b/result.json`.
|
||
`devstate/windows-client/current-transport.json` bindet ihn per Hash und hält den
|
||
aktuellen Transport getrennt von historischen Abnahmen fest. Originalkonfiguration
|
||
und ACLs bleiben versioniert für eine ausdrückliche Wiederherstellung erhalten.
|
||
Die Installerquelle verwendet ebenfalls `auto`; eine frische Installation wurde
|
||
damit nicht ausgeführt. Fünf gezielte lokale Schutztests sowie Parserprüfungen
|
||
bestanden. Es wurden keine Windows-Jobs oder Reboots ausgeführt.
|
||
|
||
## Automatischer WSS→HTTPS-Fallback nativ bestanden — 2026-11-13
|
||
|
||
Eigener Fall `2ff2e1aa-0037-4831-9bc2-31218bf1461c` auf derselben bestehenden
|
||
Windows-Identität unter LocalService. Nur der eigene Agenttransport wurde
|
||
versioniert auf `auto` gestellt. Zunächst zwei frische WSS-Heartbeats;
|
||
dann exakt gerätegebundene, zehn Minuten gültige dev/test-Störung.
|
||
Zwei tatsächliche mTLS-authentisierte HTTP503 bei WSS, mit unterschiedlichen
|
||
Handshake-IDs und den festen Slots1/2, Zertifikatsfingerprint und Config-Hash.
|
||
Der Agent wechselte selbst zu HTTPS; zwei frische HTTPS-Heartbeats und konkreter
|
||
Inventar-ACK nach beiden Verweigerungen tatsächlich gespeichert.
|
||
|
||
Gleiche Agent-/Asset-/Enrollment-/Zuordnungsversion und Dateien/ACLs, monotone
|
||
Sequenz, TenantB weiter verweigert. Kein neuer RMM-Job: Windows vor/nach
|
||
0Jobs/0Outbox/0Grants/0offen; Linux unverändert30/30/26/0. Zentrale Rootpolicy
|
||
unverändert. Beide realen Serverrollen danach mit Faultflagfalse und ohne
|
||
konfigurierten Fault-Dateipfad; exakte ursprüngliche WSS-Konfigurationsbytes und
|
||
ACLs auf Windows restauriert, wieder zwei frische WSS-Heartbeats/ACK0.
|
||
Dies ist keine Behauptung eines automatischen HTTPS→WSS-Switchbacks: Rückkehr
|
||
folgte aus der ausdrücklichen operativen Wiederherstellung der Konfiguration.
|
||
|
||
Ausgeführt: `python3 deploy/windows/auto_transport_acceptance.py start
|
||
--https-case 3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458`.
|
||
Sechs gezielte lokale Guards ergänzen den nativen Nachweis; kein neuer
|
||
Clientbuild und keine Windows-Syncbereitschaft erfunden. Geschützt:
|
||
`devstate/windows-client/auto-transport/2ff2e1aa-0037-4831-9bc2-31218bf1461c/result.json`,
|
||
verifiziert. Am Ende dieses Testfalls lief der Dienst wieder mit ursprünglichem
|
||
WSS. Die anschließende dauerhafte Auto-Umstellung ist oben separat dokumentiert.
|
||
|
||
## TLS-Negativfälle auf Windows nativ bestanden — 2026-11-13
|
||
|
||
Feste getrennte Fixture `7b190a5c-c928-4348-bd0d-c9698dad5417`, Schlüssel auf
|
||
Windows erzeugt und dort behalten. Nur öffentliche CSR zum bestehenden
|
||
Cloudsignierer, ausschließlich öffentliche CA-/Clientzertifikate zurück.
|
||
Unregistrierte gültige Kontrolle vor und nach den Negativfällen: tatsächliches
|
||
HTTP401 nach erfolgreichem TLS. Falsche CA: `TLS_UNKNOWN_ISSUER`; falscher
|
||
Servername: `TLS_SERVER_NAME_MISMATCH`; abgelaufenes Clientzertifikat:
|
||
`TLS_PEER_CERTIFICATE_EXPIRED`, jeweils ohne HTTP-Antwort. Alle fünf nativen
|
||
Probeprozesse mit dem gemeinsamen `https_channel::mtls_client` bestanden.
|
||
|
||
Dies sind ausdrücklich Admin-TLS-Proben, keine LocalService- oder
|
||
Rotationsabnahme. Der tatsächliche LocalService-HTTPS-Pfad ist separat unten
|
||
nachgewiesen. Permanenter Dienst samt PID/Startkonto, Identität, öffentliche
|
||
Zertifikatsdateien und private Schlüsseldateimetadaten vor/nach identisch.
|
||
Keine Dienstoperation, Registrierung, Jobs, Uhränderung oder TLS-Ausnahme.
|
||
|
||
Erster Lauf blieb bei unbekannt klassifiziertem CA-Fehler sicher verweigert.
|
||
Typinformation wurde in verschachtelten io::Error-Quellen übersprungen;
|
||
gezielter get_ref-Fix samt Test erkennt den echten Rustlsfehler, ohne Timeout,
|
||
Reset oder Fehlertexte als Zertifikatsablehnung zu werten. Ein Retest wurde
|
||
vor TLS durch einen Bootstrap-Witness-Timeout unterbrochen. Kurzer begrenzter
|
||
Witness und erneute Prüfung derselben unveränderten öffentlichen Fixtures
|
||
bestanden, ohne neue CSR/Signierung/Keyerzeugung. Alte Ergebnisse bleiben erhalten.
|
||
|
||
Verifiziertes Ergebnis unter
|
||
`devstate/windows-client/tls-negative/7b190a5c-c928-4348-bd0d-c9698dad5417/typed-retest-6dd51cc0-deb5-4020-afee-58dbb716cdbb/result.json`.
|
||
Qualifizierte Probe SHA256
|
||
`33eb56500908a88e3ff30cc1e61f9416e38d94fbf27633ac6dfaf9903cd4ef1b`:
|
||
gelockter Windows-GNU-Releasebuild, Clippy mit-Dwarnings, gezielter verschachtelter
|
||
TLS-Fehlertest und Python-/PowerShell-Parserprüfungen bestanden.
|
||
Ausgeführt: `python3 deploy/windows/tls_acceptance.py --execute-native-tls-negative
|
||
--artifact devstate/windows-client/WindowsTlsProbe.exe --resume-case
|
||
7b190a5c-c928-4348-bd0d-c9698dad5417`.
|
||
|
||
## 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.
|
||
TLS-Negativfälle und automatischer Fallback sind oben separat nativ abgenommen.
|
||
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 und automatischer Fallback sind inzwischen oben separat nativ
|
||
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.
|