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

94 lines
5.6 KiB
Markdown

# 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. Anschließend im gemeinsamen Featurebuild `80655271…` mit
Agent/Helper und23+7 nativ bestandenen Units gebunden. **Keine Dienstwartung
oder binäre Erhaltungsabnahme durch den Witness allein.**
## Tatsächlicher nativer Nur-Lese-Lauf
Fall `f4879e01-7eb6-40ab-ac4c-7a9a50ea358b`, EXE-SHA256
`d0b2d033e99ec4819f5de562fc2ad06b844a63b230271df578d5e9ce4c565e5c`:
Bootstrap-Administratorprozess auf der tatsächlichen Windows-VM, Exit0,
kein Timeout,3006Zeichen JSON, keine Fehlerausgabe. Separater Readback der
dauerhaften nativen Receipt stimmte exakt überein. Keine erneute Programmausführung.
Die Integritätsprüfung und Bindung des tatsächlichen nativen SQLite-VFS-
Dateihandles an die gehaltene Helperdatei bestanden. Vorhanden sind genau die
drei Basistabellen: `consumed`0, `execution_evidence`0 und `windows_helper_files`1;
deren typisierte Zeilenhashes sind privat erhalten. Alle vier Helper-Synctabellen
fehlen ausdrücklich; kein Ready-/Syncbeleg wird daraus abgeleitet. Die vorbereitete
Intentablage ist vorhanden und besitzt weiterhin exakt die beiden0B-Leaves.
Keine Schlüssel-/privaten Zeileninhalte ausgegeben, keine Clock-, Dienst-,
Policy-, Datenbank- oder Jobänderung. Zentrale Zähler und geschlossene Flags
vorher/nachher identisch: Windows0/0/0/0, Linux30/30/26/0. Geschützte
Rohbelege und `acceptance.json` liegen unter
`devstate/windows-client/system-state-native/f4879e01-7eb6-40ab-ac4c-7a9a50ea358b/`.
Dies ist kein LocalService-/SYSTEM-Pipe-, Intent-PERSIST- oder RMM-Jobnachweis.
## Fester Beobachtungsumfang
`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](https://www.sqlite.org/c3ref/c_fcntl_begin_atomic_write.html).
Der Handle bleibt Eigentum von SQLite. Der Schutzdescriptor wird nur mit
[GetSecurityInfo](https://learn.microsoft.com/en-us/windows/win32/api/aclapi/nf-aclapi-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.