70 lines
4.2 KiB
Markdown
70 lines
4.2 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. **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](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.
|