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

76 lines
4.6 KiB
Markdown

# Einmaliger Start des vorhandenen Windows-Zeitdiensts
Stand 2026-11-14: [Bootstrapquelle](../deploy/windows/time_service_start.py)
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:
```text
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.**