Files
rust-discovery/docs/windows-trusted-os-clock-source.md
T
2026-11-15 14:35:22 +01:00

130 lines
15 KiB
Markdown

# Windows: ausdrücklich genehmigtes aktives OS-Zeitprofil
Stand2026-11-15, normative Userentscheidung in Spezifikation1.23/Projektentscheidungen (`b761384`). `trusted_os_active_guest` ist nun implementiert und lokal geprüft. Keine Zeitkonfiguration, keine Schlüssel-/Pinprovisionierung, kein VM-Aufruf und keine Gatefreischaltung wurden daraus vorgenommen. Die frühere [KVM-Bewertung und Entscheidungsfrage](windows-kvm-clock-contract-proposal.md) ist der historische Vorschlag; die ausdrückliche Zustimmung gilt nur unter den dort genannten Betriebsannahmen.
Der neue Modus vertraut den dokumentierten Windows-Zeit-APIs und einer korrekt laufenden Hardware-/KVM-/QEMU-Zeitbasis als nomineller Intervalluhr. Er behauptet keine unabhängig gemessene physikalische Genauigkeit. Vor Pause, Save/Restore, Snapshot-Rückkehr, Migration oder Host-Suspend müssen beide Agent-/Helperprozesse beendet werden; danach sind frische Prozesse, Challenges und unabhängiger Sync erforderlich. Solche Ereignisse mit weiterlaufenden Prozessen werden nicht unterstützt oder durch eine nicht vorhandene VMGenID-Erkennung scheinbar abgedeckt. Der Code verändert keine VM-/Hosteinstellung.
## Geschützter, disjunkter Loadervertrag
Die bestehende geschützte Datei bleibt `C:\ProgramData\RustDiscoverySystem\time-attestation.json`. Es existiert hier **keine erzeugte Instanz**. Zwei vollständige `deny_unknown_fields`-Records verhindern eine automatische Übernahme:
| Eigenschaft | Schema1 | Schema2 |
| --- | --- | --- |
| Modus | bisherige numerische Kalibrierung | ausdrücklich `trusted_os_active_guest` |
| Profilfeld | `calibrations` mit genau2 Rollen | `trusted_os_active_guest` mit genau2 `qualifications` |
| Basisfehler | positiv und höchstens10ms | kein `base_error_ns`-Feld und kein Nullbasis-Trick |
| Plattform-/Betriebsbindung | bisheriger Qualifikationsvertrag | feste KVM/QEMU/Hyper-V-Clock-Kennung, Provenance-SHA und fester aktiver Betriebsvertrag |
| Fremde/gemischte Felder | verweigert, auch `trusted_os_active_guest:null` | verweigert, auch `calibrations:null` |
Unbekannte Versionen, Profile, Annahmen, Plattformen, fehlende oder doppelte Rollen, falsche Imagehashes und fehlende Qualifikationsreferenzen bleiben geschlossen. Commonfields sind unverändert Schlüsselgeneration, Serverinstanz, vorhandene Gerätebindung und separate öffentliche Zeitkeys. Der Zeitkey bleibt vom konkreten Jobkey unabhängig. Die tatsächlich installierte eigene Dienst-/Token-/Imageidentität wird weiter unabhängig geprüft; ein Konfigurationswert ersetzt diese Prüfung nicht.
## Softwarebudget und Fences
Der vollständige native Getterbracket bleibt Interrupt-before, Unbiased-before, Wallclock, Unbiased-after, Interrupt-after. Schema2 verwendet konservativ das Maximum der **beiden vollständigen** Interrupt-/Unbiasedbracketbreiten. Die Umrechnung von100ns-Einheiten nach Nanosekunden erfolgt exakt mit überlaufgeprüfter Ganzzahlmultiplikation; dafür fällt kein Umrechnungsrest an. Es wird keine zusätzliche positive physikalische Fehlerkonstante erfunden. Ein im nominellen OS-Zählerraum gleichwertiger Capture darf deshalb ein Nullbracket liefern; das ist keine physikalische Nullfehlerbehauptung. Schema1 behält unverändert seinen bisherigen Interruptbracket plus tatsächlich qualifizierten positiven Basiswert.
Die bestehenden Budgets bleiben erhalten: maximal50ms für die konservative Summe der drei Captures; volle selbst gemessene RTT und konservative1s-/100ms-Frischegrenzen. Codec, Wirebytes, Signaturdomäne, getrennte Nonces/Rollen/Inkarnationen, eigener Boot-/Connectionkontext und gesamtes UTC-Intervall ändern sich nicht. Jede spätere Nutzung erfasst die eigenen Getter erneut; keine Belegverlängerung. Serverquellqualität und jeder normale Sync-/Grant-/Verbrauchs-/Ledger-/WebUI-Gate bleiben zusätzliche Voraussetzungen.
Ein zusätzlich geschlossener Constructorfehlerpfad verhindert Wiederbelebung nach beobachteten fehlerhaften Konfigurationen: Der Rawhash wird **vor** JSON-/Profilprüfung gegen den gehaltenen Prozesshead beobachtet. Unterschiedliche Bytes invalidieren den globalen Epoch ohne Übernahme eines neuen Hashes oder Floors. Ein RAII-Fence schließt bekannte Autorität auch bei geschütztem Lese-/Pinfehler oder abgebrochenem Konstruktor. Erfolgreiche Konstruktoren derselben gültigen Konfiguration drehen den Epoch nicht. Wiederherstellung alter Bytes heilt keine alte Evidenz oder offene Nonce; erst eine neue Challenge ist zulässig. Die bisherige monotone Konfigurationsannahme bleibt erhalten; diese Änderung erfindet kein dauerhaftes neues Floorjournal.
## Öffentliche Producer-Form für den späteren echten Beleg
Der konkrete serialisierbare Rust-Vertrag ist `Configuration::TrustedOs(TrustedOsConfiguration { ... })`; er kann ausschließlich aus tatsächlich gelieferten öffentlichen Nachweisen befüllt werden. Die folgende Form benennt Pflichtdaten, enthält keine Dummykeys und erzeugt keine Konfiguration:
| Feld | Erforderliche echte Quelle |
| --- | --- |
| `schema_version` | exakt2 |
| `key_generation`, `server_instance`, `public_keys_hex` | tatsächlich qualifizierter permanenter Broker-/Signierrollenbeleg; nur öffentliche Zeitkeys |
| `binding` | unveränderte bestehende geschützte Geräte-/Tenant-/Enrollment-/Assignment-/Jobpublickeybindung |
| `trusted_os_active_guest.operating_assumption` | exakt `active_guest_no_pause_save_restore_snapshot_migration_host_suspend` |
| `trusted_os_active_guest.platform` | exakt `kvm_qemu_hypervclock` |
| `trusted_os_active_guest.platform_provenance_sha256` | tatsächlicher selektiver Plattform-/Betriebsannahmenbeleg, separat geschützt durch Root provisioniert |
| `trusted_os_active_guest.qualifications` | genau eine Referenz je `agent` und `system_helper`, jeweils exakter neuer Produktimagehash plus tatsächlicher rollen-/imagegebundener Qualifikationsbeleg-SHA |
Keine Tabelle, Referenz oder Source-Datei ist selbst eine Kalibrierung oder Jobfreigabe. Der spätere Root-Producer muss Originalbelege, exakte Images und deren unabhängige native Abnahmen prüfen, bevor er diese Form serialisiert und den geschützten Konfigurationswechsel als eigenen überprüften Fall durchführt. Fehlende echte Daten bleiben fehlend; kein automatisches `calibrated=true`, kein beliebiger Betrag und kein privater Keyimport. Die Vorqualifikationsreferenz darf nur die tatsächlich belegten Source-/Image-/Dienstrollen-/Rohcapture-/Plattformbefunde aussagen: Sie behauptet noch keine funktionierende signierte Runtime. Deren unabhängige native Prüfung folgt nach Bereitstellung der echten öffentlichen Zeitkonfiguration; ein clockpflichtiger Helper-Snapshot oder bereits bereiter Clockgate ist keine Voraussetzung des ersten passiven Bootstrapwitness. Die aktuell früher gelinkten Produktpaare sind wegen dieses neuen Modulcodes veraltet; ein neues Paar und neue native Nachweise folgen getrennt.
## Tatsächliche lokale Qualifikation
Unveränderlicher202-Input-Fall `trusted-os-qualification-c4679433-b632-4d6e-8668-f0f2fb54a542`, Manifest `e2f0abd2909129554431257b06ae17774c95fb5abd428cbefeba2c4f573ca269`, Modulquelle `d8594c1eba2c2cc5d5fde4a462b2110aa2e7e64081452b742c4ed81a2cfb477d`, Receipt `96b05fe13f4d459b4b3ef78292beea33827b1ea47293ffb5921c685940e82a4d`. Offline-Docker, Quellen nur lesbar, eigene private Targets, keine Credentials-Mounts.
- Rustfmt und Linux-Lib/Tests-Clippy mit `-D warnings`: PASS.
- Linux-Release-Link und die acht relevanten `signed_clock`-Guards: PASS. Vollständige Liste18; zehn andere Tests ausdrücklich herausgefiltert. Drei neue Guards prüfen disjunkte Opt-ins und beide Rollenbindungen, beide vollständigen Brackets samt Integer-/Budgetgrenzen sowie den tatsächlichen malformed-Raw-Loaderpfad mit Restore und geschlossenem alten Epoch/Pendingowner.
- Windows-GNU-Alltargetscheck und Clippy mit `system-helper`: PASS. Release-Lib-Test-EXE erfolgreich gelinkt, **nicht ausgeführt**. Kein neues Produktpaar in diesem Beleg.
Der erste Windowscheck scheiterte vor Crateprüfung an fehlenden Execbits alter kopierter Cache-Buildskripte. Originalfehlerlog/Exit101 sind erhalten. Nach Änderung ausschließlich der eigenen kopierten ELF-Buildskriptmodi bestanden dieselben eingefrorenen Quellen separat; keine Unterdrückung eines Sourcefehlers.
Linux-ELF `trusted-os-clock-tests`:4245312Bytes, SHA256 `0ae3487cff59c349ebde629fce3258c9f298e5cc24562bf2020409865f224912`. Windows-Lib-Test-EXE:12772565Bytes, SHA256 `ecb57571b8df1b4a178f7d7e2dc1ad21fee11cdb5ea558a2eb35a52f544e64e5`. Beide Übergabedateien Modus0500/ein Hardlink. Lokale Guards/Cross-Link ersetzen nicht die tatsächliche Cloud-Linux-Ausführung und anschließenden Windows-Rollen-/Runtimebelege. Gates bleiben bis dahin geschlossen. Strukturierter EventLog-Kindadapter und übrige Windows-Wirkungsabnahmen bleiben gesondert offen; Windows ist nicht vollständig abgenommen.
## Getrennte vorbereitete Folgeschritte
Der neue feste Linux-first-Operator ist `deploy/windows_trusted_clock_linux_acceptance.py`, SHA256 `cbabb7c88bf070bcc3ac6933650a7abf114e00b5bcabe3aefdfc4db213a997a9`. Lokal vorbereiteter Fall `293ecff5-6c6f-47a2-9ce2-60de0ffe99ed`, Manifest `52cda33ccba636adc35fb534e34095be7b3d9d3abc0ff7c9896c29dd433fc373`. Er prüft die vollständige18er-Liste vor den acht festen `signed_clock`-Guards; zehn fremde Cratetests bleiben transparent gefiltert. Die tatsächlichen bestehenden Linuxruntime-Witnesses und der auf die eigene Prozessgruppe begrenzte Runner sind bytegleich zum vorherigen Raw-Clock-Operator. Python-AST, lokale Prepare-/Revalidation und dieser Bytevergleich PASS. Keine Zielausführung durch diesen Agenten; Root führt den einmaligen nativen Lauf und den separaten Originalfall-Read durch.
Danach separat tatsächlich gebaut: neues Windows-GNU-Produktpaar aus exakt demselben202-Input-Snapshot und derselben Modulquelle `d8594c1e…`, Fall `trusted-os-candidate-link-542cbf43-afb2-4994-b141-06e003e5e2e8`. Offline/Netzwerk aus, Quellen nur lesbar, keine Credentials-Mounts, ausschließlich Agent und SYSTEM-Helper. Release-Link Exit0 (17.91s), Quellen vorher/nachher unverändert. Receipt `04ed34e6e850aca77c1fd4677ddb271f7ccd9492a97f5d4e00ead4c1f032f29d`, Buildlog `e9437ac94a63d20a68c1af35f1670042fe44407796a03541cdcd7bdb9e16bfaa`.
| Neuer Profilkandidat | Bytes | SHA256 |
| --- | ---: | --- |
| Agent | 22283627 | `26dc9d2f6928c5a41050ac9324e041c065e7a9ae52324416f3bb6222c002ae6b` |
| SYSTEM-Helper | 13143052 | `59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e` |
Beide sind AMD64-PEs, Modus0500/ein Hardlink. Frühere Paare bleiben historisch erhalten. Kein Paarupgrade, neuer Mainindex, öffentliches Zeitpinfile, Kalibrierungswert oder Clockgatewechsel wurde ausgeführt. Der aktuelle passive Paarcontroller bleibt weiterhin fest geschlossen und bindet noch seine vorige Kandidatengeneration; diese neue Generation erfordert später einen eigenen überprüften Controllerbeleg und frische CAS-/Serverwitnesses. Die öffentliche Producer-Form oben enthält bewusst nur tatsächlich zu belegende Felder und keine Platzhalterkonfiguration.
## Tatsächlich Linux-first auf der Cloud-VM bestanden
Originalfall `293ecff5-6c6f-47a2-9ce2-60de0ffe99ed`: vollständige18er-Liste
vor Ausführung geprüft, genau acht signed_clock-Guards bestanden,0failed/ignored,
zehn andere ausdrücklich gefiltert. Execute-Receipt
`98aae935740eb4c9d50366715be9a130791b141681b091af431129d6f833f563`.
Separater Originalread bestätigt gleiche Source-/Artefaktbindungen und erhaltene
aktuelle Runtime-/Control-/Stateidentitäten, Receipt
`06711537d71f436b7776e7c2d47eb6e2963820b7a6c55302bc7786568c23c28b`.
Unabhängiger Quellenreview des Schema-/Bracket-/Constructorfencedeltas ebenfalls
ohne konkreten Befund abgeschlossen. Keine Windows-Rollen-/Zeitkonfiguration,
kein RMM-Job oder Effektgate wurde dadurch aktiviert.
## Tatsächliche öffentliche Vorbereitungsdaten, keine Konfiguration
Lokaler Fall `windows-time-profile-public-preparation/c3077acf-12da-410e-9f55-e75a1cd0a75f`
bindet den tatsächlich selektiv gelesenen KVM-/Hypervclock-Plattformbeleg94ae865e…,
den echten öffentlichen Zeitpin c31d31d2…, die unveränderte öffentliche14fb-
Gerätebindung und das tatsächliche202-Input-Produktpaar26dc/5967. Receipt
`97e4db147f31f3cff134d2bc596d7d73ea5330b8b5a87971f215bb03a9751391`,
Provenienz `1c0db66cd0692024f68bddd71949692d274380a86e4b880fea0756479ceb5d0c`.
Timekey und konkreter Jobkey sind verschieden. Keine private Signierdatei gelesen.
Der ausdrücklich gelieferte öffentliche Plattformoriginalbeleg hat Modus0664;
der vorhandene0600-Pinloader wies ihn zuerst erwartungsgemäß ab. Originalbytes
und Modus wurden nicht geändert. Die bekannte SHA94ae bindet ausschließlich eine
neue eigene0600-Kopie innerhalb dieses lokalen700-Falls; sie wird nicht als schon
provisionierter geschützter Zielpin ausgegeben. Keine zusätzliche Operatorquelle
oder Toolinstallation entstanden.
Dieser Fall ist ausdrücklich **keine** `time-attestation.json`. Für die beiden
Schema2-`qualification_sha256` fehlen noch tatsächliche Dienst-/Prozess-/Imagebelege
der neuen Produktimages. Der frühere Rawcapture-Probe601… ist ein anderes Image
und ersetzt diese Bindung nicht. Nach der getrennten passiven Paarwartung dürfen
die tatsächlichen neuen LocalService-/SYSTEM-Kernel-/Servicebelege mit vorhandenen
Source-, Rawcapture- und Plattformbelegen verbunden werden. Erst danach wird die
echte V2-Konfiguration erstellt; Runtimefrische und Genehmigungen folgen getrennt.
## Zeitprüfung bei ausgeschalteten Jobs am 15. November 2026
Die Konsole der laufenden VM bestätigte, dass weder der Jobschalter noch die
Jobbindung konfiguriert waren. Die Zeitprofildatei war noch nicht installiert.
Die bisherige Runtime übersprang bei ausgeschalteten Jobs auch den gesamten
signierten Zeitvergleich. Damit konnte die geplante Rollenprüfung über diesen
passiven Dienststand nicht beginnen.
Im neuen Quellstand prüft der Agent am Heartbeat, ob das geschützte Zeitprofil
vorliegt. Erst dann beginnen Agent und Helper den vorhandenen Vergleich mit
eigenen Challenges. Für den passiven Betrieb beträgt die Pause zwischen
Vergleichen pro Rolle 30 Sekunden. Die Datei allein belegt keine Zeitqualität.
Beide Rollen prüfen Pin, Gerätebindung, Signatur und Fristen. Der Jobschalter,
die JobClock und die Genehmigung bleiben getrennt. Ein Fehler beim Start des
passiven Vergleichs lässt Heartbeats und Inventar weiterlaufen.
Neun gezielte Prüfungen bestanden erst lokal und dann auf der Cloud-Linux-VM
als UID 65534 (Exit 0, 15 weitere Tests gefiltert, Ergebnis-SHA-256
`3424b0f916f0c9e68ed24d8ee0adeeb5feb5e8e834f63cfcbaadc5e45b06f840`).
Die neue Prüfung umfasst Profilauswahl und Abfrageintervall. Der Windows-Crossbuild
der Librarytests und Clippy mit allen Windows-Targets und `system-helper`
bestanden. Die installierten Dienstbinärdateien haben eigene Versionsnachweise.