Files
rust-discovery/docs/windows-passive-time-closeout.md
T
kevin_janssen 44f65c205b
Rust development slice / linux (push) Failing after 7s
Prepare read-only passive Windows time closeout collector
2026-11-15 15:51:25 +01:00

5.3 KiB

Lesender Abschluss zweier passiver Windows-Zeitbeobachtungen

Der Collector deploy/windows/passive_time_closeout.py ist lokal vorbereitet und ausführbar. Noch kein Zielaufruf oder nativer Abschlussnachweis. 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

Fünf 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. PowerShell-/C#-Nativeparse und echte Rollenbelege bleiben offen; lokale Pythonprüfungen ersetzen sie nicht.

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.