Files
rust-discovery/docs/windows-passive-time-closeout.md

11 KiB

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:

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:

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.

Konsolenlesung des nachfolgenden Dienstpaars

deploy/windows/Read-JobPairTimeSamples.ps1 bindet den ursprünglichen Leser mit SHA-256 d9e2b9344c19af1296b86ec70ba754ef820f369ac5ec897979bd4233e0722d04 an den Paarfall 49c230d8-fb5d-4c64-96b6-e0edce03ed90. Vor dem Aufruf muss die tatsächliche Verbindungsgeneration auf dem Projektserver gelesen werden. Der Wrapper prüft die aktuelle Profilquittung und die Prozessgeburt beider Dienste, die Rechte und Dateikennungen anhand der Leserausgabe, den CIM-Bootbezug, die zwei unterschiedlichen Rollen und die Frische der ungeschmälerten Originalreports. Bei fehlenden oder alten Beispielen liest er bis zu zwei Minuten erneut. Für einen bereits laufenden Leseprozess gilt ein maximales Einzelbudget von 30 Sekunden.

Geplanter Aufruf als Administrator auf dem Gast: Read-JobPairTimeSamples.ps1 -Generation <aktuelle Servergeneration>. Der unveränderte Read-PassiveTimeSamples.ps1 muss daneben liegen. Die lokale Quittung entsteht je Aufruf einmalig als samples-passive-<Sitzungs-ID>.json im Paarfall. Sie enthält die Originalreports in Base64, ihre SHA-256, Sicherheits-/Dateimetadaten und Prozesszeugen. Die Konsolenausgabe nennt den SHA-256 der Quittung. Für die vollständige Abnahme muss der Betreiber danach die identische Servergeneration und denselben Windows-Boot sowie die Zeit des Reads unabhängig anhand der Serveruhr bestätigen. Der Wrapper meldet seinen lokalen Befund, ohne eine serverseitige Prüfung zu behaupten.

-AfterRestart verlangt die Geburt eines später gestarteten Agentprozesses und aktuelle Belege für genau diese Instanz. Der Build fcec400 publiziert die Dateien jeweils beim ersten erfolgreichen Vergleich einer passiven Verbindung. Nach Umschaltung auf Jobbetrieb müssen Job-Sync und Startgrant die aktuelle Freigabe belegen. Dateien aus einem früheren Prozess können diesen Nachweis nicht erbringen.

Lokal bestanden die Parserprüfung, je ein unverändertes Fixture für Agent und Helper sowie neun Ablehnungsfälle für doppelte Felder, falschen Typ, PID, Boot, Rolle, Generation, Schema und Zeitgrenzen. Die Boot-ID stimmte mit dem vorhandenen Python-Prüfer überein. Zeitvergleiche unterschieden eine Nanosekunde auch bei der neunstelligen Rust-Ausgabe. Die lokale Prüfung enthielt keine Ausführung des Lesers auf dem Windowsgast.