Files
rust-discovery/docs/agent-updater-reader-census-results.md
2026-11-15 11:40:53 +01:00

109 lines
6.1 KiB
Markdown

# Linux-Readercensus: lokaler Quellenstand und geplanter nativer Nachweis
Stand2026-11-15, Spezifikation1.22. Keine Zielinstallation, Dienständerung,
RMM-Ausführung oder Applyabnahme wurde in diesem Arbeitsschritt vorgenommen.
Die WebUI-Genehmigungsgrenze bleibt unverändert.
Registry und Census sind mit der vorhandenen Worker-Enginequelle verbunden.
Die Registry bindet Originalrohbytes, Bootstrapreceipt, Readervertrag,
Hostnamespaces und exakte Unit-/Dropinkomposition. Aktuelle TGIDs und sämtliche
Task-FD-Tabellen werden begrenzt und erneut auf Identität geprüft; auch eine
Datei mit geschlossenem FD bleibt über ihren mmap-Inode ein Reader. Unbekannte,
unlesbare, wechselnde oder unvollständige Beobachtungen verweigern. Fremde
Cmdlines, Umgebungen und map-Pfade werden nicht ausgegeben.
Der vorhandene Root-Executorflock und die ursprüngliche Agent-Singletonsperre
bleiben beide unter dem nicht frei konstruierbaren `ClosedReaders`-Beleg gehalten,
bevor der Updater SQLite öffnet. Der Readervertrag fordert außerdem den
Roothelperflock vor seinen SQLiteöffnungen und jeder SQL-/Effektoperation und
die Agent-Sperre lebenslang vor beiden Agentdatenbanken. Dies ist kein globales
Versprechen über zukünftige privilegierte Fremdprozesse.
## Tatsächlich lokal geprüft
Im isolierten Offline-Rustcontainer, Quellmount read-only, unveränderte
Docker-Seccomp-Policy, eigene tmpfs für `/run`, `/tmp` und `/var/lib`:
- Locked all-targets Check, Release-Link, Clippy `-D warnings`, Formatcheck: PASS.
- Vollständige Release-Workerliste10, tatsächlich10bestanden,0Fehler,
0ignoriert,0gefiltert.
- Die Prozessfixtures belegen bestehende FDs, anschließend mmap nach FDclose
sowie einen Reader in einer privaten FD-Tabelle eines einzelnen Threads.
Der TGID-only-Gegenfall findet diesen Threadreader ausdrücklich nicht;
die vollständige Taskprüfung findet ihn.
Der erste Lauf unter `reader-census-ba31b221-79c4-4702-b6d6-09bb94bba7fc`
bestand9/10. Der eigene Threadfixture wurde am Docker-Seccomp-Verbot für
`unshare(CLONE_FILES)` mit EPERM abgewiesen. Ausschließlich im Testfixture wurde
stattdessen `close_range(UINT_MAX,UINT_MAX,CLOSE_RANGE_UNSHARE)` verwendet:
die gleiche eigene FD-Tabellenseparation, ohne eine tatsächlich mögliche
FDnummer zu schließen. Keine Sandboxregel, Capability oder Produktionsprüfung
wurde gelockert. Die Produktionsbytes vor `#[cfg(test)]` blieben identisch.
Die Semantik folgt [close_range(2)](https://man7.org/linux/man-pages/man2/close_range.2.html).
Der ursprüngliche Fehlerbeleg bleibt erhalten.
Finaler eingefrorener Privatfall:
`devstate/agent-updater-worker/reader-census-final-da31051b-269f-4fb5-947d-94c8ad162c2a/`.
Er enthält71Originalinputs mit Vor-/Nachhashprüfung, alle Logs und das tatsächlich
lokal ausgeführte Release-Test-ELF. Receipt SHA256
`9020992e888d0b22e71db88cab78f255e273be2a4a7856d43616b387c36c74ae`,
Inputs SHA256 `382714b09349e448441345abbac6d99c0d523e98bdabaa78290b400768bac8f7`,
ELF7.888.096Bytes/SHA256
`e83fd334b005d81ac917389de2a1c7486bea3f62ae45d77bccbd331e131e4304`.
## Geplant, nicht ausgeführt: zwei Cloud-Linux-Prozessguards
`deploy/updater_reader_census_linux_acceptance.py` ist lokal vorbereitet im
Originalfall `168a4171-dbe3-46ef-8978-850797d0625c`. Vor Zielausführung muss Root
seinen unabhängigen Runnerreview abschließen. Keine Zugangsdaten wurden für
Prepare gelesen, kein Zielaufruf vorgenommen.
Der Runner prüft zuerst die vollständige Liste aller10Tests des exakt gebundenen
ELF. Anschließend läuft ausschließlich der feste Filter `census_process::tests::`:
- `actual_proc_probe_detects_existing_descriptors_and_mapped_inode_without_exporting_paths`
- `private_thread_fd_table_cannot_hide_a_reader_from_the_group_probe`
Erforderlich sind2bestanden und8gefiltert. Die anderen acht Tests dürfen auf der
VM nicht laufen: Einige lokale Fixtures verwenden feste Produktzustandspfade.
Die zwei ausgewählten Tests verwenden nur eigene Create-once-UUIDdateien unter
`/run`, eigene FDs, eigenen mmap und einen eigenen Fixturethread. Keine SQLopen,
Jobs oder Dienststeuerung. Der Runner läuft als Root mit NoNewPrivileges und
führt nach einmaligem Eintritt keine Wiederholung aus. Nach verlorener Antwort
ist ausschließlich Read des Originalfalls zulässig.
Vorher/Nachher werden Boot, Ubuntu24.04/x86-64, drei bekannte Dienstgenerationen
mit Konten/Images, geschlossener APT-Helfer, vier geschützte Control-Dateien,
drei DB-Identitäten sowie ursprünglicher Root- und Agentlock verglichen.
Control-Bytes sind gehasht; bei den laufenden DBs werden Identitäten geprüft,
keine Bytegleichheit oder vollständige SQL-Historie behauptet. Der begrenzte
Prozessnachweis ersetzt weder einen kompletten Hostcensus noch native
Full-/Updaterdienstkontexte oder einen Updatejob.
## Weiterhin offen
Extern qualifizierte kompatible Bootstrapregistry und geschützter Hostkontext,
native Dienst-/Namespace-/Capabilitykontexte, ursprüngliche Full-Admission und
Runtimeentrypoint, Staging-/Downloadproducer, gültige passive Updatebeobachtung,
Unknown-only-Recordnamespace-Adjudikation, ein vor dem ersten Apply lesbarer
V2-Rollbackvertrag sowie tatsächlicher WebUI-genehmigter Linux-Apply mit
Health-/Erhaltungsnachweis. V1-Restore bleibt deny. Kein erfolgreicher nativer
Apply und keine fertige Updaterbereitschaft folgen aus diesen lokalen Guards.
## Tatsächlich auf Cloud-Linux ausgeführt
Originalfall `168a4171-dbe3-46ef-8978-850797d0625c`: vor Ausführung volle
10er-Liste verglichen, danach genau beide Prozesscensus-Guards tatsächlich
als UID0 bestanden;2PASS/0failed/ignored,8andere ausdrücklich gefiltert.
Execute-Receipt
`d6bdda0bddac74f9364fa6ec3287ed0cfa9964ae02a98cc174e95929dc94f9d5`.
Separater Originalrückabruf bestätigte das Ergebnis und erhaltene aktuelle
Runtime-/Control-/State-/Lockidentitäten, Receipt
`8cbe7f4d79c238e3ad73a9c7152dcb415decbeeb1a8a1691fcc43ae4ee6c6a47`.
Die eigenen kurzlebigen Prozess-/Thread-/FD-/mmap-Fixtures wurden geprüft;
keine RMM-Dienste gesteuert, keine Projekt-SQLite geöffnet oder Agentdatei
ersetzt. Dieser Nachweis qualifiziert weder den vollständigen Host-/
Dienstcensus noch Admission, Apply, Record-Unknown-Adjudikation oder Rollback.
Die zuvor genannten offenen Gates bleiben offen.