Share signed job core and verify native Linux then Windows contracts
Rust development slice / linux (push) Failing after 6s
Rust development slice / linux (push) Failing after 6s
This commit is contained in:
@@ -52,6 +52,17 @@ Zugänge und private Rohbelege bleiben gitignoriert.
|
||||
|
||||
## Aktuelle Windowsfortsetzung
|
||||
|
||||
**Fortsetzung 2026-11-14:** Gemeinsamer `rmm-agent-core` und Linuxadapter
|
||||
implementiert. Eigene Core-Unittests zuerst auf Cloud-Linux (25) und danach auf
|
||||
Windows (24) nativ ohne Skip bestanden; Fall
|
||||
`4bc4db12-2990-4e93-bb86-8fbd94b691fb`. Geschützte Manifest-/Quell-/Artefaktbindung
|
||||
in `devstate/shared-core/acceptance/<Fall>/`. Keine Dienst-/Serverersetzung oder
|
||||
Jobwirkung durch diese Tests. Native Dienstintegration, vertrauenswürdige Uhr
|
||||
und erste tatsächliche WebUI-genehmigte PowerShell-Strecke bleiben offen.
|
||||
Server/Domain/WebUI unterstützen lokal geprüft feste Plattformvarianten;
|
||||
Clouddeployment steht noch aus. Vollständiger Restumfang:
|
||||
[Windows-Gates](windows-gates.md), [Umsetzungsplan](windows-remaining-implementation.md).
|
||||
|
||||
Der bestehende Windows-11-LocalService bleibt passiv: gleiche Geräteidentität,
|
||||
Telemetriehistorie und Schlüssel; keine Jobs, Outbox oder Startgrants. Native
|
||||
WSS-/Inventar-/Tenantnachweise und sieben Rusttests liegen vor. Explizites HTTPS
|
||||
|
||||
@@ -1,5 +1,37 @@
|
||||
# Tatsächlicher Implementierungsstand
|
||||
|
||||
## Gemeinsamer Jobkern nativ auf Linux und Windows geprüft — 2026-11-14
|
||||
|
||||
Der neue `rmm-agent-core` enthält die gemeinsame signierte Sync-/Checkpoint-
|
||||
Maschine, Permit-/Request-/Outcome-Codecs, Verbrauchsledger und portable
|
||||
Jobpersistenz. Linux verwendet diese Implementierung über dünne Adapter;
|
||||
seine bisherige OpenSSL-Verifikation bleibt erhalten. Windows verwendet Dalek,
|
||||
ohne OpenSSL-Abhängigkeit. Die bisherigen Linux-Codecbytes bleiben unverändert.
|
||||
|
||||
Tatsächlich bestanden: 151 betroffene lokale Rusttests und Clippy; danach im
|
||||
eigenen Fall `4bc4db12-2990-4e93-bb86-8fbd94b691fb` zuerst 25 native
|
||||
Core-Unittests auf der Cloud-Linux-VM, anschließend 24 auf der Windows-VM,
|
||||
jeweils ohne Skip. Quell-/Artefakthashes und vollständige Ausgabe bleiben in
|
||||
geschützten Manifesten und `devstate/shared-core/acceptance/<Fall>/` erhalten.
|
||||
Die unterschiedlichen Zahlen entstehen durch den zusätzlichen Unix-OpenSSL-
|
||||
Paritytest. Diese Programme verwenden ausschließlich eigene SQLite-Fixturen,
|
||||
Testsignaturen und simulierte Clock/Channel-Objekte. Kein RMM-Job, Dienstwechsel,
|
||||
Enrollment oder Netzwerkpfad wurde damit ausgeführt. Ein nativer Sync des
|
||||
laufenden Dienstes mit dem extrahierten Kern bleibt separat nachzuweisen.
|
||||
|
||||
Server/Domain/WebUI sind additiv für feste Windows-/Linux-Skriptvarianten und
|
||||
Windows-Basisinventur vorbereitet. Gemeinsame Plattform-/Capabilityprüfung bei
|
||||
Planung, erneuter Prüfung, Grant und Zustellung; vor Genehmigung unverändert
|
||||
0 Jobs/Outbox/Grants. Exakte stdout-Nachbedingungen lassen sich als JSON-String
|
||||
einschließlich CRLF eingeben. Lokal bestanden: 14 Domainfälle einschließlich
|
||||
Linux-Goldenbytes, Variantenprüfung, isolierter PostgreSQL-Test mit Migrationen
|
||||
und Tenant-/Capability-Verweigerungen, Clippy sowie 29 Webtests/Typecheck.
|
||||
Dies ist noch kein Clouddeployment oder Windows-Ausführungsnachweis.
|
||||
|
||||
Windows-Dienst, Identität und bisherige passive Capabilities blieben bei diesem
|
||||
Schritt unverändert. Clock-, Executor-, Helper-, Paket- und übrige native
|
||||
Windows-Abnahmen laufen weiter; die Plattform meldet dafür keinen Erfolg.
|
||||
|
||||
## Windows: dauerhaftes Auto auf bestehender VM nativ bestanden — 2026-11-13
|
||||
|
||||
Separater Fall `422562e8-18eb-4865-977d-ab2af65f510b` verifiziert und abgeschlossen.
|
||||
|
||||
@@ -11,7 +11,7 @@ bleibt eine eigenständige Abnahme. Dieser Bericht erweitert dessen Umfang nicht
|
||||
| Passiver Client | SCM-Dienst, Service-SID/ACLs, Enrollment/mTLS/WSS, Inventar mit Quelle/Zeit, Heartbeats und Mandantentrennung nativ bestanden; sieben native Rusttests. | Bestehende Identität und Telemetriehistorie bei allen weiteren Schritten erhalten. |
|
||||
| HTTPS/Fallback | Explizites HTTPS und automatischer Fallback nach zwei tatsächlichen mTLS-WSS503 unter LocalService nativ bestanden, jeweils mit frischen Heartbeats und Inventar-ACK. Testhooks geschlossen. Anschließend bestehende VM separat dauerhaft auf `auto` gestellt und bevorzugtes WSS erneut mit zwei frischen Heartbeats/ACK geprüft; Identität und ACLs erhalten, 0 Jobs/Grants. | Transportnachweise abgeschlossen; kein automatischer HTTPS→WSS-Switchback nachgewiesen. Installerdefault ebenfalls `auto`, aber keine neue Installationsabnahme. |
|
||||
| TLS-Lifecycle | Falsche CA, falscher Name und abgelaufenes Clientzertifikat mit gültigen Kontrollen nativ als getrennte Admin-TLS-Proben bestanden. Permanente Identität/Dienst unverändert. | Rotation und Widerruf noch gesondert sicher implementieren und prüfen. Permanente Identität nicht widerrufen oder ersetzen. |
|
||||
| Signierter Jobkern | Windows verweigert Jobangebote/Grants ausdrücklich und meldet keine Ausführungscapability. | Gemeinsamen Sync-/Checkpoint-/Einmalverbrauchskern portieren; vertrauenswürdige Uhr, Journalmigration ohne Reset, Schlüsselbindung und Fehlerpfade qualifizieren. |
|
||||
| Signierter Jobkern | Gemeinsamer Core und Linuxadapter implementiert; native Core-Unittests zuerst Linux (25), dann Windows (24) bestanden. Bestehender Windows-Dienst bleibt passiv und verweigert Jobs/Grants. | Native Dienstintegration, vertrauenswürdige Uhr, erhaltende Journalmigration und vollständige Startgrenze qualifizieren. Unit-Fixturen ersetzen keinen tatsächlichen Jobnachweis. |
|
||||
| PowerShell | Noch kein Executor oder freigegebener Interpreter. Server/UI lösen derzeit Linuxvarianten auf. | Exakte Windows-PowerShell-5.1-Bytes, Ausgabeencoding, Prozessgrenzen und unprivilegierte Ausführungsidentität binden. Erst nach vollständigem Antrag und tatsächlichem WebUI-Klick ausführen. |
|
||||
| Privilegierte Aktionen | Kein Windows-Helper, keine Named-Pipe-Aktionsschnittstelle. | Eigenständiger restriktiver Helper mit geprüfter Pipe-Identität und unabhängiger Signatur-/Plan-/Grantprüfung; keine SYSTEM-Netzwerkkomponente. |
|
||||
| Pakete/Dienste/Logs | Noch keine native Windows-Aktionsabnahme. | Begrenzte geprüfte MSI-/EXE-Rezepte, Dienst-/Eventlogadapter und unabhängige Nachbedingungen. Keine allgemeinen Installershellstrings oder impliziten Reboots. |
|
||||
|
||||
@@ -0,0 +1,237 @@
|
||||
# Windows: verbleibende Umsetzung nach der passiven Foundation
|
||||
|
||||
Stand 2026-11-14, Spezifikation1.15. **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.
|
||||
Reference in New Issue
Block a user