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

13 KiB

Windows: unabhängiger signierter Zeitvergleich, erster Quellenschnitt

Stand2026-11-14, Spezifikation1.22. Der User hat diese alternative Trustsource ausdrücklich angenommen; Vertrag. 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, präzise Interruptzeit.

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.