Files
rust-discovery/docs/windows-signed-clock-capture.md
2026-11-15 00:45:05 +01:00

198 lines
11 KiB
Markdown

# Windows: begrenzte Rohbeobachtung der präzisen Uhrgetter
Stand2026-11-15, Spezifikation1.22. Dieser getrennte Schnitt bereitet die
tatsächliche Timerbewertung des [signierten Zeitvergleichs](windows-clock-attestation-proposal.md)
vor. **Kein Calibrationpin, kein TrustedClock, keine Jobfähigkeit.** Der frühere
6b66612b-Quellenschnitt und sein184-Input-Snapshot bleiben unverändert erhalten.
## Gemeinsame Getterfolge, keine alternative Clockautorität
`signed_clock.rs` verwendet jetzt genau eine private `raw_capture`-Funktion für
installierten Verifier und Diagnose. Ihre feste Reihenfolge ist:
1. `QueryInterruptTimePrecise` vor der Wallclock;
2. `QueryUnbiasedInterruptTimePrecise` davor;
3. `GetSystemTimePreciseAsFileTime`;
4. `QueryUnbiasedInterruptTimePrecise` danach;
5. `QueryInterruptTimePrecise` danach.
Alle drei APIs sind dokumentierte VOID-Getter. Auf Windows10+ wird ihr
Vorhandensein vorausgesetzt; kein optionaler Lookup, fremder Zielprozess oder
Fallback. Null-/ungültige Werte und rückläufige Getterintervalle verweigern.
[Unbiasedgetter](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryunbiasedinterrupttimeprecise),
[Interruptgetter](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryinterrupttimeprecise).
Nur der installierte Verifier darf die privaten Rohwerte über seinen bisherigen
`bracket_sample`-Pfad mit einem tatsächlich qualifizierten geschützten
Grundfehlerbudget zu einem `Sample` machen. Der Diagnosepfad hat kein solches
Budget und erzeugt kein `Sample`, keine Signatur, Clockinstanz oder Lease.
Er ruft weder den Konfigurationskonstruktor noch eine Ersatzfreigabe auf.
Der Getterrefactor verändert keine Key-, Nonce-, Continuity-, Connection- oder
WebUI-Grenze. Zusätzliche rohe Rangeguards verweigern lediglich.
Die Diagnose verwendet exakt128 Captures mit festen nominalen1ms-Zielabständen.
Sie wartet nur mit `spin_loop` und eigener `std::time::Instant`-Beobachtung,
höchstens250ms für die Erhebung. Auch die tatsächlich gelesene gesamte
Interruptspanne darf250ms nicht überschreiten. Rückwärtswerte, eine beobachtete
Diskontinuität über1s, unvollständige Serie oder überschrittenes Budget brechen
ab. Ein Schedulerstillstand wird nach Wiederzuteilung als überschrittenes Budget
verweigert; daraus wird keine präzise Prozess-Endegarantie abgeleitet.
Der kompakte Rohbericht enthält fünf100ns-Spalten je Zeile: Wallclock-FILETIME,
Interrupt vorher, Unbiased vorher/nachher, Interrupt nachher. Er meldet
tatsächliche Bracketbreite und maximale beobachtete Wall-/Interrupt- sowie
Interrupt-/Unbiaseddifferenzen, Stichprobenzahl und beide verstrichenen Spannen.
`calibrated=false` und `clock_authority=false` bleiben fest. Es gibt keine
Deserialisierung als Clockbeleg und keine Caller-Samples in der nativen API.
Der vollständige Diagnosebericht einschließlich Prozessmetadaten bleibt
höchstens16KiB; keine Host-/Benutzernamen, Peers, Schlüssel oder Kundendaten.
## Enges eigenes SCM-Fixtureprofil
Das neue Example `examples/signed_clock_capture.rs` installiert oder konfiguriert
keinen Dienst. Nur ein gesonderter Native-Operator darf nach Source-/Binaryreview
die beiden fest benannten temporären OWN_PROCESS-/Demand-Start-Fixtures anlegen:
- `RmmSignedClockCaptureLocalService` unter LocalService/SID19;
- `RmmSignedClockCaptureSystem` unter LocalSystem/SID18.
Beide benötigen ihre eingeschaltete eigene Dienst-SID. Sie werden getrennt
gestartet und beobachtet. Der Prozess prüft tatsächlichen Account und aktivierte
eigene Dienst-SID mit der bestehenden Tokenprüfung; Threadimpersonation,
unbekannter Account und aktivierte Administratorgruppe bei SID19 verweigern.
Elevationflag und Elevationtyp sind separate unverfälschte numerische Angaben.
Ein Administratorprozess kann keinen LocalService-Nachweis ersetzen.
Feste, **geplante und hier nicht ausgeführte** Argumentform:
```text
SignedClockCapture.exe --service <kanonische-v4-Fall-UUID> local-service
SignedClockCapture.exe --service <kanonische-v4-Fall-UUID> system
```
Kein frei wählbarer Dienstname, Pfad, Programm, Skript oder anderer Modus.
Der Prozess startet ausschließlich über den SCM-Dispatcher, meldet nur seinen
eigenen Running-/Stopped-Status und akzeptiert keine Fremddienststeuerung.
Der Operator muss vorab genau diesen eigenen Case vorbereiten:
`C:\ProgramData\RustDiscoverySignedClockCapture\<UUID>`. Darin liegt exakt
`SignedClockCapture.exe`; der tatsächlich laufende Imagepfad muss dazu passen.
Basis, Case und Image gehören SYSTEM/Administrators und gewähren höchstens den
beiden festen Fixture-SIDs Lesen. `local-service` und `system` sind getrennte
Unterverzeichnisse; nur die jeweilige eigene Fixture-SID darf dort zusätzlich
schreiben. Keine allgemeine LocalService-/Users-Schreibfreigabe. Beide
Fixture-SIDs müssen für die gemeinsame Leserprüfung auflösbar sein; deshalb
beide Definitionen vor der ersten Probe vorbereiten, keine automatische Anlage
durch den Worker. Reparse, fremde ACLs oder ersetzte gehaltene File-IDs sperren.
Jeder Rollenlauf erzeugt ausschließlich seine neuen `intent.json`, `report.json`
und `end.json`. Vorhandene Marker verweigern Wiederholung. Dateien werden
create-only mit Reparse-/Linkprüfung geschrieben und geflusht. Gehaltene
Verzeichnisse und Image bleiben erhalten. Nach verlorenem Reply ausschließlich
denselben Originalfall lesen; kein Löschen, Überschreiben oder erneuter Start
zur Umgehung eines unklaren Laufs. Fehlender Endbeleg ist kein Erfolg.
Der Bericht bindet PID, native Prozessgeburt, Imagehash/File-ID und unabhängig
gewonnene Boot-ID. Die bestehende feste lesende CIM-Bootabfrage läuft vor dem
250ms-Erhebungsbudget; kein Benutzer-/Modellskript. Keine RMM-Konfiguration,
PKI, Journale, Consumption, Helperpins oder tatsächlichen RMM-Dienste werden
geöffnet oder geändert. W32Time wird weder abgefragt noch gesteuert. Es gibt
keinen Netzwerkclient und keine neue RMM-Nachricht oder Capability.
## Nachweise und Grenzen
Erster lokaler Vorbereitungslauf: fünf gezielte gemeinsame Guardtests bestanden,
zehn übrige Cratetests ausdrücklich herausgefiltert. GNU-Alltargetscheck und
Clippy mit `-D warnings` bestanden. Dies war eine schnelle Sourceprüfung vor
dem folgenden eingefrorenen Artefaktbeleg, kein nativer Timer- oder Rollennachweis.
Der folgende eingefrorene Artefaktbeleg ergänzt diese Vorprüfung. Eine VM-Aktion
wurde durch diesen Sourceworker nicht ausgeführt.
Eine konsistente128er-Serie belegt nur diese Beobachtungen unter dem aktuellen
OS-/Hypervisorvertrag. Sie liefert **keine absolute physikalische Genauigkeit**
und keinen bewiesenen Grundfehler durch die größte gemessene Bracketbreite.
Auflösung ist keine Genauigkeit; QPC/Interrupt/Wallclock sind zudem keine
vollständig unabhängigen physikalischen Quellen. Korrektes Verhalten von
Windows-Kernel und Hypervisor bleibt eine ausdrücklich genannte Annahme.
Das erforderliche Grundfehler-Assessment, die geschützte Pinprovisionierung,
reale getrennte Agent-/SYSTEM-Signatur-Roundtrips und Runtime-/Deadlineintegration
bleiben eigene offene MVP-Schritte. Auch eine erfolgreiche temporäre
LocalService-/SYSTEM-Probe ist kein Nachweis der produktiven RMM-Dienstrollen.
## Eingefrorener aktueller Source- und Artefaktbeleg
Neuer eigener Fall6bcd72a7-6de7-48e6-9e9b-3ad2cd3d9b09 bindet190 Inputs.
Der alte184-Input-Fall763baf69 bleibt unverändert. Modul SHA256
`d9dd843db7c17ac4c8f242c9f20063c2a7ce6ad11d3c75826516a22dc5e7685e`,
Example SHA256
`23f7c8d832bf9042fb89226729aa1cfe2a65ad33b76cda15cc69f8995d5834d0`.
Inputmanifest SHA256
`2d21da4d137d2efd48cb2679fb791a9055839b042373d0f38c5af8d9ea8c5a8c`,
Receipt SHA256
`ba9ba8d88ed71952dd8dc803f2e38d5da72edeae392818cd320c6fd532ac7f4d`.
Tatsächlich lokal mit den eingefrorenen Quellen und festgelegten Offlineimages:
- Linux-Release-Lib-Testbinary gelinkt; komplette Liste exakt15 Tests,
0 Benchmarks. Nur die fünf `signed_clock::tests` ausgeführt:5bestanden,
0failed/ignored;10 übrige Cratetests ausdrücklich herausgefiltert.
- Windows-GNU-Releaseprobe mit `--features system-helper --example
signed_clock_capture --target x86_64-pc-windows-gnu --release` gelinkt.
- Windows-GNU-Alltargets-Clippy mit `-D warnings` bestanden.
- Formatcheck ausschließlich von Modul und neuem Example bestanden.
Linuxexe `qualified-linux-tests`:3404432Byte, SHA256
`dceee96d9e58d8b5c3606c724b4d390c2eea6472bf33d317e7a5a9102c0c5e06`.
Windowsprobe `SignedClockCapture.exe`:8566784Byte, SHA256
`601c27a43fb67c662f926f9dc289a23a5c31c7e27f62901a77fc9ceaafaea7fb`.
Beide Artefakte exklusiv kopiert und auf0500 begrenzt; private Quell-/Belegdateien
0600, Verzeichnisse0700. Keine älteren qualifizierten Binaries überschrieben.
Der separat lesbare Capabilitymanifest `readonly-capabilities.json` bindet
Binaries, feste Service-/Konten-/Pfadformen, Clockgetter, eigene Prozess-/
Bootmetadaten, create-only-Ausgaben, Limits und ausdrücklich fehlende
Netzwerk-/RMM-/Zeitsetter-/Fremddienstoperationen. SHA256
`91c75ba877764345b3267731f3880580d02a72df40420479e3c4b76d37064982`.
Das beschreibt aufgerufene Operationen; ein SYSTEM-Prozess wird damit nicht zur
Sandbox. Unabhängiger Review und Native-Operator müssen diesen konkreten
Quellen-/Binärstand vor Zielaufruf prüfen.
Sämtliche Rohbelege bleiben gitignoriert unter
`devstate/windows-signed-clock/raw-capture-qualification-6bcd72a7-6de7-48e6-9e9b-3ad2cd3d9b09/`.
**Nicht durch diesen Worker ausgeführt:** neuer Cloud-Linux-Guardlauf,
LocalService-/SYSTEM-Probe auf Windows, Kalibrierung, Zeitpins, signierter
Serveraustausch oder irgendein RMM-Job. Die vollständige Windows-/MVP-Abnahme
bleibt offen; nächster Schritt ist der getrennte Linux-first-/Windowsnachweis.
## Tatsächlicher Linux-first-Nachweis des Rohcapture-Quellenstands
2026-11-15. Neuer unabhängig geprüfter Runner
`deploy/windows_raw_clock_linux_acceptance.py`, SHA256
`fa0454839b263acc49285a76e468b908b23f3194f9c663d706f5cc01869bb6c4`,
bindet190Originalinputs und das neue Releasebinary. Vor einem einmaligen Lauf
muss die volle15er-Liste exakt stimmen; ausgeführt wird ausschließlich der
feste `signed_clock::tests::`-Filter.
Originalfall `dcef489d-2a24-47cc-b3ca-6628545cdacf`: tatsächlich prepare,
ein execute und separater read auf der Cloud-Linux-VM. **5bestanden,0ignored,
10andere Tests gefiltert, Exit0**, Rückabruf vollständig. Bekannte RMM-
Prozessgenerationen, Kontrollbytes, Boot und DB-/Lock-Identitäten erhalten.
Keine RMM-Jobs, W32Time-/Produktzeitabfrage, Dienste oder Produktdateien geändert.
FallmanifestSHA256
`3a646b8bdab36ef0185c3a1f68d94bdd6ee541ad00d59c2e1fdebe35c3501549`;
ExecuteSHA256
`1c53605e2db930f4e8328ff030726c4fecec9e10bbc24aa13284f90249962c36`;
ReadbackSHA256
`91a750e4de266f5effccbd418a680c1ba4f5e0aff5082489fc021922bdfcafa3`.
Der ursprüngliche Dreierbeleg bleibt historisch unverändert. Keine aktuelle
Gesamtworkspace- oder Windows-Kernelqualifikation aus diesem Linuxlauf ableiten.
Unabhängiger Quellenreview des d9dd843d-/23f7c8d8-Standes bestanden. Das
Erfassungsbudget250ms gilt ausdrücklich nur für die128Getteraufnahmen;
CIM-Bootlesung und eigener Dienst-/Imagebootstrap sind vorgelagert und brauchen
einen separaten Operatorwatchdog samt tatsächlichem Exitbeleg. Noch keine
Windowsausführung, physikalische Zeitkalibrierung oder Root-/SYSTEMjobfreigabe.