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

109 lines
7.2 KiB
Markdown

# 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.