Files
rust-discovery/docs/windows-time-service-start.md
2026-11-14 10:55:42 +01:00

4.6 KiB

Einmaliger Start des vorhandenen Windows-Zeitdiensts

Stand 2026-11-14: Bootstrapquelle implementiert, unabhängig quellgeprüft, Python-Syntax und PowerShell-AST lokal bestanden. Einmaliger nativer Start und separater Readback bestanden. Der Nutzer hat den Start des vorhandenen W32Time ausdrücklich erlaubt. Die Ausführung übernimmt der Root-Orchestrator nach Quellenprüfung auf der Windows-VM; das Notebook bleibt Entwicklungsrechner.

Der einzige Dienstbefehl ist Start-Service -Name W32Time. Startart, Dienstkonto, Imagepfad, Dienst-SDDL, SID-Typ, NTP-Konfiguration und Richtlinien werden nicht geschrieben. Für einen gestoppten Dienst müssen außerdem null Dienstabhängigkeiten vorliegen; sonst erfolgt kein Start. Pending-/unbekannte Zustände blockieren. Ein bereits laufender Dienst wird nur als already_running dokumentiert. Es gibt keinen Resyncbefehl, kein Policyupdate, keinen RMM-Job und keinen Reboot. Ein natürlicher Zeitsync durch den gestarteten Dienst ist erlaubt, aber kein Nachweis einer qualifizierten Uhr.

prepare verlangt die fünf unabhängig bekannten SHA256-Werte für Agent, Helper, Agentkonfiguration, Helperkonfiguration und Agentpin. Es legt einen privaten lokalen Fall an, bindet den bereits gespeicherten zentralen Beforekontext time-service-start-context/888b18b8-da7e-4b9f-9e36-32a23f2ff973, überträgt ausschließlich die feste, hashgeprüfte Bootstrapquelle und liest den tatsächlichen Ausgangszustand. Der Start verwendet diese Originalpins und diesen Fall unverändert. RMM-PIDs, Prozessentstehung, Dienstdefinitionen, Binaryhashes sowie Konfigurations-/PKI-Metadaten müssen erhalten bleiben. Der private Geräteschlüssel wird nur über Dateimetadaten und ACL-Hash geprüft; seine Bytes werden nicht gelesen oder exportiert.

Die Registryprüfung hasht nur ausdrücklich aufgeführte stabile Dienst-, NTP- und Policy-Konfigurationswerte. Sie gibt keine Rohwerte/NTP-Hostnamen aus. Volatile LastSync-/Laufzeitwerte werden nicht als unveränderlich vorausgesetzt; der Hash behauptet keine vollständige Abdeckung sämtlicher Registrywerte. W32Time-Status und dessen PID dürfen sich durch den erlaubten Start ändern.

Vor dem einzigen Startaufruf werden ein privater Originalbeleg und zwei dauerhafte, ausschließlich neu anlegbare Startreservierungen gespeichert: im Fallverzeichnis und als globaler W32Time-Einmalbeleg. Auch lokal entsteht vor dem SSH-Aufruf ein ausschließlich neu anlegbarer Startversuchsbeleg. Eine verlorene Antwort, ein Fehler oder ein unvollständiger Beleg erlaubt nur readback --id ORIGINALFALL; weder Startwiederholung noch automatischer Rollback sind implementiert. Readback meldet den tatsächlichen aktuellen Zustand und bewahrt unbestätigte Ergebnisse als solche. Frühere private SSH-Fehler werden vor/nach Aufrufen versioniert erhalten.

Die folgenden Befehle sind Aufrufvorlagen; die Hashplatzhalter müssen aus dem unabhängig bekannten aktuellen Deployment stammen:

python3 deploy/windows/time_service_start.py prepare --agent-sha256 HASH --helper-sha256 HASH --config-sha256 HASH --policy-sha256 HASH --pin-sha256 HASH
python3 deploy/windows/time_service_start.py start --id ORIGINALFALL
python3 deploy/windows/time_service_start.py readback --id ORIGINALFALL

Vollständige Metadaten bleiben in geschützten lokalen/VM-Fallbelegen. Die CLI gibt nur Fallkennung, Status, Running-/Erhaltungs-/Readback-Merkmale und den ausdrücklich nicht geprüften Uhrvertrauensstatus aus. Lokaler Quellnachweis: devstate/windows-client/time-service-start-source/225c3208-4a3f-4528-8c17-b3846b70812f/qualification.json; PowerShell nur geparst, kein Windows-API-/VM-Aufruf und keine Produkttestsuite.

Tatsächliche Ausführung

Fall c3552c3f-24d1-4713-bd0b-544aee4ffd18 auf dem Windowsgast: Vorbereitung bestätigte Stopped und die bekannten Originalhashes. Anschließend genau ein Start-Service W32Time, Status Running, Erhaltungsprüfung bestanden. Getrennter späterer Readback bestätigte denselben Originalresultbeleg und Running ohne Startwiederholung. Agent5140 und Helper6240 unverändert; Dienstdefinition/SDDL und ausgewählte NTP-/Policy-Konfigurationswerte erhalten. Kein privater Schlüsselinhalt gelesen und keine Konfiguration geschrieben.

Zentraler Kontrollstand vorher/nachher identisch: Windows0Jobs/0Outbox/0Grants/ 0ungeklärt, Linux30/30/26/0; Rootpolicyhash und geschlossene Transporthooks unverändert. Geschützter Abschlussbeleg acceptance.json im Originalfall, SHA256 365d897d94f6fb16b3112fcb5126bdc09224b34e0a6ef46940ca8e7a651807fb. Quellhash ef5d4ce8…. Kein Uhrqualifikations-, RMM-Job- oder Rebootbeleg.