Files
rust-discovery/docs/windows-clock-attestation-proposal.md
T
2026-11-14 21:09:00 +01:00

133 lines
7.9 KiB
Markdown

# ADR-Entwurf: unabhängiger signierter Zeitnachweis für Windows
Status2026-11-14: **Vorschlag zur Entscheidung, nicht angenommen oder
implementiert.** Kein Targetzugriff, Schlüsselsetup oder Clockgatewechsel.
Vorausgehender konkreter OSF-Befund:
[QOS5-Analyse](windows-clock-rpc-qos5-analysis.md).
## Entscheidung ist nötig
Die vollständig gelesene Spezifikation1.18 samt aktuellen Main1.20-Deltas,
Projektentscheidungen und Entwicklungsregeln verlangen weiterhin tatsächliche
lokale Status-/Boot-/Unsicherheitsnachweise. Der aktuelle Windowsvertrag
verlangt lokalen W32Time-Sync höchstens1h alt, maximal2s Unsicherheit und nach
Diskontinuität einen neuen Sync; er schließt einen Serverzeitanker ausdrücklich
aus. Die VM meldet derzeit W32Time Leap3/Stratum0. Ein signierter Beleg darf
diesen Dienstzustand nicht nachträglich als synchronisiert ausgeben.
Dieser Entwurf wäre eine **andere zulässige Vertrauensquelle**: ein signierter
Onlinevergleich qualifiziert die aktuelle lokale Windows-Wallclock; er stellt
sie nicht und ersetzt sie nicht durch einen Hello-Zeitwert. Er würde bewusst
lokalen W32Time-Sync als alleinige Voraussetzung durch streng begrenzte,
kryptografisch belegte Vergleichsqualität ersetzen. Auch „neuer Beleg nach
Diskontinuität“ wäre dann ein neuer expliziter Vertrag, kein behaupteter neuer
Windows-NTP-Sync. Dafür braucht es eine ausdrückliche normative
Produktentscheidung in Kapitel0/Projektentscheidungen, anschließend Review
und eigene Qualifikation. Bis dahin bleibt der bisherige Adapter geschlossen.
## Kleiner vorgeschlagener Vertrag
Nur der bereits festgelegte Server `discovery.ease-technologies.de` darf mit
einem eigenen provisionierten Ed25519-Zeitschlüssel signieren. Domainkennung
`RMM-TIME-ATTESTATION/v1`, feste Version und exakte Codecbytes; kein frei
wählbarer Algorithmus. Schlüssel strikt getrennt von TLS, Jobs und Updates.
Der geschützte Helperpin bindet die erlaubten Zeitpublickeys samt monotoner
Konfigurationsgeneration. Der Netzwerkagent kann keinen Publickey ergänzen;
Rotation/Entzug brauchen den gesondert geschützten Konfigurationsweg.
Agent und SYSTEM-Helper prüfen unabhängig. Jeder Verifier erzeugt selbst
256Bit CSPRNG-Nonce und eigene zufällige Prozessinkarnation, hält höchstens
eine Anfrage und beobachtet selbst Boot-ID, präzise Interrupt-/Unbiasedzeit
sowie Wallclock. Der Agent darf Helperanfrage und Antwort nur transportieren.
Seine behaupteten Zeiten oder Timer ersetzen keine Helperbeobachtung.
Der signierte Beleg bindet Nonce, Anfragetype/-hash und Verifierrolle,
Serverinstanz/-boot, erlaubten Endpunkt, Tenant/Asset/Agent,
Enrollment-/Assignmentgeneration, aktuelle Connectiongeneration,
Windows-Boot-ID, Verifierinkarnation sowie beim Helper dessen gepinnten
Imagehash und Bindingschema. Serverseitig Tenant/Agent ausschließlich aus
gültigem mTLS ableiten; aktuellen Verbindungskontext selbst nachprüfen.
Eine solche signierte Kontextbestätigung darf initiale Clockprüfung vor dem
normalen Sync ermöglichen, ersetzt aber weder diesen Sync noch ein Startgrant.
Striktes TLS/SAN/SNI bleibt Pflicht; falsche OS-Zeit rechtfertigt keinen
Zertifikatsprüfungs-Bypass zur vermeintlichen Zeitreparatur.
## Qualität und konkrete Zeitgrenzen
Vor jeder Signatur braucht der Server eine frische, nur lesende native
Kernel-/Providerprüfung: kein `TIME_ERROR`, `STA_UNSYNC` oder `STA_CLOCKERR`,
eindeutige Einheiten, gültiger UTCwert und konservativer Gesamtfehler
`epsilon_server <= 500ms`. Die bestehende Linuxfunktion erlaubt Kernel-
`maxerror <= 5s`; sie ist dafür **nicht unverändert ausreichend**. Maximal1h
seit tatsächlichem letztem guten Quellensync bleibt erforderlich. `timex`
enthält Fehler-/Statusfelder, aber keinen universellen Last-good-sync-Zeitpunkt;
der tatsächlich vorhandene Zeitprovider muss dafür eine vertrauenswürdige
native Schnittstelle liefern. Fehlend bedeutet deny, kein aus Pollzeit oder
Heartbeat erfundenes Syncalter.
[Linux-UAPI](https://raw.githubusercontent.com/torvalds/linux/master/include/uapi/linux/timex.h).
Vorläufige bewusst kurze Grenzen: vom verifiereigenen Challengebeginn bis zur
konkreten Prüfung maximal1s, davon nach Empfang höchstens100ms. Keine längere
Holdover-/Offlinephase. Capture-/Rundungs-/Timerunsicherheit wird explizit mit
`delta` berücksichtigt; dessen Höchstbudget50ms braucht einen tatsächlichen
Plattformnachweis und darf nicht aus Timerauflösung als Genauigkeit erfunden
werden. Microsoft trennt monotone Intervallmessung von UTC und setzt für VMs
einen korrekt implementierten Hypervisor voraus; diese OS-/Kernelannahme
bleibt ausdrücklich bestehen.
[Zeitstempelvertrag](https://learn.microsoft.com/en-us/windows/win32/sysinfo/acquiring-high-resolution-time-stamps).
Für signiertes Servercapture `T`, Fehler `epsilon_server` und selbst
gemessenes Gesamtintervall `R` ist die konservative UTCspanne zum Prüfzeitpunkt
`L = T - epsilon_server`, `U = T + epsilon_server + R + delta`.
Der gesamte RTT wird berücksichtigt; keine unbelegte Halbierung oder Annahme
symmetrischer Paketlaufzeiten. Die gleichzeitig selbst gelesene lokale
Wallclock `W` ist nur qualifiziert, wenn
`max(abs(W-L), abs(W-U)) <= 2s`. Spätere Vergleiche brauchen wieder einen
fristgerechten eigenen Beleg; keine freie Extrapolation einer Serverzeit.
Deadlineprüfung muss konservativ die ganze Spanne verwenden:
`L >= not_before` und `U < start_before`, zusätzlich bestehende monotone
Laufzeit-/Verbrauchsgrenzen. Ein einzelnes `SyncClock::now()`-UTCdatum reicht
diesen Intervallvertrag nicht automatisch weiter; dessen konkrete Integration
ist vor Implementierung zu prüfen. Alte Grantbytes, Fristen und60s-Startfenster
werden weder geändert noch durch Belegrefresh verlängert.
## Restart, Replay und Fehler
Jeder Boot-/Prozess-/Connectionwechsel verwirft offene Nonces und Bereitschaft.
Kein auf Platte gespeicherter Zeitbeleg eröffnet nach Restart oder Restore.
Neue zufällige Nonce/Inkarnation und normaler unabhängiger Ledger-/Syncabgleich
sind nötig; Journale, Schlüsselidentitäten und Verbrauchshistorie erhalten.
Nur Schlüssel-/Konfigurationsgeneration und gebundene Jobprüfbelege werden
im bestehenden geschützten Persistenzmodell ergänzt, keine Ledgerresets.
Rückwärtszähler, Wallstep oder Sleepdifferenz über der bisherigen1s-Grenze,
fehlerhafte Bootbeobachtung, falsche Nonce/Rolle/Bindung/Signatur, doppelte
Antwort, Überlauf oder Überschreitung einer Grenze sperren. Nach beobachteter
Diskontinuität darf nur eine danach erzeugte Challenge Bereitschaft herstellen.
Ein neuer Objektkonstruktor löscht keinen bestehenden Diskontinuitätsfence.
Ein bösartiger LocalService-Agent kann so höchstens verzögern/verhindern,
nicht Helpernonce oder Signatur fälschen. Server-/Zeitschlüsselkompromittierung
und bösartiger Hypervisor bleiben Vertrauensgrenzen; Signatur authentifiziert
den Beleg, nicht automatisch den vorgelagerten NTPserver.
Ohne frischen gültigen Beleg `CLOCK_UNTRUSTED`; Telemetrie bleibt möglich.
W32Time-Rohstatus bleibt separat sichtbar. Keine Clocksetter, Resyncs,
NTP-/ACLänderungen, neue Jobfreigaben oder Ersatz menschlicher WebUI-Genehmigung.
## Enger Review- und Nachweisplan
Zuerst ausdrückliche Entscheidung über die andere Trustsource, 2s-/1h-Grenzen
und den Post-Diskontinuitätsvertrag. Danach ausschließlich lesend tatsächliche
Serverqualität/Provider-API, Windows-Timer und Sync-/Deadline-Integrationspunkte
prüfen. Fehlt eine belastbare Qualitäts-/Alters-/Timergrenze, bleibt der
Entwurf blockiert; keine Implementierung mit angenommener Güte.
Nur nach bestandenem Review: wenige Byte-/Signatur-/Bindungs-/Intervallguards,
Serverseite zuerst auf der Linux-Cloud-VM qualifizieren, danach getrennt reale
Windows-Agent-/SYSTEM-Verifikation samt Replay, Delay, Restart und falscher
Rolle/Identität. Suspend/Clockstep zunächst injizierte Validatorinputs; kein
unangekündigter OS-Suspend/Uhrsprung. Quellen-/Buildnachweise eröffnen keine
Capability. Erst eigene reale Abnahme und anschließend tatsächlicher neuer
WebUI-genehmigter Windowsjob belegen eine nutzbare Strecke.