This commit is contained in:
@@ -0,0 +1,108 @@
|
||||
# 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.
|
||||
@@ -0,0 +1,108 @@
|
||||
# Geschützte Linux-Readerregistry: Quellenbaustein
|
||||
|
||||
Stand2026-11-15, Spezifikation1.22. `worker::reader_registry` implementiert nur
|
||||
Registry-/Unit-/Aktivierungspfadprüfung. Kein Bootstrap, Dienstcontrol, SQLopen,
|
||||
Updaterstart, Apply oder Capability folgt daraus. Die vollständige aktuelle
|
||||
Task-/FD-/maps-Census und die tatsächlich gehaltenen ursprünglichen Root- und
|
||||
Agentlocks sind zusätzlich Pflicht. Die lokale Enginequelle verbindet diese
|
||||
Bausteine inzwischen; ohne extern qualifizierte Bootstrapregistry, tatsächliche
|
||||
Dienst-/Hostkontexte und ursprünglichen Admissionanschluss bleiben die
|
||||
Produktcapabilities `not_configured`. Siehe
|
||||
[aktuellen Readercensusnachweis](agent-updater-reader-census-results.md).
|
||||
|
||||
Der Aufruf `QualifiedRegistry::load(&LocalUpdatePolicy)` liest ausschließlich
|
||||
`/etc/rmm-agent-updater/reader-registry.json` unter root-eigener, gegen fremdes
|
||||
Schreiben geschützter Ancestry. Originalrohbytes höchstens64KiB, root0, regulär,
|
||||
ein Link; deren exakter SHA muss `policy.reader_registry_sha256` entsprechen.
|
||||
Damit bindet der vor WebUI-Genehmigung gespeicherte Policyhash die Registry
|
||||
transitiv. Gehaltene Dateien/Parent-FDs, Rawbytes und aktuelle Metadatastempel
|
||||
bleiben erhalten; `verify_protected()` prüft unveränderte originale Namen,
|
||||
Device/Inodes, Konten/Modi/Linkzahlen, Größe, Zeitstempel und Bytes. Kein Caller-
|
||||
Boolean oder aus einem Registryfeld abgeleitetes Alleinvertrauen.
|
||||
|
||||
Schema1 und Profil `linux_shared_readers_v1` besitzen exakt:
|
||||
|
||||
- `bootstrap_receipt_sha256`: exakt der Bootstrap-Qualificationreceipthash aus
|
||||
`policy.initial_baseline.decode().record.activation_evidence`.
|
||||
- `reader_contract_sha256`: Hash der unveränderlichen öffentlichen Bytekonstante
|
||||
`READER_CONTRACT`, über `reader_contract_sha256()` unabhängig berechenbar.
|
||||
- `host_context`: `census::HostContext` mit extern bootstrapqualifizierten
|
||||
Proc-/User-/PID-/Cgroup-Namespace-Device/Inodes; aktuelle eigene gleiche
|
||||
Metadaten allein sind keine Bootstrapqualifikation.
|
||||
- `units`: die unten festgelegten21 Units in dieser Reihenfolge.
|
||||
- `rollback_timers`: höchstens32 weitere historisch bekannte, sortierte eindeutige
|
||||
`rmm-general-startup-rollback-<kanonische-v4-UUID>.timer`-Einträge.
|
||||
|
||||
Jeder Uniteintrag enthält `unit`, `unit_file_state`, `composition`, `triggers`
|
||||
und `triggered_by`. Beziehungen sind sortierte eindeutige bekannte Registrynamen,
|
||||
keine freie Dateiauswahl oder zukünftige Readererlaubnis. `composition` ist exakt
|
||||
wie im unveränderten OSport die geordnete `Vec<(path, FileProof)>`: Fragment
|
||||
zuerst, dann tatsächliche DropInPaths-Reihenfolge. Der Hash derselben JSON-
|
||||
Bytefolge muss bei den Policydiensten passen; FileProof enthält insbesondere
|
||||
Original-Device/Inode, nicht nur ContentSHA. Geschützte systemd-Fragmente und
|
||||
höchstens16 `.conf`-Dropins werden unter den bekannten systemd-Systemverzeichnissen
|
||||
gebunden, insgesamt höchstens128 Blätter. Global-/Prefixdropins sind möglich,
|
||||
aber kein unbekannter Zusatz wird ignoriert. Leere Komposition und leerer
|
||||
UnitFileState sind ausschließlich bei einem absent/not-found-Nichtreader gültig.
|
||||
|
||||
Die21 Einträge sind zunächst diese7 Services: Agentremote, Helpercloud,
|
||||
Fullmaintenance, Updater, APThelper, Legacy`rmm-agent` und
|
||||
Legacy`rmm-helper-dev-test`. Danach folgen für dieselben7 Basen jeweils `.socket`
|
||||
und `.timer`. Vollständige feste Namen stehen in der Quellkonstante `SERVICES`.
|
||||
`rmm-mvp-test.service` ist eine Wartungsfixture, kein registrierter Reader;
|
||||
dieser Baustein fragt sie nicht ab und steuert sie niemals.
|
||||
|
||||
Der feste Readervertrag bindet: Roothelper erwerben das bestehende
|
||||
`executor.lock` vor SQLiteopen und jeder SQL-/Effektoperation; der Agent hält
|
||||
die vorhandene `agent.lock` schon vor Öffnung beider Agentdatenbanken lebenslang;
|
||||
alle erlaubten Reader verstehen Update-/Handoff-/Inflightdecoder. Registry-
|
||||
Parsing beweist diese Code-/Bootstrapeigenschaften nicht selbst. Die tatsächliche
|
||||
separat qualifizierte Baseline, Originalsignaturen und Census/Locks bleiben
|
||||
Pflicht. Eine Registry oder ein flock allein verspricht keine globale Abwesenheit
|
||||
zukünftiger exec-Aufrufe oder willentlicher vertrauenswürdiger Rootneustarts.
|
||||
|
||||
`verify_admission` verlangt genau Agent/General/Full/Updater loaded/active/running
|
||||
mit echten ServiceMainPIDs, ControlPID0, ohne ausstehenden Start-/Controljob.
|
||||
`verify_stopped` verlangt Agent/General/Full inactive/dead mit tatsächlichen
|
||||
Main-/ControlPIDs0; der Updater bleibt aktiv. Der originale UnitFileState bleibt
|
||||
für alle vier exakt gebunden, enabled oder disabled. Ein aktivierter Full- oder
|
||||
Updaterdienst muss deshalb nicht heimlich enabled werden. APT ist optional nur
|
||||
als tatsächlich gebundener Policydienst vorhanden, bleibt geschlossen und
|
||||
gehört niemals ins Startset. Legacyservices und Gegenstücke sind absent oder
|
||||
loaded/inactive/dead/disabled; aktuelle unbekannte Rollbacktimer verweigern.
|
||||
|
||||
Die read-only Systemdaufrufe sind ausschließlich `/usr/bin/systemctl --system
|
||||
--no-ask-password --no-pager --full show --all` mit festen Properties/Namen und
|
||||
zwei begrenzte `list-units`-/`list-unit-files`-Aufrufe mit festem historischem
|
||||
Rollbacktimerpattern. Kein Shellglob, Pager, Authdialog, start/stop/enable oder
|
||||
freie Commandline. Jede eigene Abfrage hat10s und das zusätzliche ursprüngliche
|
||||
`Budget`; stdout/stderr je16KiB. Nur der eigene gehaltene pidfd-Prozess wird bei
|
||||
Abbruch beendet, keine fremde PID übernommen. Statuswerte und fremde Prozess-
|
||||
oder Mappfade werden nicht in Fehlermeldungen ausgegeben.
|
||||
|
||||
Typen werden nicht erfunden: Service besitzt MainPID und ControlPID, Socket
|
||||
nur ControlPID und eine tatsächliche aktuelle Verbindungsanzahl; Timer besitzt
|
||||
keine PID-Eigenschaft. Fehlende anwendbare Properties verweigern. Timer/dead
|
||||
bedeutet im [Systemd-Primärvertrag](https://github.com/systemd/systemd/blob/main/src/core/timer.c)
|
||||
disarmierte Timereventquellen; Socket/dead ist keine Listenactivation. Es wird
|
||||
kein nicht vorhandenes MainPID als gemessene0 ausgegeben.
|
||||
[DBus-Typvertrag](https://www.freedesktop.org/software/systemd/man/latest/org.freedesktop.systemd1.html).
|
||||
Die ausgewählte `Job`-Property muss vorhanden sein; deren leere Ausgabe mit
|
||||
`--all` ist Systemctls Darstellung des tatsächlichen Nulljobs.
|
||||
[Primärformatter](https://github.com/systemd/systemd/blob/main/src/systemctl/systemctl-show.c).
|
||||
|
||||
`Triggers`/`TriggeredBy` sind strukturelle Beziehungen und werden exakt gegen
|
||||
die Registry gebunden. Ihre Namen allein werden nicht als laufendes Ereignis
|
||||
missverstanden. Alle relevanten registrierten Aktivierungsquellen müssen
|
||||
unabhängig geschlossen sein; offene oder unbekannte Pfade verweigern. Allgemeine
|
||||
WantedBy-Systemtargets werden damit nicht pauschal zu zu stoppenden Readern.
|
||||
Alle Statusfelder werden vor und nach der Prüfung identisch erneut gelesen,
|
||||
Registry/Unitblätter sowie aktueller Hostkontext erneut geprüft. Das ist eine
|
||||
begrenzte Momentaufnahme unter den weiteren Originalgrenzen, kein Futureexec-
|
||||
oder lückenloser Kernel-Snapshotbeweis.
|
||||
|
||||
Dieser Worker hat keine Target-/SSH-/Job-/Scope-/Dienst-/Policyaktion oder
|
||||
Systemdprobe ausgeführt. Compiler-/Format-/Clippyprüfung und unabhängiger
|
||||
Quellenreview werden durch den koordinierenden Owner nach diesem Quellenhandoff
|
||||
ausgeführt und separat berichtet. Die kleine Parserprobe verwendet ausschließlich
|
||||
synthetische Statusbytes, keine tatsächliche Registry oder laufende Units.
|
||||
@@ -135,9 +135,28 @@ unveröffentlicht; kein Cloud-VM-Apply, kein Produktfertig- oder Produktionsnach
|
||||
|
||||
Nach dem gepushten gemeinsamen Checkpoint8e93c9e und dem erhaltenden Mainmerge
|
||||
07d6118 ist die bisher offene Enginefolge als konkrete Workerquelle verbunden.
|
||||
Ihr Eintritt bleibt explizit `UPDATE_READER_CENSUS_NOT_CONFIGURED`; weder
|
||||
Daemonentrypoint noch Job-/Applycapability wird aktiviert. Die genaue
|
||||
Dieser historische Stand sperrte den Eintritt explizit mit
|
||||
`UPDATE_READER_CENSUS_NOT_CONFIGURED`. Die folgende lokale Fortschreibung hat
|
||||
Registry und Readercensus im Quellpfad verbunden; weiterhin wird weder ein
|
||||
Daemonentrypoint noch eine Job-/Applycapability aktiviert. Die genaue
|
||||
Queue-/Reply-/Stop-/Lock-/Swap-/Start-/Healthfolge und vorhandene separate
|
||||
Agent-Singletonsperre stehen in [worker](agent-updater-worker.md). Der neu
|
||||
geprüfte öffentliche Recordbuilder löst die zuvor dort genannte fehlende
|
||||
positive authentisierte Eingangsprobe. Keine reale Applyabnahme folgt daraus.
|
||||
|
||||
|
||||
## Fortschreibung2026-11-15: Readerregistry und vollständige Task-FD-Prüfung
|
||||
|
||||
Der gemeinsame Quellsatz verbindet Registryprüfung, ursprüngliche Agent- und
|
||||
Root-Executorsperre sowie TGID-/TID-FD-/maps-Prüfung mit der bestehenden Engine.
|
||||
Vor SQLiteöffnung verlangt der Ledgerport den nicht frei konstruierbaren
|
||||
`ClosedReaders`-Beleg und den tatsächlich gehaltenen ursprünglichen Rootguard.
|
||||
Das ist ein lokaler Quellen-/Vertragspunkt, kein gestarteter Dispatcher und
|
||||
keine Zusage über zukünftige privilegierte Fremdprozesse.
|
||||
|
||||
Der eingefrorene71-Input-Quellsatz besteht lokal alle10 vorhandenen Workerguards,
|
||||
locked all-targets Check, Release-Link, Clippy mit `-D warnings` und Formatcheck.
|
||||
Ein eigener Runner ist ausschließlich für zwei eigene native Prozessfixtures
|
||||
vorbereitet; er ist noch nicht ausgeführt. Details, frühere fehlgeschlagene
|
||||
Fixtureprüfung und verbleibende MVP-Gates stehen im
|
||||
[Readercensusnachweis](agent-updater-reader-census-results.md).
|
||||
|
||||
@@ -186,14 +186,18 @@ DBclose/Rootlockreturn gehalten und wird vor der festen Startfolge zurückgegebe
|
||||
Der Agent hält schon heute seine ursprüngliche Singletondatei vor beiden
|
||||
Agent-SQLiteöffnungen; keine ACL, Agentdatei oder Sperrrolle wurde geändert.
|
||||
|
||||
**Explizite Sperre dieses Checkpoints:** `Runtime::serve_one` verweigert mit
|
||||
`UPDATE_READER_CENSUS_NOT_CONFIGURED`. Geschützte kompatible Bootstrapregistry
|
||||
plus vollständige aktuelle PID-/FD-/maps-Census und Nachstopbeobachtung unter
|
||||
beiden tatsächlichen Sperren fehlen noch. Eine bekannte Unitliste ersetzt
|
||||
keinen Census. Keine CLI oder RMM-Admission ruft diese Runtime auf; Applycaps
|
||||
bleiben geschlossen. Ebenso offen: Staging-/Downloadproducer, passiver gültiger
|
||||
Der ursprüngliche Quellencheckpoint verweigerte den Eintritt explizit mit
|
||||
`UPDATE_READER_CENSUS_NOT_CONFIGURED`. Die Fortschreibung verbindet jetzt die
|
||||
Registry sowie tatsächliche Task-/FD-/maps-Census vor den Stops und unter beiden
|
||||
gehaltenen ursprünglichen Sperren danach. Diese Quellintegration ist lokal
|
||||
geprüft, jedoch noch nicht als installierter Dienst-/Hostkontext qualifiziert.
|
||||
Eine bekannte Unitliste allein ersetzt keinen Census. Keine CLI oder
|
||||
RMM-Admission ruft diese Runtime auf; Applycaps bleiben geschlossen. Offen sind
|
||||
insbesondere extern qualifizierte kompatible Bootstrapregistry und Hostkontexte,
|
||||
ursprüngliche Full-Admission, Staging-/Downloadproducer, passiver gültiger
|
||||
Updatezustand, V2-Rollbackvertrag vor dem ersten Bootstrap, Unsicherheits-
|
||||
Namespaces, qualifizierte Dienstkontexte und tatsächlicher Linux-Apply.
|
||||
Namespaces und tatsächlicher Linux-Apply. Aktueller Nachweis und enger geplanter
|
||||
nativer Zweierlauf: [Readercensus](agent-updater-reader-census-results.md).
|
||||
|
||||
Lokaler Nachweis liegt unter
|
||||
`devstate/updater-engine-source-6a8bb902-4db4-4d93-8843-450ba1dd5622/`.
|
||||
|
||||
Reference in New Issue
Block a user