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

66 lines
4.0 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/`.
## Implementiert, Dienst-/Online-Abnahme noch offen
- Nativer SCM-Dienstlebenszyklus, vorgesehen 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.
Dieser erste Entwicklungsbuild ist **unsigniert**. Kein produktiver signierter
Installer/MSVC-Supportnachweis, keine Zertifikatsrotations-/Widerrufs-/Proxy- oder
Windows-Paket-/Dienstaktionsabnahme. Native Testprogramme sowie die tatsächliche
SCM-/Enrollment-/mTLS-/Inventarstrecke sind zum Zeitpunkt dieses Abschnitts noch
offen. Ein erfolgreicher Crossbuild bzw. `--native-probe` ersetzt sie nicht.
## 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.
Geplant, noch nicht als bestanden behauptet: native Testprogramme und
`Install-PassiveClient.ps1` über `client_bootstrap.py install`, anschließend
zwei frische Heartbeats, korrekt zugeordnetes Inventar und Tenant-B-Verweigerung.
Installation ist create-only; bei Teilfehlern Zustand inspizieren und erhalten,
nicht blind neu enrollen oder den Bootstrap wiederholen.