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

93 lines
5.3 KiB
Markdown

# 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:**
```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
```
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.