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

5.2 KiB

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:

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>