Files
rust-discovery/docs/windows-remaining-implementation.md
T
2026-11-14 04:41:09 +01:00

17 KiB
Raw Blame History

Windows: verbleibende Umsetzung nach der passiven Foundation

Stand 2026-11-14, Spezifikation1.16. 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 und Windows-Gates.

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, 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, Server-PID, Impersonation und Fehlerfall.

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, REBOOT, Exitcodes.

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.

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, Status, SCM-Rechte.

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, Bookmark.

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.

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. 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.