Files
rust-discovery/docs/windows-passive-time-closeout.md
T
2026-11-15 20:42:12 +01:00

152 lines
9.1 KiB
Markdown

# Lesender Abschluss zweier passiver Windows-Zeitbeobachtungen
Der Collector `deploy/windows/passive_time_closeout.py` ist lokal vorbereitet
und ausführbar. Der native Abschluss über den auf dem Server laufenden Empfänger ist unten dokumentiert. Die
V2-Profileinrichtung und ihr ausdrücklich gemeldetes Zeitfenster stehen vor
dem Aufruf. Tunnel-/Zugangserneuerung, Profileinrichtung und Dienstwartung sind
keine Aktionen dieses Collectors.
Der unabhängige Quellreview von `cc821246ccd98ee6d3dc5c1b12c7303d3010e8a7`
fand im engen Veröffentlichungsdelta keine konkrete Regression. Der Agent hält
pro Verbindung den ersten Vergleich je Rolle erst nach erfolgreichem eigenen
`complete` bzw. authentifiziertem Helper-`TimeCompleted` fest. Nur der aktuelle
Verbindungsowner schreibt beim Heartbeat. Ein verworfener Worker erhält keinen
Publikationspfad. Die JSONs sind historische Beobachtungen, keine aktuellen
Clockleases, Jobfreigaben oder unabhängig erneut verifizierbare Signaturpakete.
Auf der Windows-VM liest der Collector ausschließlich die Inhalte von
`C:\ProgramData\RustDiscovery\state\agent-time-sample.json` und
`helper-time-sample.json`, jeweils höchstens8192Bytes, durch gehaltene Handles.
Singlelink, Nicht-Reparse, Dateigröße, native FileID/LastWrite und die
SYSTEM-/Administratoren-/Agent-Service-SID-DACL werden geprüft. Die
Verzeichnis-DACL und Dateisicherheit müssen während des Reads gleich bleiben.
Reparse-Vorfahren werden verweigert. Keine privaten Schlüssel-, Journal- oder
Konfigurationsinhalte werden gelesen. Kurze gehaltene Lesehandles können einen
gleichzeitigen atomaren Reporttausch vorübergehend verweigern; der bestehende
Publisher behält den Sample für einen späteren Heartbeat.
Vor und nach diesem Read werden ausschließlich öffentliche CIM-/SCM- und
native Prozessmetadaten geprüft: beide festen Dienste Running, richtige
Konten/Startarten/Kommandos, Agent-/Helper-PID und Geburt, tatsächlicher
Prozessimagepfad und erwartete öffentliche Binaryhashes. Der Boot wird aus
demselben festen CIM-LastBootUpTime-Vertrag wie im Agenten abgeleitet. Es wird
kein Agent-, Helper-, SQLite-/Statusprobeprogramm oder IPC aufgerufen. Die
vorhandenen streng gepinnten Bootstraptransporte werden nur lesend verwendet;
C#-Interop enthält lediglich Query-APIs.
Der bestehende `time_route_context` liest davor und danach ausschließlich den
öffentlichen registrierten Gerätekontext in einer Read-only-SQL-Transaktion
und die feste Gateway-/Serverbootbindung. Die beiden Serverzeugen müssen
identisch sein. Die Capabilitymenge muss exakt passiv bleiben. Beide Reports
brauchen dieselbe positive aktuelle Serververbindungsgeneration und denselben
aktuellen Windows-Boot; ihre Agent-PIDs müssen dem aktuellen Agentprozess
entsprechen. Rollen, Feldschema und Datentypen sind exakt; doppelte JSONkeys
werden bereits beim Rohparse verweigert. Verifier-UUID, Request- und
Response-SHA256 müssen zwischen den Rollen verschieden sein.
Die Beobachtung muss nach der von Root belegten V2-Einrichtung und nach der
aktuellen Agentgeburt liegen. Beobachtungs- und Dateialter sind höchstens180s;
Publikationsverzug höchstens90s bei2s Zukunftstoleranz. Der aktuelle Windows-
UTC-Read muss höchstens10s vom lokalen Operatorzeitpunkt abweichen. Dies sind
Akzeptanzgrenzen für historische Daten, keine behauptete native Zeitgenauigkeit.
Fehlende/stale Belege und ein Generationenwechsel erlauben nur neue Readversuche.
Das Wartefenster beträgt180s; ein bereits begonnener vollständiger Readsatz
hat zusätzlich höchstens105s Transportbudget. Ein Timeout erzeugt einen
unvollständigen eigenen Beleg, niemals eine erfolgreiche Abnahme.
Lokale private Fälle entstehen unter `devstate/windows-passive-time-closeout/`.
Rohantworten stehen vor ihrer Validierung auf dem lokalen Datenträger;
Acceptancereceipts binden die aktuellen Native-/Serverzeugen per SHA256. Die
Befehlsparameter für den späteren Aufruf sind die tatsächlich installierten,
qualifizierten Agent-/Helperhashes und Roots UTC-Untergrenze nach der
V2-Einrichtung. Keine frei wählbaren Guestpfade, Aktionen oder Abfrageprogramme.
**Geplant, nicht ausgeführt:**
```text
python3 deploy/windows/passive_time_closeout.py collect \
--agent-sha256 <tatsächlich-installierter-qualifizierter-SHA256> \
--helper-sha256 <tatsächlich-installierter-qualifizierter-SHA256> \
--profile-after <Roots-tatsächliche-V2-Einrichtung-UTC-mit-Z>
```
Tatsächlich lokal ausgeführt und bestanden:
```text
python3 -m py_compile deploy/windows/passive_time_closeout.py
python3 deploy/windows/passive_time_closeout.py guards
python3 -m unittest discover -s deploy/windows -p test_passive_time_closeout.py
```
Sechs lokale Fixtures prüfen aktuelle unabhängige Rollen, falsche PID/Boot/
Generation/Rolle/Beobachtungsfrist, gleiche Verifier-/Request-/Responsewerte,
doppelte JSONfelder, fehlende Sicherheitsprüfung und fehlenden Helperbeleg.
Der zusätzliche Grenzfall prüft die tatsächlichen sieben .NET- und neun
Chrono-Nachkommastellen. Python3.10s ursprüngliches `fromisoformat` verweigert
diese Formen; dieser konkrete lokale Fehler wurde vor jedem Zielaufruf
behoben. UTC- und FILETIME-Grenzen werden jetzt vollständig mit Ganzzahl-
Nanosekunden verglichen. Ein Sample genau an der Installationsuntergrenze wird
akzeptiert, eine um1ns spätere Untergrenze verweigert dasselbe Sample. Keine
Native- oder Testzeit wird hierfür erfunden.
Danach lokal mit vorhandenem `/tmp/rmm-powershell-parser/pwsh` tatsächlich
ausgeführt: vollständiger Reader-AST ohne Parserfehler und Kompilierung der
C#-Querydefinitionen ohne Methodenaufruf bestanden. `Info` besitzt die
erwartete52-Byte-Interopgröße. Lokale Quittung unter
`devstate/windows-passive-time-closeout-local/receipt.json`; kein nativer
Win32-Aufruf oder VM-Zugriff. Windows-PowerShell5.1-/tatsächliche Win32-Reads
und echte Rollenbelege bleiben offen; lokale Prüfungen ersetzen sie nicht.
Der konkrete Profileinsatz wurde zusätzlich unabhängig rein im Quellcode
geprüft (`time_profile_config.py`, SHA256
`36f0451a146ca8dc73d4c66b48f2e65fbaefde5c7643133993d1c136cc3318de`).
Kein konkreter Befund im geprüften Schnitt: getrennte öffentliche Source-/
Plattform-/Key-/Bindingketten, exakte neue Rollen mit PID/Geburt/Token-/Service-
SID/Image/FileID, SameLive-/Kernel-CAS vor und nach Veröffentlichung,
Intent-vor-ACL/Move, überschreibungsfreier gleichvolumiger Move und ausschließlich
ThisFolderOnly-Leserechte für die zwei Rollen. Die UTC-Untergrenze wird vor
dem ersten privaten Fallintent aufgezeichnet. Noch ungesetzte Paarbeleg-
Konstanten blockieren die Vorbereitung. Der konkrete spätere Rollen-/
Readbackbinding-Delta und die tatsächliche Veröffentlichung bleiben separat
nachzuweisen. Dieser Review ist keine Profileinrichtung oder native Abnahme.
Im laufenden Wartungsfenster folgte ein enger unabhängiger Quellreview des
konkreten SCM-ETS-Fixes (Clockoperator-SHA256
`90c2708c17903e4bc630f6655dba38ff6448251941abd53f5874e991042b0f2c`).
Die tatsächlich gelesenen Int32-SID-Typen trugen PowerShell-ETS-Metadaten und
wurden vom bisherigen `PSCustomObject`-Zweig als Objekt behandelt. Der Fix
behandelt die primitiven CLR-BaseObjects zuerst und rekonstruiert reine
JSONskalare. Stringcase und vollständige Integerwerte bleiben erhalten;
NaN/Infinity werden verweigert. Arrayreihenfolge, Null, Keykollisions-/Tiefe-
und Wirkungs-CAS bleiben unverändert. Keine weiteren konkreten Findings im
geprüften Schnitt. Derselbe vollständige Comparator wurde im Profiloperator
SHA256 `8588241eac3036e665b6010e4bf9fac1547be88d68f95b4c02cb24e425267c68`
per reinem AST-Literalvergleich bytegleich bestätigt. Das ist ausschließlich
Source-Review, kein Zielaufruf oder Beleg einer ausgeführten Wartung.
Falls Reports fehlen, können die bereits vorhandenen passiven Dateien
`helper-probe.json` und `pipe-last-error.json` getrennt nur lesend bei der
Pipeeingrenzung helfen. Sie enthalten keinen vollständigen Timeworkerfehler;
auch Metadaten vorhandener fester `.agent-time.pending`/`.helper-time.pending`
können eine unterbrochene Publikation erklären. Dieser Collector liest oder
ändert diese zusätzlichen Dateien nicht und löst keine Diagnose aus.
### Nativer Abschluss am 15. November 2026
Der Empfänger auf dem permanenten Server prüfte um **20:41:27 Uhr MEZ**
beide nach der Veröffentlichung des Profils entstandenen Belege. Der Agent
beobachtete seinen Vergleich um `19:40:52.455414900Z`, der SYSTEM-Helper
seinen um `19:40:52.524631100Z`. Beide gehörten zu Verbindungsgeneration 145
und demselben Windows-Boot. Verifier-UUIDs und die Hashes der beiden
Anfragen und Antworten unterschieden sich. Der Agent hatte PID 4420, der
Helper PID 10264. Die Serverzeugen vor und nach der Lesung stimmten überein.
Fall `c23245b7-017e-4643-9872-849f262faf21`, Lesung 36. Der SHA-256 des
empfangenen Datensatzes lautet
`40d45a9cb3145f8b1159b7c5da0509dd043355aca23d4bec860f37205e3a8551`,
der des Abschlussbelegs
`f1a79eed223487fa61890ccb274986660b33f2596ae33e1689e9b2afdc7b8884`.
Beim separaten Rücklesen stimmten die zwei ursprünglichen Rollenberichte
mit den validierten Einträgen überein. Der Server führte weiterhin nur
`windows.base/1`, `heartbeat/1` und `agent.update/1`. Für einen späteren
Auftrag muss die Uhr beim Prüfen des Grants erneut die Frischegrenzen erfüllen.