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

7.2 KiB

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.

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, Legacyrmm-agent und Legacyrmm-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 disarmierte Timereventquellen; Socket/dead ist keine Listenactivation. Es wird kein nicht vorhandenes MainPID als gemessene0 ausgegeben. DBus-Typvertrag. Die ausgewählte Job-Property muss vorhanden sein; deren leere Ausgabe mit --all ist Systemctls Darstellung des tatsächlichen Nulljobs. Primärformatter.

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.