109 lines
7.2 KiB
Markdown
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.
|