Files
rust-discovery/docs/windows-system-delegation-upgrade.md
2026-11-14 08:09:58 +01:00

82 lines
5.2 KiB
Markdown

# Gemeinsames passives Windows-Komponentenupgrade
Stand 2026-11-14: **Source vorbereitet; dieser Upgradefall wurde noch nicht auf
der VM ausgeführt.** Lokale Guards und PowerShell-Parserprüfung ersetzen weder
die neuen nativen Unitnachweise noch den tatsächlichen Erhaltungs-/Pipebeleg.
Der Notebookhost bleibt ausschließlich Entwicklungsrechner.
`deploy/windows/system_delegation_upgrade.py` ist eine eigene enge Strecke für
den vorhandenen Agenten `2beed7fa…` und Helper `921cf182…`, zuletzt PID5140/6240.
Die historischen Runtime- und Helperbootstraprunner bleiben unverändert. Sie
eignen sich absichtlich nicht zur erneuten Installation oder zum Neustart eines
bereits vorhandenen Helperjournals. Der Originalfall `59c2fd6f…` bleibt erhalten.
Die neue Strecke benötigt das gemeinsame Artefaktmanifest und den tatsächlichen
nativen Unitbeleg aus `system_delegation_acceptance.py`. Sie bindet Agent, Helper,
unveränderten `RuntimeStateProbe.exe` und den neuen lesenden `SystemStateProbe.exe`.
Die gemeinsame Core-Qualifikation Linux80→Windows58 ist eine Voraussetzung;
sie ist keine native Windows-Pipe- oder SCM-Wirkungsabnahme.
Der feste Ablauf speichert vor der Mutation lokale und entfernte Create-only-
Intents. Er hält die tatsächlichen Prozesshandles samt Startzeit, stoppt zuerst
den ursprünglichen Agenten und wartet auf dessen Prozessende; erst danach stoppt
er den ursprünglichen Helper. Beide Dienste müssen während sämtlicher
Dateitausche gestoppt bleiben. Alle vier Originalbackups werden vor dem ersten
`File.Replace` geschrieben und geprüft. Agent-EXE, Helper-EXE, `helper.json` und
`agent-pin.json` erhalten jeweils eigene CAS-/Phasenbelege und ihre bisherigen
Datei-ACLs. Erst nach Prüfung aller vier neuen Dateien darf der Helper einmal,
anschließend der Agent einmal gestartet werden. Die beiden Startbelege binden
PID und Prozessstartzeit auch beim späteren Finish.
Die beiden öffentlichen Konfigurationen ändern ausschließlich die zwei
Binaryhashes und den daraus berechneten Policyhash. Die sechs Agentconfigfelder,
Geräteidentität, Zertifikate und Schlüsselmetadaten bleiben erhalten. Private
Schlüsselbytes werden nicht gelesen oder übertragen. Dienste behalten Konten,
Startmodi, Service-SID-Typ, Kommandozeilen und Service-ACL-Hashes. Telemetrie und
Helperledger behalten ihre Dateiidentitäten, Erstellungszeiten, bestehenden
Schemas und Zeilenbelege. Zwischen Stopp und Neustart werden zusätzlich ihre
Dateibytes verglichen; danach darf die passive Telemetrie nur regulär fortschreiten.
Die separat nativ vorbereiteten Intentdateien aus Fall `f322a4d2…` werden über
dessen unveränderten Beleg `c4ef6fed…` gebunden: genau zwei reguläre 0-Byte-Blätter
mit unveränderten Dateiidentitäten und engen ACLs. Der Runner initialisiert sie
nicht und öffnet sie nicht als SQLite. Vorbereitung bedeutet weiterhin keine
PERSIST-/Hotjournal-, Agenttoken-Zugriffs- oder Delegationsqualifikation.
`enable_jobs=false`, kein Jobbinding, unqualifizierter Produktionsclockadapter,
`allowed_services=[]`, `enable_effects=false` und `allow_reboot=false` bleiben
unverändert. Der Runner führt keine RMM-Jobs, Paket-/Diensttests, Reboots,
Uhränderungen, Freigaben oder Servermutationen aus. Die einzigen Dienstaktionen
sind die ausdrücklich beauftragten Stopps/Starts dieser beiden eigenen
Komponenten. Staging benutzt den bekannten gepinnten SSH-/SFTP-Pfad und feste
hashgeprüfte PowerShell-Dateien mit RemoteSigned, keine freien Befehle oder
ExecutionPolicy-Umgehung. Bereits qualifiziert vorhandene Stageartefakte werden
anhand ihres exakten Hashpointers ausschließlich lesend verifiziert und nicht
erneut übertragen oder überschrieben.
Diagnosen sind auf den bestehenden Agentbeleg `state/helper-probe.json` und die
zwei festen Helperdateien `state/pipe-last-error.json` sowie deren bekannte
Stagingdatei `.pipe-last-error.pending` begrenzt. Helperdiagnosen sind maximal
1024Byte und enthalten ausschließlich Prozess-ID, Beobachtungszeit und feste
Fehlerstufen/-codes. Sie liefern keinen positiven Pipebeweis. Dieser benötigt
den frischen Beleg des tatsächlichen neuen Agentprozesses mit Challenge,
reziproken Pins und erfolgreich authentisiertem Austausch.
Bei Antwortverlust ist ausschließlich `readback --id …` zulässig. Dieser liest
auch einen Teilstand und wiederholt keinen Stop, Dateitausch oder Start. Es
gibt keinen automatischen Rollback, Retry, Journalreset oder Markerabbau.
`finish --id …` benötigt beide tatsächlichen neuen Einzelstartinstanzen,
Erhaltungsbelege, frische gespeicherte WSS-Heartbeats/Inventar-ACKs und unveränderte
Windows-/Linux-Jobzählungen sowie Servergates. Erst danach wird der bisherige
Runtimeindex per lokalem CAS um einen neuen Komponentenbeleg ergänzt. Ein noch
fehlgeschlagener Pipebeleg bleibt ausdrücklich fehlgeschlagen; ein erfolgreiches
passives Komponentenupgrade behauptet keine Jobfähigkeit.
Geplante Befehle, **nicht ausgeführt**:
```text
python3 deploy/windows/system_delegation_upgrade.py upgrade-passive --manifest <manifest.json> --qualification <passed.json>
python3 deploy/windows/system_delegation_upgrade.py readback --id <ursprüngliche UUID>
python3 deploy/windows/system_delegation_upgrade.py finish --id <ursprüngliche UUID>
```