Files
rust-discovery/docs/windows-remaining-implementation.md
2026-11-14 06:11:00 +01:00

238 lines
17 KiB
Markdown
Raw Permalink 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: verbleibende Umsetzung nach der passiven Foundation
Stand 2026-11-14, Spezifikation1.17. **Umsetzungsplan, keine native Abnahme.**
Linux-M0–M5 bleiben separat abgeschlossen. Der Windows-Testgast ist ein eigenes
Gerät; das Notebook bleibt Entwicklungsrechner. Server bleibt
`discovery.ease-technologies.de`. RustDesk, PVE und M7 werden nicht vorgezogen.
Diese Planung erstellt weder Jobs noch Grants und verändert keine Zielmaschine.
Die passive Windowsstrecke umfasst bereits LocalService, Enrollment/mTLS,
WSS/HTTPS/Auto-Fallback und gespeicherte Telemetrie. TLS-Negativproben als
Bootstrapadministrator ersetzen keine LocalService-Negativprobe oder Rotation.
Der gemeinsame Agentkern und die additive Plattform-/Interpreterplanung werden
aktuell separat qualifiziert. Keine daraus abgeleitete Windowscapability oder
Jobbereitschaft behaupten. Vor dem ersten Hello gelten weiterhin
[Jobgrenze](windows-job-boundary.md) und [Windows-Gates](windows-gates.md).
## Reihenfolge mit konkreter Lieferung
| Schritt | Kleinste lauffähige Lieferung | Eigener nativer Nachweis |
| --- | --- | --- |
| W1 unprivilegierte Jobs | Konfigurierte Signingbindung, TrustedClock, gemeinsamer signierter Sync, erhaltendes Jobjournal und begrenzter PowerShell5.1-Executor unter LocalService. | Fester UI-Hello mit exakten Rohbytes; Live-Inventur; ACK/Redelivery, Offline/Frist/Entzug, Prozessabbruch und gesperrter Wiederanlauf. Keine SYSTEM-Ausnahme. |
| W2 Helpergrenze | Ein lokaler SYSTEM-Dienst ohne Netzwerklistener, wechselseitig authentisierte Named Pipe, eigenes geschütztes Ledger, unabhängige Signatur-/Sync-/Policyprüfung. Zunächst alle Wirkungen verweigert. | Erreichbarkeit aus dem eigenen LocalService, fremde SID/PID, Pipebesetzung, falsche Signatur/Generation/Hash/Frist und volle Journale verweigert; keine Wirkung. |
| W3 Dienst und Logs | Nur eigener ungefährlicher Fixturedienst; SCM-Aktion und begrenzter Event-Log-Provider. | Je eigener UI-Plan für Start/Stop/Nachprüfung und Live-Logfenster, unabhängige OS-Nachprüfung; sensible/fremde Quellen verweigert. |
| W4 MSI und EXE | Je ein geprüftes, kleines Fixture-Rezept, feste Versionen1.0/1.1, eigener Produkt-/Dateinachweis, kein Reboot. | Native Installation, Upgrade und Noop je festem UI-Plan; Paketbestand/Nutzdateien unabhängig prüfen. MSI und EXE sind getrennte Providerabnahmen. |
| W5 Wiederaufnahme und Reboot | Bewahrte Originalaufträge/Marker; genau ein ausdrücklich erlaubter Windows-Reboot mit ursprünglichem Grant und neuer Bootkennung. | Kein blindes Wiederholen nach Wirkung; rechtzeitiger unabhängiger Wiederkontakt, zusätzlicher frischer Verifikationsbeleg und normaler signierter Abschluss. |
| W6 Abschluss der Windowsmatrix | Rotation/Widerruf auf getrennter Testidentität, Windows/Linux-Mischplan AT-15, geprüfte unterstützte Inventarquellen, Windows-Installer-/Signiernachweis. | Keine Ableitung aus Linux-/Cross-Build-/Adminproben. Offene Betriebssystemupdate-/Patchfähigkeiten sichtbar lassen, bis ihr eigener Provider und Umfang geprüft sind. |
Jeder Schritt endet mit tatsächlichem Bericht und eigenem Commit/Push. Neue
Wirkungsversuche benötigen neue UI-Pläne. Ein fehlgeschlagener Versuch bleibt
fehlgeschlagen, Unknown bleibt gesperrt bis zum gebundenen Abgleich. Die Tabelle
ist keine pauschale Erlaubnis, Installationen oder einen Windows-Reboot auszuführen.
## Gemeinsamer Nachweisvertrag, Windowsadapter
Bestehende Bytes von `agent-core::auth::{Binding,Request,Outcome}`,
`ExecutionPermitPayload`, Job-/Planhashes und Signaturdomain bleiben erhalten.
Der Helper erhält denselben vollständigen Request wie der Agent und prüft ihn
selbst: Gerät/Kunde/Zuordnung, genaue Jobbytes, Genehmigungsreferenz,
Signierschlüssel, kurze Startfrist und Clock. Vor Wirkung hält er die eigene
Ressourcensperre und persistiert Grant-/Versuchsverbrauch samt Originalboot und
Originalrequest. Gleicher Versuch mit neuer Grant-ID ist keine neue Erlaubnis.
Ergebnis bleibt bis konkretem ACK; `unknown` und `awaiting_reboot` geben den
Verbrauch nicht frei. Der aktuelle gemeinsame Ledgerkern begrenzt SQLite bereits
auf1GiB/4096-Byte-Seiten und ignoriert keine Kapazitätsfehler.
`privileged-helper/src/reconcile.rs` und `control.rs` enthalten derzeit weiterhin
Unix-Datei-/Peerzugriff, OpenSSL und Linux-Boot/Clock. Sie sind kein fertiger
Windowshelper. Deren reine Helper-Abgleichregeln werden wie der Agentkern in
einen gemeinsamen Kern mit Ports für Dateisperre/Dateiidentität, Clock, Boot und
Verifier extrahiert; Linuxbytes und vorhandene Goldenfixtures bleiben identisch.
Keine zweite abweichende Syncmaschine, kein lokales `ready=true` als Ersatz.
Windows bindet Volume-/File-ID der offenen Ledger-/Sperrhandles; Unix-`dev/ino`
werden nicht erfunden. Helper-Snapshot/Apply prüfen die ursprünglichen signierten
Entscheidungsbytes und frische Challenge-/Generationsbindung unabhängig.
Die lokale Windowskonfiguration ist ein neuer, ausdrücklich benannter
SYSTEM-Policyvertrag, kein Linux-Rootpolicyprofil unter anderem Namen. Sie bindet
festes Gerät, Signierschlüssel, Agent-/Helperservice-SIDs, erlaubte Aktionen,
exakte Fixturedienste/Rezepthashes/Logkanäle, Laufzeitgrenzen und
`allow_reboot=false` als Default. Policyhash und Helperbuild müssen im
Readinessnachweis und in der zentralen Zielpolicy übereinstimmen.
## Named Pipe und Identitäten
Ein fest benannter lokaler Pipeendpunkt verwendet explizite DACL,
`PIPE_REJECT_REMOTE_CLIENTS`, `FILE_FLAG_FIRST_PIPE_INSTANCE` beim ersten Server-
Handle und zeitbegrenzte Overlapped-I/O. Keine Default-DACL: Microsoft beschreibt
sonst zusätzliche Lesezugriffe für Everyone/Anonymous. Die Agent-SID erhält nur
die konkreten benötigten Daten-/Attributrechte, kein generisches Schreibrecht,
das zugleich die Erstellung weiterer Pipeinstanzen erlauben kann.
[Pipe-Rechte](https://learn.microsoft.com/en-us/windows/win32/ipc/named-pipe-security-and-access-rights),
[CreateNamedPipeW](https://learn.microsoft.com/en-us/windows/win32/api/namedpipeapi/nf-namedpipeapi-createnamedpipew).
Der Helper liest zunächst nur einen begrenzten Frame, prüft den tatsächlichen
Client-PID und impersonierten Token: LocalService **und** eigene aktivierte
Service-SID, SCM-Prozess und gehaltenes Prozesshandle/Startidentität. LocalService
allein genügt nicht, da weitere Dienste dieses Konto nutzen können. Der Agent
prüft umgekehrt Server-PID, SYSTEM-Token, erwartete Helperservice-SID, SCM-Bindung
und geschützte Helperbinary. PID allein ist wegen Wiederverwendung kein Beleg.
Diese Kombination ist die vorgeschlagene Projektprüfung, keine Garantie einer
Einzel-API. Fehlgeschlagene Impersonation verweigert; vor Handlerausführung
`RevertToSelf` sicherstellen. Keine Kindprozesse unter versehentlich verbliebener
Impersonation starten.
[Client-PID](https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-getnamedpipeclientprocessid),
[Server-PID](https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-getnamedpipeserverprocessid),
[Impersonation und Fehlerfall](https://learn.microsoft.com/en-us/windows/win32/api/namedpipeapi/nf-namedpipeapi-impersonatenamedpipeclient).
Helperstate und Konfiguration sind SYSTEM/Administrators-geschützt; der
Netzwerkagent kann sie nicht ersetzen. Bestehende Gerätekeys bleiben beim Agenten,
der Helper erhält ausschließlich die provisionierte öffentliche Signingbindung.
Ein eigener Windowshelper-Binarypfad innerhalb der Windowscrate vermeidet
Unix-Abhängigkeiten des Linuxhelper-Binaries. Bereits vor dem ersten autorisierten
Systemjob müssen Pipeauthentisierung und unabhängiger Sync nativ bestanden sein.
## Minimaler additiver Aktions-/Manifestvertrag
Vorgeschlagen ist ein optionales `windows_manifest` am `JobPayload` mit
`default`/`skip_serializing_if=None`; Linuxjobs behalten exakt ihre historischen
Bytes. Noch keine neue produktive Schemaversion oder Policyentscheidung.
Manifesttyp `rmm.windows.execution`, eigene Version1, strikte Felder:
| Feldgruppe | Inhalt/Prüfung |
| --- | --- |
| Ziel und Auftrag | Kunde, Asset, Agent, Enrollment-/Assignmentgeneration, Job, Versuch und Action; müssen exakt dem Job entsprechen. |
| Runtime/Policy | Plattform/Architektur, Manifestversion, Helperpolicyhash und abgenommene Providerkennung. Keine vom Agenten gewählte Policy. |
| Rezept | Bei Paketaktionen unveränderliche Rezept-ID/-Version/-SHA, Produkt/Version/Installationskontext, Artifact-ID/-SHA/-Länge, fester strukturierter Argumentvektor, feste Exitklassifikation und typisierte Nachbedingungen. |
| Systemaktion | Bei Dienst/Log/Reboot ausschließlich die erforderlichen typisierten Felder und Nachbedingungen; kein Paketmanifest als allgemeiner Shellcontainer. |
Kein `job_payload_hash` innerhalb des Manifests: dieser würde sich selbst
referenzieren. Der Startgrant bindet den Hash des **gesamten** Jobpayloads samt
Manifest. Unbekannte Felder/Provider, widersprüchliche Actionparameter,
abweichende Recipe-/Artifactbytes oder fehlende Nachbedingungen verweigern vor
Verbrauch/Wirkung. Neue Windowsfelder sind Pflicht nur für die entsprechenden
Windowsaktionen; alte APT-Manifeste werden nicht umgedeutet.
Bestehende Fachaktionen bleiben `ensure_package`, `apply_updates`,
`set_service_state`, `query_logs` und `reboot`. Windowsprovider werden additiv
validiert, mit eindeutiger Plattformbindung. `system` wäre ein neuer expliziter
Ausführungsidentitätswert mit eigenem `system:execute`-Recht und eigener
SYSTEM-Policy; Linux-`root` bedeutet niemals Windows-SYSTEM. Freie SYSTEM-Skripte
sind kein notwendiger Ersatz für typisierte Aktionen. Capabilitynamen und genaue
Manifestfelder erst gemeinsam mit Helper/Server festschreiben; keine
Capabilities anbieten, bevor der tatsächliche Adapter bereit ist.
Für Windowsrezepte empfiehlt sich eine eigene immutable Tabelle mit Tenant-RLS,
zusammengesetzten Tenant-FKs und getrennten MSI-/EXE-Kennungen. Der aktuelle
APT-Katalog ist auf `architecture='amd64'` und APT-Abfragen beschränkt; seine
Schlüssel dürfen nicht still für Windowsprodukte wiederverwendet werden.
Bestehende Artifactreferenzen/Hashes können erhalten bleiben. Das aktuelle
Artifactlimit beträgt256KiB: kleine Fixtureartefakte zunächst dagegen prüfen;
eine notwendige größere, begrenzte Übertragung wäre eine eigene implementierte
und getestete Vertragsänderung, kein Bootstrap-SFTP als RMM-Paketnachweis.
## Providerverhalten und überprüfbare Wirkung
**MSI:** Feste systemweite Installation aus dem Helper-eigenen geschützten Cache;
`msiexec /i <fester-cachepfad> /qn /norestart REBOOT=ReallySuppress`, ergänzt nur
um die im Rezept gebundenen Properties. Keine URL, UNC-Quelle, frei gewählte
Transformdatei oder weitere Installerargumente. Nach dem Kopieren erneut hashen,
Pfadkomponenten/Reparsepoints und Schreibrechte prüfen, während der Nutzung
Ersetzung/Änderung verweigern. `0` ist nur ein Prozessresultat; `3010` bedeutet
Neustartbedarf. `1641` meldet bereits eingeleiteten Neustart und verletzt diesen
No-Reboot-Rezeptvertrag; nicht als normale erfolgreiche Abnahme werten.
`1618` respektiert fremde Installation, kein Beenden fremder Prozesse.
[Installeroptionen](https://learn.microsoft.com/en-us/windows/win32/msi/standard-installer-command-line-options),
[REBOOT](https://learn.microsoft.com/en-us/windows/win32/msi/reboot),
[Exitcodes](https://learn.microsoft.com/en-us/windows/win32/msi/error-codes).
Nachprüfung kombiniert `MsiGetProductInfoExW` im expliziten Machine-Kontext
mit installiertem Produktzustand/Version und eigener Fixture-Nutzdatei samt Hash.
Ein beworbenes Produkt ist nicht automatisch installiert. Keine
`Win32_Product`-Erhebung. MSI-Fehler, Timeout oder verlorener Installerkontakt
belegen keine Abwesenheit einer Teilwirkung: gegebenenfalls Unknown und ein
gebundener Nur-Lese-Abgleich, keine automatische neue Installation.
[Produktinformation und Kontext](https://learn.microsoft.com/en-us/windows/win32/api/msi/nf-msi-msigetproductinfoexw).
**EXE:** Eigenes, nachvollziehbar gebautes Fixture mit genau dokumentierten
Quiet-/No-Reboot-Argumenten, Hash, Architektur und Exitsemantik. MSI-Codes gelten
nicht automatisch für EXE. Ausschließlich verifizierte feste Rezeptparameter;
kein beliebiges EXE als SYSTEM ausführen. Nachprüfung über eigene Registry-
Produktkennung und Nutzdatei/Version/Hash. No-Reboot-Flags schützen nicht gegen
beliebige bösartige SYSTEM-Customactions: die ausdrücklich geprüfte Herkunft und
der begrenzte Rezeptumfang bleiben erforderlich. Ein Timeout beendet nicht
pauschal einen systemweiten Installationsdienst oder fremde Installer.
**Dienste:** `OpenSCManager/OpenService` mit benötigten Einzelrechten,
`StartServiceW`/`ControlService`, danach begrenztes Warten und unabhängiges
`QueryServiceStatusEx`. Startannahme ist nicht gleich Running. Zustandsübergänge,
Checkpoint/WaitHint, Dienstexit und fehlende Rechte strukturiert melden.
Abnahme zunächst nur am eigenen Fixturedienst mit festem Binaryhash; nicht am
RMM-Agenten, SSH oder einer fremden Produktionskomponente.
[StartServiceW](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-startservicew),
[Status](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-queryservicestatusex),
[SCM-Rechte](https://learn.microsoft.com/en-us/windows/win32/services/service-security-and-access-rights).
**Event Log:** Eigener Kanal-/Providerfilter und fixes Zeitfenster; keine freie
Datei, kein roher vom Modell gelieferter XPath. `EvtQuery/EvtNext/EvtRender`,
maximal1000Events/256KiB und Laufzeitlimit. Quelle, EventRecordID, Provider,
UTC-Zeit, Fehlermeldungen und Trunkierung erhalten; fehlender Zugang bleibt
permission_denied. Bookmark erst nach dauerhafter Übernahme/konkretem ACK
fortschreiben. Einzelnes Livefenster ist ein UI-genehmigter Diagnosejob;
gespeicherte Ergebnisse danach tenantgebunden lesen. Kein allgemeiner Zugriff
auf Security-Kanäle durch die Abnahme eines Fixturekanals.
[Eventabfragen](https://learn.microsoft.com/en-us/windows/win32/wes/querying-for-events),
[Bookmark](https://learn.microsoft.com/en-us/windows/win32/api/winevt/nf-winevt-evtupdatebookmark).
**Reboot:** Nur lokales `InitiateSystemShutdownExW`, fest gebundene Begründung,
keine erzwungene Schließung fremder Anwendungen, eigenes gezielt aktiviertes
Shutdownprivileg im Helper. Dauerhaften Originalverbrauch und Bootbeleg zuerst
speichern. APIannahme ist asynchron und kein Erfolgsnachweis; Anwendungen können
den Vorgang verzögern/verhindern. Konservative zentrale Frist ab Startreservierung
und beide bestehenden Inventarbelege gelten unverändert. Die bisherige
CIM-LastBootUpTime-basierte Windowskennung muss einen tatsächlichen OS-Reboot von
Agent-/Helperneustart und Zeitänderung unterscheiden; aktuelle wiederholte
Abfrage allein beweist das noch nicht.
[Shutdown-API und Einschränkungen](https://learn.microsoft.com/en-us/windows/win32/api/winreg/nf-winreg-initiatesystemshutdownexw).
## Dateien und Freigaben vor nativer Wirkung
Geplante Änderungen, **hier nicht umgesetzt**:
- `crates/domain/src/windows_execution.rs`, `jobs.rs`: strikte Manifest-/Rezept-
und Identitätsprüfung, optionale Jobfelder, erhaltene Linuxgoldenbytes.
- `crates/agent-core`: reiner Helper-Abgleich mit Plattformports;
`crates/privileged-helper`: bestehender Linuxadapter gegen unveränderte Verträge.
- `crates/agent-windows/src/{helper,pipe,service_provider,event_log,package,reboot}.rs`
und eigenes Helperbinary: nur tatsächlich gelieferte Provider anlegen, keine
leeren Stubs; SCM-/IPC-/Datei-/Clockadapter und eigenes Ledger.
- Server `jobs`, `root_policy` oder neue explizite `windows_policy`, `catalog`,
`job_gateway`, `synchronization`: Rechte/Caps an jeder Grenze und unabhängiger
Rebootabschluss; neue RLS-Migration nur für tatsächlich benötigte Windowsrezepte.
- WebUI/Schemas: vollständige unveränderliche Rezept-/Manifest-/Rebootpreview,
keine neue Genehmigungsabkürzung; dieselben Anwendungsfälle für HTTP und MCP.
- `deploy/windows`: erhaltender Helperbootstrap, kleine geprüfte Fixturequelle/
Rezeptartefakte, geschützte native Nachweisrunner und tatsächliche Requalifikation.
Reversible Entwicklung, Builds und Bootstrapvorbereitung sind im Auftrag.
Konkrete native Paket-/Dienstwirkungen brauchen jeweils den fertig einsehbaren
festen dev/test-UI-Plan. Ein Windows-VM-Reboot ist eine gesondert konkret zu
vereinbarende Zielaktion; der frühere einzelne Linux-Reboot erlaubt ihn nicht.
Kein pauschales „alles okay“ anfordern: zuerst Artefakt, Rezept, Ziel, Plan,
No-Reboot-Vertrag, Nachprüfung und Wiederaufnahme vorbereiten, dann nur die
wirklich fehlende konkrete Freigabe klären. Ein Installerfehler berechtigt weder
Markerreset noch zweiten Versuch. Nach jedem Abnahmeschritt dokumentieren/pushen.
Zur vollständigen Windowsabnahme zählen außerdem bisher offene Rotation/
Widerruf, Installer-/Signierstatus und plattformspezifische Fehlerfälle.
MSI-/EXE-Fixtureupdates sind kein Nachweis von Windows-OS-/Kernelupdates.
Ein WUA-Provider benötigt eigene COM-Threads, versionierte Scan-/Update-IDs,
Updateeinzelergebnisse und eigene Start-/Nachprüfung; solange nicht geliefert
bleibt diese Capability unsupported. Microsofts Beispiele sind keine fertigen
Produktprovider: [WUA-Vertrag](https://learn.microsoft.com/en-us/windows/win32/wua_sdk/using-the-windows-update-agent-api).
Diese Grenzen dürfen bei einem späteren „Windows vollständig“ nicht verschwinden.
Für diesen Plan wurden ausschließlich Repositoryquellen und die verlinkten
Microsoft-Primärquellen gelesen. Keine neuen Tests, Builds, Dienste,
Installationen, Genehmigungen oder VM-/Serverkontakte ausgeführt.