Files
rust-discovery/docs/windows-clock-attestation-proposal.md
2026-11-14 22:58:13 +01:00

165 lines
9.9 KiB
Markdown

# ADR: unabhängiger signierter Zeitnachweis für Windows
Status2026-11-14: **Vom User ausdrücklich angenommen: „Ja, signierten
Zeitvergleich umsetzen“.** Normativ in Spezifikation1.22/Kapitel0 und
Projektentscheidungen übernommen. Implementierung und tatsächliche
Qualifikation stehen noch aus; kein Schlüsselsetup oder Clockgatewechsel.
Vorausgehender konkreter OSF-Befund:
[QOS5-Analyse](windows-clock-rpc-qos5-analysis.md).
## Angenommene Änderung der Trustsource
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.
Die angenommene Entscheidung erlaubt 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 ersetzt 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. Die ausdrückliche normative
Produktentscheidung ist in Kapitel0/Projektentscheidungen1.22 festgehalten.
Review und eigene Qualifikation bleiben nötig. Bis dahin bleibt der
produktive Windowsclock-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
Die ausdrückliche Entscheidung über die andere Trustsource und die
beibehaltenen Grenzen liegt vor. Als Nächstes 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.
## Separater tatsächlicher Serverproviderbefund
Root hat nach diesem Entwurf nur lesend die vorhandenen Zeitdienste auf dem
festgelegten Cloudserver ermittelt: Chrony ist aktiv; chrony.service und
chronyd.service melden dieselbe vorhandene Dienstgeneration. Providerfall
`7534ada0-c4ce-47d0-a04f-8c0d94e9ba0d`, ResultatSHA256
`11f7f1e9bd9af49127bb4745440a739e7a92faef70d17fb48291cc4688485181`.
Kein Dienststart, Zeitsetter, Resync oder D-Bus-Autoaktivieren.
Eine getrennte feste `chronyc -n -c -h /run/chrony/chronyd.sock tracking`-
Abfrage lief mit Exit0, leerem stderr und14 CSVfeldern. Das geschützte
vorhandene Binary wurde gehasht, die Socketidentität vor/nach verglichen.
Fall `24390534-25f7-4f5f-a3c7-8ca3cb24aec1`, ResultatSHA256
`33cffb1ec13647fbc09a7f989518e0162920aea3e99e9aba0ace4eb5b006fb20`.
Gemeldet wurden Stratum3/Normal; Peeradresse und Rohdaten bleiben privat.
Chrony dokumentiert CSV-Einheiten, Referenzmesszeit und die konservative
Fehlerschätzung aus verbleibender Systemkorrektur, Rootdispersion und halber
Rootverzögerung [im Primärhandbuch](https://chrony-project.org/doc/latest/chronyc.html).
Für genau diese Aufnahme ergeben sich 379.043210s Messalter und
0.011525568s geschätzte Fehlergrenze unter Chronys Referenzannahmen.
Das ist ein einmaliger Diagnosebefund, **keine qualifizierte Zeitquelle**.
Vor einer Implementierung bleiben tatsächliche Kernelstatusprüfung,
authentisierte/beschränkte Provideranbindung aus der Serverlaufzeit,
frische gemeinsame Erfassung, konservative Gesamtschranken und deren
Linux-first-Nachweise offen. Die vorhandene CLI-Diagnose wird nicht als
fertiger Produktadapter übernommen. Die Userentscheidung genehmigt die Umsetzung; sie ersetzt diese technischen
Nachweise nicht. Windowsclock bleibt bis zur Qualifikation geschlossen.