Files
rust-discovery/docs/windows-update-dev-window.md
T

37 lines
3.5 KiB
Markdown

# Entwicklungsfenster für Windows Update
Auf dem per HTTPS aufgenommenen Windows-Testgerät läuft der Agent als LocalService. Das temporäre Wartungsfenster verwendet den SYSTEM-Helper desselben veröffentlichten Agentpaares. Die beiden zulässigen Skripttexte sind in der [Domain](../crates/domain/src/jobs.rs) festgelegt. Alle Anträge laufen über die reguläre Gerätewarteschlange und die sichtbare WebUI-Genehmigung.
1. Aus dem Checkout den angemeldeten Entwicklungsclient, seine laufenden Prozesse und den zentralen Zustand lesen.
```sh
python3 tools/windows_update_scope.py inspect
python3 tools/windows_update_scope.py plan
```
2. Ein Fenster öffnen und den Befehl während der Wartung im Vordergrund laufen lassen.
```sh
python3 tools/windows_update_scope.py window --minutes 15
```
Der Befehl gibt die Fall-ID aus. Der Dev-Operator setzt die aktuelle HTTPS-Erstaufnahme mit Enrollmentgeneration 1 und Zuweisungsversion 1 voraus. Beim Öffnen prüft er die signierte Paarversion, den laufenden Agenten und seine Gerätebindung. Der Server aktiviert die Richtlinie erst nach einem aktuellen, passenden Geräte-Heartbeat. Die einzige zugelassene Bedienperson im Entwicklungsprofil ist `simulated-testprincipal-a`. Das Release-Polling pausiert während des Fensters. Die Ablaufzeit des Fensters steht in UTC in der Ausgabe. Ein anderes noch aktives SYSTEM-Fenster bleibt dem bisherigen Betreiber zugeordnet.
3. In der privaten WebUI das Windows-Gerät und die gewünschte gespeicherte Skriptversion wählen. Zur Prüfung der Identität eine Bibliotheksrevision für Windows PowerShell und Identität `system` verwenden. Der Skripttext ist die folgende Zeile mit genau einem abschließenden LF.
```powershell
Write-Output ([System.Security.Principal.WindowsIdentity]::GetCurrent().User.Value)
```
Bei der Identitätsprobe höchstens 30 Sekunden wählen. Den unveränderlichen Plan prüfen, den Antrag absenden und in der sichtbaren dev/test-WebUI genehmigen. Erwartete Ausgabe ist `S-1-5-18` bei Exitcode 0. Die separate Katalogvorlage „Windows-Updates installieren“ darf bei einem entsprechenden Wartungsauftrag bis 3.600 Sekunden laufen. Sie meldet Updateergebnisse und den Neustartbedarf.
4. Nach dem Ergebnis mit Strg+C schließen oder die Ablaufzeit abwarten. Die Zentrale entzieht den Scope, der Controller wartet auf terminale Versuche, entfernt den temporären Helper und stellt die geschützte Agentkonfiguration wieder her. Endgültige Arbeitsprojektionen dieses Fensters werden unter ihrem ursprünglichen Job-/Grant-Schlüssel lokal archiviert. Zentrale Ergebnisse, Startnachweise, Signaturen und alte Checkpoints bleiben lesbar. Ein neuer Geräteabgleich darf denselben Job oder Grant nicht wieder annehmen. Er prüft LocalService, Release-Polling und den nachfolgenden Heartbeat ohne SYSTEM-Capability. Bei unterbrochener SSH-Verbindung oder einem abrupt beendeten Controller den Rückbau mit der angezeigten Fall-ID fortsetzen.
```sh
python3 tools/windows_update_scope.py close --case FALL-UUID
```
Die zentrale Richtlinie läuft auch bei Verbindungsverlust ab. Der lokale Helper hält den nächsten Agent-Paarwechsel bis zum abgeschlossenen Rückbau an. Ein noch laufender beziehungsweise ungeklärter Auftrag wird im regulären Auftragsablauf geklärt. Der Befehl zum Schließen kann anschließend erneut ausgeführt werden.
Die native Identitätsabfrage und der vollständige Rückbau sind im [Entwicklungsnachweis vom 17. November](evidence/windows-update-window-20261117.json) dokumentiert.