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

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

    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.

Bei einem Abbruch der allerersten Einrichtung vor der zentralen Fensterakte kann bereits eine Helper-Journalzuordnung bestehen. Der Operator verlangt dann eine fallbezogene Prüfung der Geräte- und Journalbindung. Der automatische Rückbau dieses frühen Abbruchfalls ist noch nicht abgenommen.