Files
rust-discovery/docs/windows-system-state-witness.md
T
2026-11-14 07:43:36 +01:00

4.2 KiB

Fester Nur-Lese-Zeuge für Windows-Helperwartung

Stand2026-11-14: examples/system_state.rs ist implementiert. Windows-GNU- Example-Clippy mit -D warnings, Release-Link und AMD64-PE-Prüfung bestanden im Defaultprofil. Keine native Ausführung, Dienstwartung oder Erhaltungsabnahme durch diesen Quellenstand. Die gemeinsame Artefaktqualifikation des späteren Wartungsrunners bleibt separat.

SystemStateProbe.exe hat keine Argumente und benötigt einen tatsächlich aktivierten Administratorgruppen-Token ohne Threadimpersonation. Der Bootstrap- Runner bindet den tatsächlichen Aufrufkontext. Es ist kein LocalService-/SYSTEM- Pipebeweis, keine RMM-Capability und kein Genehmigungsweg.

Der feste Beobachtungsumfang ist C:\ProgramData\RustDiscoverySystem:

  • state\ledger.sqlite: ausschließlich lesende SQLite-Transaktion, Integrität, bekannte Schema-/Indexdefinitionen sowie Zeilenzahl und deterministischer typisierter Hash je erlaubter Tabelle. Pflicht sind consumed, execution_evidence und windows_helper_files. Die vier helper_sync_*-Tabellen dürfen gemeinsam fehlen; absent_tables meldet das ausdrücklich. Teilweise oder unbekannte Schemas werden verweigert.
  • state\executor.lock, helper.json, agent-pin.json: ausschließlich Dateimetadaten, Owner-/DACL-Prüfung und ACLhash. Keine Pin-/Request-/Schlüssel- oder privaten Zeileninhalte in der Ausgabe.
  • Optional agent-intents: entweder vollständig abwesend oder exakt der vorprovisionierte Ordner mit zwei regulären, leeren festen Leaves. Nur Metadaten; keine SQLiteöffnung oder Initialisierung dieser Dateien. Ein bereits initialisierter Intentstore gehört nicht zu diesem Wartungsprofil.

Gehaltene Handles, Wiederöffnung des festen Pfads und die tatsächliche native SQLite-VFS-Dateikennung müssen übereinstimmen. Volume-ID und FILETIME erscheinen als Dezimalstrings, damit PowerShell alle64Bit erhält. Der Witness akzeptiert die vom bestehenden Helper erstellten geerbten Datei-ACEs nur unter dem gehaltenen geschützten State-Verzeichnis, bei weiterhin exakt geprüften effektiven Writerrollen und SYSTEM-/Admin-Owner. Andere Schutzdeskriptoren werden nicht passend geändert; Root-, State- und Intentverzeichnisse bleiben geschützt. Die Datenbankverbindung bleibt read-only; es gibt weder Migration noch Schreib-PRAGMA, WAL-Override, immutable oder nolock. Bestehende Journal-/WAL-/SHM-Sidecars und ein abweichender Rollbackheader werden vor der SQLiteöffnung verweigert. Kein Journal wird repariert, gelöscht oder zurückgesetzt.

Die separate tatsächliche Nur-Lese-Erhebung acl-readonly-d4795190… bestätigte den geschützten State-Ordner mit Administratorowner und die beiden vom Helper erzeugten SYSTEM-eigenen, ungeschützten Dateien mit genau drei geerbten Full- Control-ACEs für SYSTEM, Administratoren und Helper-Service-SID. Keine Reparse- Points, keine Datei-/ACLänderung oder privaten Dateiinhalte gelesen. Die private Metadatenreceipt hat SHA256 12e2ca43…; dies ist keine native Ausführung des neuen vollständigen Witnessprogramms.

Der Reader begrenzt Dateigröße auf1GiB, Schemaobjekte auf32, Zeilen pro Tabelle auf10000, einzelne Werte auf1MiB, gehashte Text-/Blobwerte insgesamt auf32MiB und die JSON-Ausgabe auf32768Byte. Synchrone Dateisystem-/Securityabfragen besitzen dadurch keine harte Zeitgrenze; der separate Bootstrapcontroller muss seinen eigenen Witnessprozess begrenzen. Fehler geben ausschließlich SYSTEM_STATE_WITNESS_REFUSED aus. Kein Bytehash einer laufenden Datenbank; einen solchen darf der Wartungsrunner erst nach bestätigtem Ende beider alten Dienstprozesse separat erheben.

Die native Handleabfrage verwendet die dokumentierte reine SQLite-WIN32_GET_HANDLE-Operation. Der Handle bleibt Eigentum von SQLite. Der Schutzdescriptor wird nur mit GetSecurityInfo gelesen; keine Privilegien oder DACLs werden verändert.

Der bestehende RuntimeStateProbe.exe für das Agenttelemetriejournal bleibt unverändert und wird vom Wartungsrunner gesondert verwendet. Das Notebook bleibt Entwicklungsrechner; kein Agent, Server, VM-Neustart oder Job wurde für diesen Quellen-/Crossbuildnachweis gestartet.