Files
rust-discovery/docs/windows-clock-readiness.md
T
2026-11-14 03:53:48 +01:00

265 lines
17 KiB
Markdown

# Windows-Zeitstatus: Adapter und native Readinessprobe
Stand 2026-11-14. Ergänzung zu [Windows-Jobgrenze](windows-job-boundary.md).
Diese Strecke ändert weder die Windows-Geräteidentität noch die WebUI-Grenze.
Ein Zeitstatusbericht ist keine Jobgenehmigung. `NativeClock::now()` verweigert
aktuell immer mit `CLOCK_ADAPTER_UNQUALIFIED`, unabhängig von einem positiven
Diagnosestatus; `ADAPTER_QUALIFIED=false` bleibt bis zur tatsächlichen nativen
Adapterabnahme im Code fest geschlossen. Der aktuelle RPC-Prototyp ist
noch kein vollständig qualifizierter produktiver Zeitvertrauensnachweis.
## Vertrag und konservative Genauigkeitspolitik
`crates/agent-windows/src/clock.rs` enthält eine numerische Statusauswertung und
einen `SyncClock`-Adapter. Ein Stub wird aus dem engen IDL mit WIDL generiert;
der C-Adapter fängt RPC-Ausnahmen mittels Windows-SEH vor der Rust-Grenze ab.
Einziger aufgerufener Statusvertrag ist MS-W32T Interface4.1, Opnum6. Die sechs
vorherigen IDL-Platzhalter erhalten ausschließlich dessen Ordinal; sie werden
niemals aufgerufen und bilden keine mutierenden Produktfunktionen ab.
Die Zeitintervalle für Verzögerung, Dispersion, Phasenabweichung und Alter sind
100ns-Einheiten. `qwLastSyncTicks` ist dagegen ein UTC-FILETIME seit1601;
`tpTimeLastGoodSync` bezeichnet das verstrichene Alter seit dem letzten guten
Abgleich, kein zweites UTC-Datum:
[Statusstruktur](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/f60ebce0-df96-4c96-b40b-fdbd34a2c936),
[Zeitdienstelemente](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/1da649d7-3edf-4a9a-98c2-907ecacd1633).
Der technische Default verlangt gemeinsam:
- `SYNC=2`, letztes Syncergebnis0, Leap0..2 und Stratum1..15;
- letzten erfolgreichen Abgleich höchstens3600s alt, UTC-Zeitstempel nicht in
der Zukunft, beide Altersdarstellungen innerhalb1s plus Abrufdauer konsistent;
- Dispersion + halbe nichtnegative Root-Roundtripverzögerung + absolute
Phasenabweichung + gesamte gemessene Abrufdauer höchstens2s;
- Abrufdauer höchstens1s, bekannte Flags und exaktes x64-Strukturlayout120Byte.
Negative Root-Verzögerung wird konservativ verweigert, auch wenn einzelne
Zeitquellen solche Werte liefern können. Überlauf, unbekannte Felder, Fehler,
veralteter oder widersprüchlicher Status schließen das Gate. Das separate
MS-SNTP-Authentifizierungsflag wird nicht über die bestehende Linux-NTP-Politik
hinaus verlangt. Die Werte begrenzen die gemeldete technische Unsicherheit;
sie ersetzen keine neue kryptografische Vertrauensentscheidung für Zeitquellen.
[Synczustände](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/b4abb4b0-6d6e-41e4-bd41-d54980d0598a).
Wallclock und beide präzisen Kernel-Interruptzähler werden vor und nach jedem
Abruf beobachtet. Der unbereinigte Zähler berücksichtigt Schlafzeit, der
unbiased-Zähler schließt sie aus. Eine Differenz oder Wallclockänderung über1s
invalidiert. Ein späterer Status kann erst nach einem tatsächlich erfolgreichen
Abgleich mit UTC-Zeitstempel nach dieser Diskontinuität wieder öffnen. Einfaches
Pollieren des alten Pre-Resume-Status genügt nicht. Es wird kein OS-Suspend oder
Uhrsprung als destruktiver nativer Test ausgelöst:
[Interruptzähler](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryinterrupttimeprecise),
[Zähler ohne Schlafzeit](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryunbiasedinterrupttimeprecise).
## Lokaler RPC und verbleibende Identitätsfrage
Der erste Readiness-Prototyp benutzt ausschließlich lokalen `ncacn_np` am
festen authentifizierten Endpunkt `\\pipe\\W32TIME_ALT`, WINNT, PacketPrivacy,
Identify und den tatsächlichen Prozesskontext; keine Zugangsdaten und kein
Fallback zum unauthentifizierten W32TIME-Endpunkt. Der NDR-Allocator begrenzt
seine Gesamtdaten auf64KiB. RPC-Timeout1,5s ist ein Paket-Inaktivitätslimit;
zusätzlich verweigert die Auswertung jede tatsächlich über1s dauernde Abfrage.
Ausgaben enthalten nur begrenzte numerische Statusfelder und Fehlercodes, keine
Peer-Namen, Adressen oder Rohdaten.
[MS-W32T-Transport](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/e0803f6b-e175-4b87-ba63-bbcf51175655),
[RPC-Zeitlimit](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/nf-rpcdce-rpcbindingsetoption).
WINNT mit PacketPrivacy authentifiziert allein noch nicht zuverlässig die
Identität des lokalen Named-Pipe-Servers. NTLM kann auch bei gesetztem
`MUTUAL_AUTH` Erfolg melden, obwohl es keine gegenseitige Authentifizierung
unterstützt. Eine solche Flagänderung ist kein Sicherheitsnachweis. Vor
Produktintegration muss zusätzlich die tatsächliche Serveridentität belastbar
gebunden werden. `RPC_SECURITY_QOS_V3.Sid` ist insbesondere für `ncalrpc`
dokumentiert; ob die aktuelle W32Time-Implementierung einen entsprechend
qualifizierbaren lokalen Endpunkt anbietet, ist offen. Kein automatischer
Wechsel auf einen schwächeren Transport.
[RPC-QoS](https://learn.microsoft.com/en-us/windows/win32/rpc/quality-of-service),
[SID-Vertrag](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/ns-rpcdce-rpc_security_qos_v3_w).
## Getrennte LocalService-Probe
`examples/clock_readiness.rs` ist ein eigener kurzlebiger SCM-Dienst
`RmmWindowsClockReadiness`. Er prüft im eigenen nativen Prozess TokenUser
`S-1-5-19`, erfasst das tatsächliche Elevationflag und den Elevationtyp sowie
aktivierte Administratormitgliedschaft und SYSTEM-Identität separat, liest zwei
Zeitstatuswerte und schreibt einen
höchstens16KiB großen Bericht. Keine RMM-Verbindung, kein Agentenstop, keine
Uhrkorrektur und keine Änderung von W32Time-Konfiguration oder System-ACLs.
`deploy/windows/clock_readiness.py` legt für jeden Versuch einen neuen privaten
Fall mit UUID, Source-/Binaryhash und dauerhaftem Intent vor dem RPC an.
Bootstrapdateien liegen versioniert unter einem eigenen privaten Verzeichnis.
Nur der eigene Readiness-Dienst erhält Schreibrecht auf seinen Ergebnisordner;
das Manifest bleibt Administratoren/SYSTEM vorbehalten. Nach Dienstende werden
Statusbericht und exakte Dienstkonfiguration gelesen und ausschließlich dieser
eng gebundene gestoppte Hilfsdienst entfernt. Ausgelieferte Dateien und private
Belege bleiben für Readback erhalten. Der vorhandene Bootstrap verwendet nur
prozessbezogen `RemoteSigned`, keine Maschinenrichtlinienänderung und keine
entsprechende Erlaubnis für spätere RMM-PowerShell-Jobs.
Nach unklarer SSH-Antwort ausschließlich `readback --id <bestehende UUID>`
verwenden. Kein erneutes Starten desselben Falls, kein blinder neuer Start als
Ersatz. `native_execution_verified` weist die tatsächliche LocalService-Probe
nach; `diagnostic_status_ready` bildet den Rohstatus beider Berichte ab; `clock_ready`
verlangt zusätzlich die getrennte Adapterqualifikation. Rohstatus allein kann
niemals produktive Clock-Bereitschaft behaupten. Ein negativer
Status ist ein gültiger Messbeleg und keine Freigabe für Jobcapabilities. Die
oben offene Serveridentitätsbindung bleibt dabei eigenständig erforderlich.
Das rohe Elevationflag wird nicht mit Administratormitgliedschaft gleichgesetzt;
seine tatsächliche Bedeutung für dieses Diensttoken wird erst nativ ermittelt.
[Token-Elevation](https://learn.microsoft.com/en-us/windows/win32/api/winnt/ns-winnt-token_elevation),
[aktivierte Gruppenmitgliedschaft](https://learn.microsoft.com/en-us/windows/win32/api/securitybaseapi/nf-securitybaseapi-checktokenmembership).
## Tatsächlich lokal ausgeführte Qualifikation
- WIDL-Generierung und beide C-Objekte Windows-x64 mit Clang-SEH und `-Werror`:
erfolgreich; statische C-Assertions bestätigen120Byte-Status/64Byte-Rust-ABI.
- WindowsGNU-Crossbuild der Readiness-EXE mit Lockfile/offline: erfolgreich.
- Drei Rust-Tests: Status-/Unsicherheitsverweigerung, Suspend mit notwendigem
anschließendem Sync, Wallclockrücksprung/Überlauf: alle bestanden.
- Drei Python-Guards: readback nach verlorener Startantwort ohne erneuten Start,
Sourceänderung verweigert, fehlender nativer Bericht verweigert: bestanden.
- Alle drei PowerShell-Bootstrapfragmente mit PowerShell-Parser geprüft.
Toolchain lokal im Entwicklungscontainer
`rust-discovery-windows-clock-full:local` aus dem bisherigen gecachten
Windows-Buildimage mit `mingw-w64-tools` und `clang`. `build.rs` verlangt für
Windows derzeit genau x86-64/GNU; MSVC und andere Architekturen sind nicht
qualifiziert. Compiler-/Containerprüfungen ersetzen keine tatsächliche
Windows-Ausführung. Native Ergebnisse werden getrennt im Projekt ergänzt.
## Native Zwischenstände: keine Clock-Abnahme
Der Root-Runner hat drei getrennte Fälle durchgeführt und die Belege privat
unter `devstate/windows-client/clock-readiness/` erhalten:
- `995eb9c1-e1f4-4b17-85b4-5976e9e362e6`: vor Upload/Diensterstellung
verweigert. Die ACL-Prüfung berücksichtigte das automatisch ergänzte reine
Synchronize-Recht nicht. Tatsächlicher Readback: Rootbesitzer Administrators,
nur SYSTEM/Administrators FullControl und LocalService ReadExecute+Synchronize,
kein Hilfsdienst, kein Remote-Fall und keine Dateien. Danach wurde nur dieses
zusätzliche Nichtschreibrecht im engen ACL-Maskenvertrag zugelassen.
- `89b3e688-50ae-4cbd-b519-16a379aa6424`: Hilfsdienststart scheiterte mit
behandeltem1066, kein Ergebnisbericht. Derselbe Fall wurde ausschließlich
gelesen und sein exakt gebundener gestoppter Hilfsdienst entfernt. Ursache
noch nicht durch einen spezifischen Fehlercode belegt.
- `513fb6df-df3b-43a2-bada-a0f7bb939f54`: nach Erweiterung um tatsächliche
Tokenfelder wurde kein Ergebnisbericht erzeugt; Dienstexit1067. Nur die eigene
ApplicationError-Metadatenabfrage belegte Exception `c0000005` im eigenen
`WindowsClockReadiness.exe` um2026-11-13T23:52:57.3579204Z. Auch dieser exakt
gebundene gestoppte Hilfsdienst wurde im Readback entfernt. Das ist ein
tatsächlicher nativer Fehler, kein DLL-/Zugriffs-/Zeitstatus-Erfolgsnachweis.
Die danach vorbereitete Probe schreibt den begrenzten Tokenbeleg bereits vor dem
RPC dauerhaft und führt numerische SCM-Stufen für behandelte Fehler. Der konkrete Compiler-TLS-Fehler wurde danach lokalisiert und behoben (unten).
Authentifizierte Serveridentitätsbindung bleibt offen; Windows-Jobclock
bleibt unqualifiziert und das Jobgate geschlossen. Die permanenten Agenten,
Geräteidentitäten, Zeitdienste und Cloudserver wurden von diesen ausschließlich
eigenen Readinesshilfsdiensten nicht verändert.
Der zusätzliche eigene Fehleroffset `0x48b4e4` ließ sich mit der exakten
EXE9be65748… und ImageBase`0x140000000` lokal mittels MinGW-addr2line auf
`release_allocations()` abbilden. Disassembly zeigt dort den Zugriff auf eine
NULL-Compiler-TLS-Basis des SCM-Threads. Der Korrekturbuild ersetzt ausschließlich
diesen `_Thread_local`-Allocatorzustand durch `InitOnceExecuteOnce`/`TlsAlloc`
und eine pro synchronem Aufruf über `TlsSetValue` gebundene, geprüfte Arena.
Aufrufende Threads ohne Arena erhalten keine Allokation; nach Cleanup wird der
Pointer gelöscht. Endpoint, RPC-Authentifizierung und IDL wurden dafür nicht
abgeschwächt. Die begrenzte Tokenprobe wird vorher dauerhaft geschrieben.
Dieser korrigierte Build wurde erfolgreich crossgebaut; die drei Rusttests,
drei Runnerguards und PowerShellparser liefen erneut erfolgreich. Der native Nachweis folgt im nächsten Absatz.
Native Korrekturprobe `ecf04ebb-23e4-48da-b324-56d98460cd64`, EXE
`4219054b8c51462458ab36fcb0eee3ad5e6905e4725621e6f5103c3e0eca9f4f`:
tatsächlich ausgeführt, zwei Statusabrufe, dauerhafte Token- und Ergebnisberichte,
Hilfsdienst danach entfernt. Beide Abrufe liefern RPC1722 (`CLOCK_UNSUPPORTED`),
keinen Zeitstatus und `clock_ready=false`; gemessene Dauer3,6513ms und0,2029ms.
Damit ist der Compiler-TLS-Absturz für diese Strecke nativ behoben, aber kein
Zeitvertrauen belegt. Das echte Diensttoken besitzt SID`S-1-5-19`, keine aktivierte
Administratormitgliedschaft und keine SYSTEM-Identität, dennoch
`TokenIsElevated=1`/`TokenElevationType=Default(1)`. Der rohe Elevationswert darf
nicht als gleichwertige Administratorzugehörigkeitsprüfung verwendet werden.
Eine anschließende enge Endpointprobe ist nun implementiert und lokal
crossqualifiziert: ausschließlich lokaler EPM, exakte Clock-UUID/Version4.1,
höchstens16 Einträge, nur aggregierte Transportanzahlen und Fehlercode. Keine
Endpointnamen, Annotationen oder Adressen verlassen die C-Grenze. Diese Probe
führt keinen ALPC-Statusaufruf aus und ersetzt keine Serveridentitätsprüfung.
Der entsprechende neue native Durchlauf ist noch offen.
## Implementierter nächster Kandidat: ALPC mit fester Server-SID
Der zuvor vorbereitete V3-Kandidat verwendete ausschließlich einen
lokal per exakter Interface-UUID/Version gefundenen `ncalrpc`-Endpunkt. Die
verlangte Server-SID wird lokal als LocalService`S-1-5-19` erzeugt und mittels
`RPC_SECURITY_QOS_V3.Sid` und `MUTUAL_AUTH` fest gebunden. WINNT/PacketPrivacy,
Identify und der echte Prozesskontext bleiben erforderlich. Es gibt keinen
Status-Fallback auf Named Pipes und keine Übernahme einer Identität aus der
Endpointliste. Ein fremder registrierter Endpunkt kann so höchstens die
Bereitschaft verhindern. Dieser Vertrag trennt unterschiedliche Windowskonten;
ein Angreifer mit bereits denselben LocalService-Prozessrechten gehört nicht
zu einer neu behaupteten Prozessisolation. Der zuvor dokumentierte Named-Pipe-
Abruf bleibt eine getrennte Diagnose und liefert selbst bei geeignetem Status
immer `trusted=false`/`CLOCK_SERVER_IDENTITY_UNQUALIFIED`.
Da Windows die synchrone RPC-Timeout-/Cancel-API für `ncalrpc` nicht entsprechend
unterstützt, begrenzt ein einziger prozessweiter RPC-Worker den Aufrufer. Er
verwendet einen Kanal mit Kapazität1 und maximal1s Antwortwartezeit. Ein Timeout
vergiftet diesen Worker dauerhaft: keine Ersatzthreads, kein blindes Wiederholen,
kein Rückfall auf Named Pipes. Selbst bei einem hängenden read-only RPC existiert
höchstens ein solcher Worker; die Agenten-/Telemetriearbeit kehrt mit
`CLOCK_UNTRUSTED` zurück. Rekonstruktion eines `NativeClock`-Objekts setzt diesen
Zustand nicht zurück. Parallelaufrufe bei belegtem Worker werden verweigert.
[RPC-Cancel-Grenzen](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/nf-rpcdce-rpccancelthreadex).
Dieser Kandidat wurde erfolgreich für WindowsGNU crossgebaut. Fünf lokale
Rusttests bestehen, einschließlich Timeout und nachfolgend verweigerter zweiter
RPC-Wirkung sowie unverändert geschlossenem Qualifikationsgate; die früheren
drei Clocktests bleiben erhalten. Vier Runnerguards bestehen, zusätzlich
Rohstatusbereitschaft ohne Adapterqualifikation verweigert produktive Bereitschaft. Native Nachweise für
ALPC-Verfügbarkeit, feste SID-Bindung und positive Zeitbereitschaft stehen aus.
Das ist weiterhin keine Windows-Jobclock-Abnahme.
Ein eigener Bootstrap-Readback des Root-Agenten bestätigte für W32Time
`Stopped`, Startart`Manual`, KontoLocalService`S-1-5-19` und PID0. Die
RPC1722-Werte der korrigierten Probe sind damit konsistent. Der Zeitdienst wurde
für diese Readinessstrecke nicht gestartet oder umkonfiguriert. Ein entsprechender
eng begrenzter Start des bestehenden Dienstes bleibt bis zur hierfür vom
Root-Agenten angefragten Benutzerentscheidung ausgesetzt. Der neue
ALPC-/SID-Kandidat wurde deshalb noch nicht nativ ausgeführt.
## Weiterer Quellkandidat: zusätzlich getrennte W32Time-Dienstidentität
Die Kontobindung an LocalService allein trennt W32Time nicht vom Netzwerkagenten,
der ebenfalls SID19 verwendet. Sie darf daher noch keine unabhängige Helper-
Clockqualifikation begründen. Der aktuelle Kandidat verwendet ergänzend die
lokal ermittelte feste `NT SERVICE\W32Time`-SID in einem ausschließlich
clientseitig aufgebauten V5-Serverdescriptor. SID19, PacketPrivacy, Identify und
ALPC bleiben erforderlich; keinerlei schwächerer Fallback. Das ändert keine
OS-DACL, W32Time-Konfiguration oder Kontorichtlinie.
Die Readinessprobe enthält zwei getrennte begrenzte Nur-Lese-Negativkontrollen:
falsches Serverkonto und falsche Dienst-SID bei demselben erwarteten Konto19.
Nur eine erfolgreiche echte W32Time-Abfrage zusammen mit tatsächlichen
Zugriffsverweigerungen beider Kontrollen kann diesen Kandidaten weiter
qualifizieren. Fehlender Endpoint oder Timeout ist kein Identitätsnachweis.
Ein separater einzelner Diagnoseworker begrenzt auch diese Kontrollen; Timeout
vergiftet ihn ohne Ersatz. Beide Kontrollen bleiben immer diagnostisch und
verleihen selbst bei unerwartetem Erfolg keine Uhrbereitschaft.
Microsoft beschreibt das Descriptorfeld als Serveridentifikation, aber nicht
alle Einzelheiten seiner Auswertung. Die Dienstbindung ist deshalb ein zu
prüfender Adapterkandidat, keine aus einem erfolgreichen Konfigurationsaufruf
abgeleitete Sicherheitsgarantie. Vor Öffnen des Gates sind seine tatsächlichen
Positiv-/Negativnachweise und die Isolation vom Netzwerkagenten nachzuweisen.
[V5-SDK-Vertrag](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/ns-rpcdce-rpc_security_qos_v5_w).
Lokal tatsächlich geprüft: C-Kandidat mit Clang/WindowsGNU und `-Werror`
kompiliert, feste56Byte-V5-ABI/SDK-Prefix-/48Byte-Descriptoroffset-Assertions
bestanden, fünf Clock-Vertragtests gegen den tatsächlichen Core unter Linux
bestanden. Ältere MinGW-Header enthalten V5 nicht; die eng benannte lokale
SDK-Struktur bleibt aufx64 begrenzt und wird beim MSVC-Build zusätzlich direkt
gegen die native SDK-Deklaration geprüft. Dies ersetzt weder einen nativen
MSVC- noch einen tatsächlichen W32Time-Nachweis. W32Time ist weiterhin gestoppt;
Produktgate unverändert `ADAPTER_QUALIFIED=false`.