Files
rust-discovery/docs/windows-signed-clock-source.md
T
2026-11-14 23:54:10 +01:00

215 lines
13 KiB
Markdown

# Windows: unabhängiger signierter Zeitvergleich, erster Quellenschnitt
Stand2026-11-14, Spezifikation1.22. Der User hat diese alternative Trustsource
ausdrücklich angenommen; [Vertrag](windows-clock-attestation-proposal.md).
Dieser Schnitt implementiert den unabhängigen Windows-Verifier. Er ersetzt
noch keinen laufenden Agent/Helper und öffnet keine Windows-Jobfähigkeit.
`crates/agent-windows/src/signed_clock.rs` ist additiv registriert. Sein
installierter Adapter wird ausschließlich unter Windows mit dem vorhandenen
`system-helper`-Feature gebaut; die zwei plattformneutralen Guardtests laufen
auch unter Linux. Die bestehende RPC-Clock und `ADAPTER_QUALIFIED=false` bleiben
unverändert. Kein neuer `SyncClock`, Cache, Netzwerkclient oder Jobpfad.
## Tatsächliche Bindung und enge API
Agent und SYSTEM-Helper öffnen jeweils selbst die geschützte bestehende
Helperkonfiguration, prüfen ihre tatsächliche eigene SCM-Prozessgeneration,
Token-/Dienstrolle und gehaltene Imageidentität mit dem vorhandenen PeerProof.
Ein Agent kann die Helperrolle dadurch nicht nur im Request behaupten.
Die vorhandene feste lesende CIM-Bootabfrage läuft unabhängig in jedem Prozess
vor Beginn der Challenge. Ihre potenziell längere Laufzeit wird nicht aus einem
bereits laufenden Einsekundenbudget versteckt.
Der zusätzliche feste öffentliche Pinpfad ist
`C:\ProgramData\RustDiscoverySystem\time-attestation.json`, maximal16KiB.
Seine Datei und das geschützte Elternverzeichnis werden mit bestehenden
PinnedFiles und restriktiven ACL-/File-ID-/Reparseprüfungen gehalten.
Alle ursprünglichen Helperkonfigurationshandles bleiben ebenfalls erhalten.
Der Pin bindet die exakte bestehende Gerätebindung, Serverinstanz, Zeitkey-
Generation, bis zu acht Publickeys und genau eine Kalibrierungsreferenz je
Agent-/Helperimage. Nur SYSTEM/Administrators schreiben; die beiden
Dienst-SIDs dürfen lesen. Keine Keys aus einer Serverantwort oder Workerdatei.
Ein anschließender enger Sourcefix verweigert zusätzlich jeden Zeitpublickey,
der nach tatsächlicher Hexdekodierung dem vorhandenen Jobpublickey entspricht.
Abweichende Groß-/Kleinschreibung umgeht die Rollentrennung nicht. Eine neue
gezielte Negativprobe prüft diesen Fall. Dieser Fix ist noch nicht Teil des
unten erhaltenen180-Input-Belegs; seine neue kohärente Qualifikation folgt nach
dem neuen gemeinsamen Agentpfad-/Linuxnachweis im184-Input-Nachtrag unten.
Die Kalibrierung muss die tatsächliche Binary per SHA256 und einen separat
gewonnenen Qualifikationsbeleg binden. Das positive Grundfehlerbudget liegt
höchstens10ms je Capture. Dies ist **keine gemessene Genauigkeit**: Aktuell
existiert aus diesem Schritt kein bereitgestellter Pin oder Kalibrierungsbeleg.
Ein solches JSON darf nicht mit geratenen Werten als qualifiziert installiert
werden. Der dauerhafte monotone Konfigurationsweg über Prozessneustarts bleibt
vor Runtimeaktivierung gesondert zu provisionieren. Der Loader selbst sperrt
innerhalb desselben Prozesses niedrigere Generationen und unterschiedliche
Rawbytes bei gleicher Generation; er erzeugt kein neues Floorjournal.
Eine zufällige Prozessinkarnation sowie ein prozessweit gehaltener Continuity-
Head bleiben unabhängig von Objektkonstruktoren erhalten. Höchstens eine
Challenge ist pro Prozess offen. Bootwechsel, rückwärts laufende Zähler,
Wallstep oder Schlafdifferenz über1s verwerfen sie. Überlauf erschöpft den Head
dauerhaft; ein weiterer Aufruf öffnet ihn nicht wieder. Erst eine neu erzeugte
Challenge nach einer beobachteten Diskontinuität ist verwendbar.
Im anschließenden Reviewfix hält derselbe globale Head auch die höchste
Verbindungsgeneration: Ein neues Adapterobjekt mit höherer Generation
invalidiert alte offene Challenges, alte Objekte können keine neue Anfrage
unter ihrer niedrigeren Generation eröffnen. Ein Generationwechsel am
vorhandenen `begin` schließt dessen eigene alte Anfrage. Die gezielte
Continuityprobe ergänzt diese Negativfälle; auch dieser Fix gehört zum
folgenden neuen Quellenbeleg, nicht zum ursprünglichen180-Input-Snapshot.
Der native Capture umfasst präzise Interruptzeit, Unbiasedzeit, Wallclock,
nochmals Unbiasedzeit und Interruptzeit. Beide präzisen Interruptgetter sind
gemäß Microsoft **VOID**-APIs; kein fingierter BOOL-Erfolg und keine optionale
Fallbackquelle. Zeitwerte sind100ns-Einheiten. Der gesamte gemessene Bracket
wird zusätzlich zum ausdrücklich qualifizierten Grundfehler konservativ
berechnet. Auflösung wird nicht mit Genauigkeit gleichgesetzt.
[Präzise Unbiasedzeit](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryunbiasedinterrupttimeprecise),
[präzise Interruptzeit](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryinterrupttimeprecise).
`begin` liefert ausschließlich den gebundenen Transportrequest und hält die
opaque Challenge selbst. `complete(bytes, callback)` nimmt nur begrenzte
Antwortbytes entgegen, keine fremden Zeiten. Der Adapter erfasst Empfang
selbst vor dem JSON-Decode und die Schlussmessung nach der vollständigen
Signaturprüfung. Der gemeinsame Codec prüft Signatur, Originalrequest und
Kontext, vollen RTT,100ms-Empfangsalter und die ganze UTCspanne. Am Ende müssen
auch prozessweiter Owner und Epoch noch identisch sein.
Nur der unmittelbar aufgerufene Callback erhält eine geliehene Comparison mit
der geprüften Spanne und der tatsächlich selbst beobachteten Windows-Wallclock.
Keine gespeicherte Comparison, kein Midpoint als angebliche lokale Uhr, keine
automatische neue Challenge nach einem Fehler. Abschluss/Abbruch konsumiert die
ursprüngliche Anfrage. Runtimeintegration muss diese API an ihre tatsächlichen
Start-/Syncgrenzen binden; sie wird hier nicht durch einen scalar `now()`-Stub
vorgetäuscht. Die bestehenden zusätzlichen Job-/WebUI-/Ledgergates bleiben nötig.
## Tatsächlich lokal geprüft
Eingefrorener Sourcefall30bb330a-d285-4d15-ab8d-8ce36a760524,180 Inputs;
Inputmanifest SHA256
`7f56d21680a1345f514ac98fd187a3bea376414215ba1d5773f682690a8ae214`.
Windowsmodul SHA256
`f1fed304ebda3f48f38aba38f8ad5e1811c566abd740dffce318f4b07beac3ca`.
Receipt SHA256
`ad5e35ac1c63f0cbc8e3559c338b183ca5793e7219543a9f43794cc75542402b`.
Der vollständige private Snapshot und Logs bleiben unter gitignoriertem
`devstate/windows-signed-clock/qualification-30bb330a-d285-4d15-ab8d-8ce36a760524/`.
Tatsächlich bestanden, ausschließlich Offline-Docker auf dem Entwicklungsrechner:
- Zwei gezielte Linux-Guardtests: Bracketbudget/Counterfehler sowie erhaltener
Prozessfence, Bootsubstitution, Generation/Fork und erschöpfter Epochcounter.
2bestanden,0failed/ignored;10 übrige Cratetests ausdrücklich herausgefiltert.
- Windows-GNU-Alltargetscheck sowie Clippy mit `-D warnings` für den
`system-helper`-Build. Erster Clippylauf verweigerte drei verschachtelte
if-Blöcke; diese wurden ohne Unterdrückung korrigiert und erneut geprüft.
- Windows-Lib-Testbinary tatsächlich gelinkt,75326709Byte, SHA256
`29c037f6ca13fc91806312a16dde0923fcaa1d5a0d16d057362bf112f3875da6`.
**Nicht auf Windows ausgeführt**, kein nativer Testcount daraus abgeleitet.
- Formatcheck ausschließlich der neuen Moduldatei bestanden.
Die relevanten Cargoaufrufe benutzen `--locked --offline`; Linux-Testfilter
`signed_clock::tests`, Windows `--target x86_64-pc-windows-gnu --features
system-helper --all-targets`. Das Linken verwendet `test --lib --no-run`.
Der eingefrorene gemeinsame Codec enthält zu diesem Zeitpunkt noch die alte
`/api/agent/v1/time-attestation`-Audience. Der geplante korrekte Agentpfad
`/agent/v1/time-attestation` benötigt einen neuen gemeinsamen Quellenbeleg;
dieser ursprüngliche Snapshot wird dafür nicht verändert.
## Offene reale Nachweise
Keine Cloud-Linux-Ausführung dieser beiden neuen Guardtests und keine native
Windowsausführung in diesem Schritt. Keine tatsächliche Timerkalibrierung,
Pinprovisionierung, Serverantwort im echten Geräte-mTLS-Kontext oder parallele
Agent-/SYSTEM-Roundtrips. Keine Runtime-/IPC-/HTTP-Anbindung und keine Wirkung.
Der Servercodec besitzt eigene getrennte Nachweise; diese qualifizieren nicht
automatisch den Windowsadapter. Zuerst Linux-first, dann unabhängig auf dem
Windowsgast prüfen. Erst danach kann eine gesonderte WebUI-genehmigte
Windows-Skript-/SYSTEM-Abnahme folgen. W32Time-Konfiguration, Dienste,
Geräteidentitäten, PKI und Journale wurden durch diese lokale Arbeit nicht
angefasst.
## Aktueller kohärenter Nachtrag nach URI- und Reviewfix
Der neue separate Fall763baf69-10b1-4307-9c99-6942c0f8945f bindet184 Inputs
einschließlich des gemeinsamen Codecs mit der korrigierten Audience
`/agent/v1/time-attestation`. Der ursprüngliche180-Input-Snapshot bleibt
unverändert. Der unabhängige Source-Review von updater_review meldete für das
aktuelle Windowsmodul PASS; dies ist ausdrücklich kein nativer Rollennachweis.
Aktuelles Modul SHA256
`6b66612b7a53377c91bc8e41864ac8fb9393ad40b0a6a98aa6ce746fce091ddb`,
Inputmanifest SHA256
`eb4609c5fca6a32ddb8ebf364775efdb59cd89f99a24b3b731212da08eac6a6e`,
Receipt SHA256
`e013738caed2d8e02b98ffd1b41e47a80840c44d3dbf895e9a3952b4311ce927`.
Private Belege:
`devstate/windows-signed-clock/qualification-763baf69-10b1-4307-9c99-6942c0f8945f/`.
Tatsächlich lokal auf den eingefrorenen Bytes bestanden:
- Release-Linux-Testbinary gebaut und dessen vollständige Liste von13 Tests
und0 Benchmarks geprüft. Nur die drei neuen `signed_clock::tests` ausgeführt:
**3bestanden,0failed/ignored,10 übrige Tests ausdrücklich herausgefiltert**.
Hinzugekommen ist die konkrete Job-/Zeitkey-Rollentrennung auch bei anderer
Hexschreibweise; der Fencetest prüft nun auch den Connectionhead.
- Windows-GNU-Alltargetscheck und Alltargets-Clippy mit `-D warnings` bestanden.
- Windows-Lib-Testbinary aus genau denselben184 Inputs tatsächlich gelinkt.
- Formatcheck der neuen Moduldatei bestanden; keine Unterdrückungen ergänzt.
Der erste Windows-Linkversuch dieses Falls scheiterte ausschließlich lokal am
Schreibschutz der früher qualifizierten Testexe im wiederverwendeten Target.
Der frühere Pfad und SHA29c037f6 blieben erhalten. Der unveränderte neue
Sourcesnapshot wurde danach in einem neuen eigenen Windowstarget erfolgreich
gelinkt; der ursprüngliche Fehlerbericht bleibt101 und wird nicht überschrieben.
Keine Lockerung des Readers oder der alten Artefaktrechte.
Die qualifizierte neue Linuxexe hat3374576Byte, SHA256
`0896a3098f493b67b48e774de5cfe9bca682d2a19ff10971c62c9c7b9681ec14`.
Der Native-Operator muss zunächst exakt die vollständige13er-Liste verlangen
und anschließend ausschließlich die drei neuen Namen auswählen; kein erneutes
Ausführen der zehn alten Fälle oder Verschweigen ihrer Filterung. Dies ist der
vorbereitete Linux-first-Nachweis, **hier durch diesen Worker nicht auf der
Cloud-VM ausgeführt**.
Die neue Windows-Testexe hat75360791Byte, SHA256
`3421368eff990d197889da58aa09463e00eff40e1cfebfcfdf1e9b9382e10f03`.
Sie wurde hier nicht auf Windows ausgeführt. Bauen, Linken und Source-Review
eröffnen weiterhin keine Capability. Sämtliche zuvor genannten tatsächlichen
Timer-, Rollen-, Provisionierungs-, Transport- und Runtimegates bleiben offen.
## Tatsächlicher Linux-first-Nachweis der drei Guards
Root führte den unabhängig geprüften Runner
`deploy/windows_signed_clock_linux_acceptance.py`, SHA256
`70b029a441d27814f646a75cfb69ff9e5af356776027a7f836a252964a29aafd`,
im Originalfall `6ea36dec-254e-4a82-8d1c-c72a1f959ed2` auf der Cloud-Linux-VM
aus: **3bestanden,0ignored,10andere Tests gefiltert, Exit0**.
Die vollständige13er-Liste musste zuvor exakt stimmen. Separater lesender
Originalfall-Readback vollständig; bekannte drei RMM-Prozessgenerationen,
Kontrollbytes, Boot und DB-/Lock-Dateiidentitäten erhalten. Kein RMM-Job,
Produktzeitquery oder Dienststeuerung; Full weiter Autostart disabled.
Tatsächlich prepare, einmal execute und read mit obigem Originalfall ausgeführt.
FallmanifestSHA256
`cc83d7bc455dfaa2e0c7b0305b5713452a74ad0b60730c6058132a761aa5f157`;
ExecuteSHA256
`0a86c11133bce801c86d3af8bd7e1eadfeacdf49456f4ae17291e7281b8ade1f`;
ReadbackSHA256
`81138562175bf71bc14c0f5cf9ddc37b434c8d7751196b12c90140db5c29e9f1`.
Private184Inputs und ursprüngliche Qualifikationsbelege bleiben unverändert.
Der veröffentlichte erste Modulstand entspricht exakt6b66612b. Die
`lib.rs`-Modulregistrierung wurde danach ausschließlich alphabetisch gemäß
rustfmt geordnet; die ursprünglichen Compilerinputs werden dadurch nicht
nachträglich geändert. Kein erneuter Semantiktest für diese reine Formatierung.
Nachfolgende Rohcapture-/Runtimeänderungen sind eigene Quellenstände und
werden durch diesen nativen Dreierbeleg nicht mitqualifiziert. Native Windows-
Timer und tatsächliche Zeitquelle bleiben weiter offen; Legacyclock bleibt zu.