Files
rust-discovery/docs/windows-system-delegation-source.md
2026-11-14 07:43:36 +01:00

158 lines
10 KiB
Markdown

# Windows-SYSTEM-Delegation: Quellenstand
Stand2026-11-14, Spezifikation1.17. Dies ist ein implementierter **Kandidat zur
Sourceprüfung**, keine native Dienst-/IPC-/SCM-Abnahme. Die produktive Clock-
Qualifikation, Jobkonfiguration, Helperwirkung und veröffentlichten Fähigkeiten
bleiben deaktiviert. Der vorhandene Windowsgast und der endgültige Cloudserver
bleiben die Ziele; der Notebookhost bleibt Entwicklungsrechner.
## Implementierter Ablauf
Der Netzwerkagent persistiert vor einer möglichen Übergabe einen eigenen festen
SYSTEM-Intent mit den unveränderten vertraulichen Originalrequestbytes,
Originalgrant, Boot-/Agentinstanz-/Verbindungskontext und dem tatsächlich vom
Helper zurückgegebenen historischen Readyanker. Die Daten werden nicht in
Logs oder MCP-Ausgaben exportiert. Ein Intent ist noch kein Helperverbrauch.
Dispatcher und Cancellation verwenden dieselbe dauerhafte SQLite-CAS:
`prepared` wird ausschließlich `known_no_dispatch` oder `may_have_dispatched`.
Nach einem May-Marker gibt es weder Execute-Redelivery noch eine Umklassifikation
zu bekanntem Nichtstart. Ein weiterer Start bleibt gesperrt. Lokale Consumption
entsteht nicht mehr vor der SYSTEM-Übergabe. Nach einem IPC-Ausgang wird zunächst
ehrliches Unknown mit dem **Originalgrant** gespeichert.
Der separate strikt dekodierte Helpervorgang Abandon führt keinen Fixture-SCM-
oder Provideraufruf aus. Die lokale Allowlist wird nur logisch geprüft. Der
geschützte Adapter liest gezielt den tatsächlichen festen Intentstore und dessen
Known-CAS. Der gemeinsame Helperkern prüft unabhängig Signatur, aktuelle echte
Clock, ursprünglichen Boot, exakten alten Readyanker und erhaltene Lineage.
Zusätzlich bindet der Windowsguard eigene Kernel-PID, Prozessstart, Image-Datei-ID
sowie Ledger-/Lock-Datei-IDs. Ein neuer Nichtstart braucht dieselbe Helperinstanz;
neue Instanzwerte ersetzen niemals den alten Anker. Vorhandene Verbräuche und
Outcomes werden nicht überschrieben.
Ein bereits dauerhaft bekannter Nichtstart darf nach Agentneustart genau einen
deny-only Abandon-Abgleich pro **neuer** Agentinstanz versuchen. Ein eigener
unveränderlicher Resume-Beleg steht vor diesem RPC. Danach folgt immer ein
frischer RawSnapshot. Eine verlorene Antwort erlaubt in derselben Instanz nur
weitere Snapshotabfrage. May-Marker und bloß vorbereitete unterbrochene Intents
bleiben konservativ Unknown/manuell gesperrt.
## Spiegelung und Crashgrenzen
Auch eine erfolgreiche Execute-/Abandonantwort ist kein Mirrorbeleg. Der Adapter
verlangt einen frischen unabhängig authentisierten rohen Helpersnapshot und
prüft das vollständige Originaltupel einschließlich Autorisierung, Plan, Aktion,
Identität, Originalboot und Hash des unveränderten Requestcodecs. Dazu kommen
kanonische Outcomebytes/Hash/Zustand, Output-/Rebootgrenzen und bei Erfolg die
exakten SCM-Nachbedingungen. Fehlender Helperversuch wird nicht ergänzt oder
als Nichtstart umgedeutet.
Die **Helper-Abandontransaktion** schreibt Consumption, Originalstartzeugen und
festen NoEffect-Outcome atomar. Die **Network-Spiegelung** benutzt dagegen die
vorhandenen gemeinsamen APIs: `begin_execution` speichert c+start atomar;
anschließend wird der unabhängig nachgewiesene Outcome persistiert. Ein Crash
dazwischen bleibt gesperrt und wird nur aus einem erneut frisch authentisierten
RawSnapshot fortgesetzt. Eine vorhandene exakt passende Originalzeile wird
idempotent akzeptiert, abweichende Daten werden verweigert. Erst nach vollständiger
Spiegelung darf der unveränderte gemeinsame Sync fortfahren. Keine Missing-Row-
Prüfung wurde für diesen Adapter gelockert.
Ein tatsächlicher gebundener Helper-Unknown wird vor dem gemeinsamen Sync auch
im Jobjournal kanonisch gespeichert. Ein pauschaler Transport-Unknown darf nicht
neben einem anderen tatsächlichen Unknown im Verbrauchsledger stehen bleiben.
Der Abgleich prüft dafür auch bereits gespiegelte Intents erneut anhand des
frischen RawSnapshot. Beim Startup wird ein schon gespeicherter tatsächlicher
Outcome erhalten; ein identischer terminaler Jobjournalbeleg wird nicht erneut
als Zustandsübergang geschrieben. Der neue enge Regressionsfall bildet Unknown-
Abweichung und wiederholten Startup nach der Mirror-Crashlücke ab. Archivierung
ist keine ACK-Verarbeitung und löscht keine ausstehenden Events.
Die Network-Reservierungszeit bleibt der tatsächlich gespeicherte Intentzeitpunkt.
`mirror_observed_at` wird separat gespeichert; weder dieser Wert noch der
Snapshotzeitpunkt wird als unbekannte native Helper-/SCM-Startzeit dargestellt.
## Geschützte Bootstrapgrenze
`deploy/windows/system_intent_bootstrap.py` wurde nach unabhängiger Sourceprüfung
im Fall `f322a4d2-c537-4842-bf04-658ad8f814b0` tatsächlich auf der Windows-VM
ausgeführt. Quelle SHA256 `7597ac0f…`. Sie erzeugte ausschließlich den festen Ordner
`C:\ProgramData\RustDiscoverySystem\agent-intents` und die beiden vorab angelegten
Leaves `system-intents.sqlite` und `system-intents.sqlite-journal`. SYSTEM/Admins
bleiben Besitzer; der Agent-Service-SID erhält Verzeichnis-RX und auf genau den
Leaves Read/Write/Synchronize, keine Owner-/DACL-/Delete-/DeleteChild-Rechte.
Beide Dateien sind tatsächlich0Bytes lang. Native Owner-/ACLprüfung bestand:
Actor-Maske `0x12019f`, keine Directory-Create-/Delete-/Owner-/DACLrechte.
Ursprüngliche Agent-/Helperprozesse5140/6240, Konfiguration, öffentliche Pins
und private Helper-/Geräteschlüsselmetadaten blieben im Vorher-/Nachhervergleich
erhalten. Keine Dienständerung, Joboperation, SQLiteinitialisierung oder Clockänderung.
Der implementierte Helperadapter soll den Store nur lesend öffnen und gehaltene
Dateiidentitäten prüfen; das ist mit der Dateivorbereitung noch nicht nativ belegt.
SQLite-PERSIST erhält das vorab angelegte Rollbackjournal, statt dem Actor
Verzeichnisanlage- oder Löschrechte zu geben. WAL und zusätzliche Dateien werden
nicht verwendet. Der Sourceentscheid folgt der [SQLite-PRAGMA-Dokumentation](https://www.sqlite.org/pragma.html#pragma_journal_mode).
Die tatsächliche Verzeichnis-/Leaf-ACL ist jetzt nativ vorbereitet und geprüft.
PERSIST-/Sharing-/Hotjournalfunktion unter dem Agenttoken bleibt separat offen;
zwei leere Dateien sind ausdrücklich kein SQLite-Funktionsnachweis.
Fehlende oder abweichende Provisionierung verweigert die SYSTEM-Strecke; der
passive Standardclient provisioniert oder repariert nichts.
## Tatsächliche Prüfgrenzen
Die genehmigte Entwicklungsdiagnose ergänzt im vorhandenen privaten
Agent-Probereport ausschließlich feste Stufen-/Codefelder. Der Helper hält
genau `state/pipe-last-error.json` plus eine feste Pendingdatei und versucht
höchstens einen Schreibzugriff je30Sekunden. Inhalt: PID, UTC-Beobachtungszeit,
statische Stufe/Whitelistcode und optional eine unmittelbar am fehlgeschlagenen
API-Aufruf erfasste numerische Win32fehlernummer. Keine Request-/Binding-/Grant-
oder Tokendaten, kein beliebiger Fehlertext, keine Historie und keine zusätzliche
RMM-/MCP-Inventarfähigkeit. Sicherheitsfehler schließen weiterhin Sync und Pipe;
ein fehlgeschlagenes Revert führt weiterhin zum Prozessabbruch. Ein Fehler der
Diagnostik wird nicht als Sicherheitsausnahme behandelt.
Im gleichen Kandidaten ist der belegte Source-APIfehler bei OVERLAPPED-I/O
korrigiert: direkte ReadFile-/WriteFile-Bytezähler sind null, tatsächliche
Completionbytes kommen auch bei sofortigem TRUE aus GetOverlappedResult.
Bestehende Deadline-, Cancel- und Pufferlebensdauer-/Abbruchgrenzen bleiben
erhalten. Grundlage: [ReadFile](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-readfile)
und [WriteFile](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-writefile).
Dies belegt keine tatsächliche Ursache des früheren nativen Probefehlers.
Feature- und Defaultprofile wurden lokal für Windows-GNU mit
`cargo clippy --locked --offline --all-targets -- -D warnings` erfolgreich
crossgeprüft; die neue Bootstrapquelle wurde durch den PowerShell-AST-Parser
geprüft. Eine enge neue CAS-Fixture ist implementiert und crosskompiliert.
Windows-Unitlinks wurden erzeugt; dies ist keine native Testausführung.
Unabhängiger finaler Source-Review bestanden. Ein gemeinsamer Build bindet70
Quellen, beide Alltargets-Clippy-Profile und sechs erhaltene AMD64-PE-Artefakte:
Agent, Helper, zwei Readonlyprobes und beide Unitprogramme. Manifest
`build-80655271-dbe6-474f-89de-014fd5a67c8d`, SHA256 `71914e2a…`;
private gehashte vollständige Quellenkopie zusätzlich erhalten.
Auf der tatsächlichen Windows-VM bestanden danach23Lib+7Bin-Units ohne Skips,
Fall `5f95361a-5b4e-4fa0-aeeb-414a8dfac613`. Anschließender separater Readback
und Prüfung unveränderter zentraler Zähler/geschlossener Flags bestanden.
Bootstrap-Administrator-Units, kein LocalService-/SYSTEM-Runtimebeweis.
Der ursprüngliche SSH-Timeout lag nach der Übertragung vor dem ersten Unitstart.
Nur lesend wurden beide vollständigen Binärhashes/-größen und das Fehlen von
Remote-Testfall/Startmarker nachgewiesen. Danach wurde im selben Fall ausschließlich
die erste noch nicht erreichte Testphase mit zusätzlichem dauerhaftem Intent
fortgesetzt; keine erneute Übertragung oder Testwiederholung. Alter Timeout erhalten.
Noch offen sind die tatsächlichen Agenttoken-/SQLite-/Crash-/Nichtstart-/Mirror-
Nachweise. Die separate positive Agent-/Helper-
Pipeprüfung, TrustedClock und WebUI-genehmigte SYSTEM-SCM-Abnahme bleiben eigene
offene Gates. Frühere native Unit- und passive Transportnachweise werden nicht
als Nachweis dieses neuen Ablaufs umetikettiert.
Der gemeinsame Kernvertrag ist inzwischen separat nativ zuerst auf Cloud-Linux80,
danach Windows58 Prüfungen qualifiziert; siehe [Abandonvertrag](windows-system-abandon.md).
Die Sourcekorrekturen zu tatsächlichen Helper-Unknowns und wiederholtem Startup
erhalten identische kanonische Ergebnisse samt Originalgrant. Statische private
Pipe-Fehlercodes und der dokumentierte OVERLAPPED-Bytezählerpfad sind korrigiert;
die Ursache des ursprünglichen tatsächlichen Verbindungsfehlers bleibt unbewiesen.
Die neuen Adapterunits sind23Lib+7Bin **nativ bestanden**; eine Installation des
damit gebundenen neuen Agenten/Helpers ist noch nicht erfolgt.