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

4.5 KiB

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 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.

    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.

    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. Vor der ersten Geräteänderung speichert der Server die Fall-ID, den signierten Ausgangscheckpoint, beide Binärhashes und die ursprüngliche Richtlinie. Beim Öffnen prüft der Operator die signierte Paarversion, den laufenden Agenten und seine Gerätebindung. Nach einem passenden Geräte-Heartbeat und einer aktuellen signierten Helper-Uhr meldet der Operator central_scope_open. Ab dann steht die Richtlinie bereit. 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.

    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.

    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 dokumentiert.

Derselbe close --case schließt eine abgebrochene Einrichtung, sobald die Fall-ID ausgegeben wurde. War der Helper schon synchronisiert, vergleicht der Controller den ursprünglichen und den aktuellen signierten Checkpoint mit den lokalen Journalen. Zum Abschluss müssen Agent und Release-Polling laufen und ein neuer synchroner Heartbeat ohne SYSTEM-Fähigkeiten vorliegen.

Die native Abbruchabnahme beendet den Controller nach dem ersten passenden authentisierten Helper-Heartbeat und vor dem Öffnen der Richtlinie. Auf einem freien Windows-Entwicklungsgerät lässt sich der Ablauf wiederholen.

python3 tests/windows_update_early_abort.py --execute

Auch nach einem abgebrochenen Test gibt der Befehl die Fall-ID aus, mit der sich der Rückbau fortsetzen lässt.