Files
rust-discovery/docs/agent-updater-passive-catalog.md
T
2026-11-15 14:11:06 +01:00

7.3 KiB

Normaler passiver Releasekatalogcheck

Stand2026-11-15. Der Linux-Agent ruft den vorhandenen Releasekatalog jetzt aus seinem normalen queue_update_observation-Pfad auf. Dies ist ein passiver Metadatencheck, kein Artefaktbezug, Staging, Job oder ausgeführtes Selbstupdate.

Aufruf, Vertrauen und Grenzen

Der Collector startet höchstens einen Hintergrundrequest. Erfolgreiche Checks werden nach24h erneuert; fehlende Konfiguration oder Fehler frühestens nach60s. 35s Gesamtfrist und64KiB Antwortlimit gelten zusätzlich zu den vorhandenen mTLS-/HTTPgrenzen. Heartbeats, Cancel und SignedSync warten nicht auf HTTP. Die URL bleibt /agent/v1/releases/current am bereits konfigurierten TLSnamen; der vorhandene Connectoverride ändert ausschließlich das TCPziel. Keine Weiterleitung, Umgebungsproxy-, System-CA- oder Jobsigner-Ersatzannahme.

Verwendet werden ausschließlich die bereits vorgesehenen geschützten öffentlichen Dateien /etc/rmm-agent-updater/policy.json, keyring.json und /var/lib/rmm-agent-updater/installed-record.json. Eigentümer/Eltern sindRoot, keine Symlinks oder gruppen-/weltbeschreibbaren Pfade; reguläre Dateien, ein Hardlink, feste Größenlimits. Gehaltene FD-/Inode-/Metadaten-/Rawbytezeugen werden nach dem Request erneut geprüft. Es entstehen keine lokalen Dateien, keine Schlüsselprovisionierung und keine geänderten Dateirechte.

Policyidentität muss zum vorhandenen Gerätebinding passen. Separater Releasekeyring, aktuelle Widerrufe/Sequenzbereiche, echte Baseline- und Releasesignaturen, Linuxplattform, qualifizierter Protokoll-/Statevertrag, Updaterversion, Fristen und unveränderter Floor werden unabhängig geprüft. Serverzeit und die zusätzliche unsignierte Manifestansicht ersetzen keine lokale TrustedClock oder signierten Originalbytes; beide Manifestansichten müssen übereinstimmen. Fehlende Anker ergeben not_configured, Transport-/TLS-/ Prüfprobleme unavailable; gültige Metadaten ergeben available oder current.

Dieser enge Erstanschluss akzeptiert als Flooranker ausschließlich die exakten separat signierten Bootstrap-InstalledRecordbytes. Ein späterer Updated-Record benötigt die noch fehlende unabhängig authentisierte read-only Fullhelper- Historybeobachtung; bloßes Parsen der neueren Recorddatei erzeugt keine Vertrauens- oder Floorfreigabe. Eine tatsächliche geschützte Konfiguration muss für den unprivilegierten Agent lesbar provisioniert sein. Unlesbare Dateien bleiben ehrlich unavailable; dieser Code lockert keine ACL.

Übertragung und Darstellung mit älteren Servern

Der unveränderte agent.update-Snapshot erhält kein zusätzliches Top-Level- Feld. Seine qualifizierte Vorgänger-/Fullpreview bleibt not_configured; Katalogmetadaten sind keine CandidatePreview und eröffnen keine Check-/Applycap.

Der gespeicherte Katalogbericht wird ausschließlich beim ohnehin geplanten normalen Linuxinventar als begrenzte bestehende Unterbeobachtung linux.agent_update.catalog übertragen. Kein zusätzlicher Basiscollect wird angefordert. Dieser linux.base-/observations-Vertrag wird bereits von älteren Servern angenommen; kein neues Protobuftag und keine neue Servercap sind nötig. Die äußere Beobachtungszeit bezeichnet das Lesen des Caches. Das innere checked_at bleibt die tatsächliche ursprüngliche Checkzeit und wird beim Übertragen nicht erneuert. Über72h alte Cachewerte werden nicht neu angehängt.

Der aktuelle Domain-Ingest validiert zusätzlich den bekannten Berichtstyp, Qualität, Zeit, Kandidatenform und geschlossene Feldmenge. Altclients ohne diese Beobachtung bleiben gültig. Die bestehende tenantgebundene Inventoryspeicherung und Geräte-API transportieren dieselben geprüften Daten. Die WebUI zeigt Status, echten Checkzeitpunkt, spätere Cachelesezeit und gegebenenfalls Version/Hash als Text. Sie erzeugt keine Requests oder Bedienung zur Ausführung aus dem Bericht. Gemeinsame synthetische Codecfixture: tests/agent_update/catalog-check-inventory.json.

Tatsächliche lokale Prüfungen

Im vorhandenen isolierten Rust1.99.1-Buildcontainer, Netzwerk aus:

cargo test --release --locked --offline -p rmm-agent -p rmm-domain --all-targets
cargo clippy --locked --offline -p rmm-agent -p rmm-domain --all-targets -- -D warnings
cargo fmt -p rmm-agent -p rmm-domain --check

Abschließend89Tests bestanden,0Fehler/ignorierte/gefilterte im gesamten Lauf (Agentbinary32, weitere Agentintegration34, Domain23). Clippy und Formatcheck bestanden. Web55/55 und Typecheck bestanden. Die sechs gezielten neuen Fälle enthalten echte synthetische Ed25519-Baseline-/Releasebytes und einen tatsächlich laufenden lokalen mTLS-Testserver mit eigener CA/Geräteidentität: fester Pfad, Clientzertifikat, Antwort-/Redirect-/Größenverweigerung, Floor/Protokoll/Schema/ Ablauf/Keywiderruf, fehlender Anker, falsche Baseline und unzulässige Recordbytes. Der Wirefall durchläuft echte Protobufbytes bis zum tatsächlichen validate_for_scope; UI und Rust benutzen dieselbe statische Datenfixture.

Zusätzlich wurde exakt der positive Kompatibilitätsfall mit dem ursprünglich unveränderten Ingestvalidator aus c1d8eea als privatem Datei-Mount ausgeführt: 1/1 bestanden. Nach diesem Altvalidatorlauf schlug ein nachfolgender Negativfall zunächst fehl. Nach gezieltem Bereinigen der beiden betroffenen Pakete im eigenen Buildcache und vollständigem Neubuild bestand der gesamte89er-Lauf. Die Altvalidator-, erste Fehler- und abschließenden Logs bleiben getrennt erhalten; der fehlgeschlagene Lauf ist kein Erfolgsbeleg. Ein erster unbenutzter Import wurde ohne Warnungsunterdrückung korrigiert.

Der öffentliche Datei-Guardtest benötigt keinRoot: Unprivilegiert beweist er die Verweigerung des eigenen unprivilegierten/beschreibbaren Pfads. Nur der gesonderte lokale Rootlauf prüft zusätzlich ein eigenes geschütztes positives Dateifixture. Keine ungekennzeichnete Rootpflicht im neuen Test. Lokale Belege: devstate/updater-passive-catalog-d86dc473-3e5f-48d4-a196-3a0d618a8e4e/.

Tatsächliche Cloud-Linux-Qualifikation

Root führte auf der festgelegten Cloud-Linux-Test-VM am2026-11-15 um13:07:09UTC exakt die sechs agent_update_catalog::-Fälle alsUID65534 aufx86-64 aus: 6bestanden,0Fehler,0ignorierte,26übrige Tests bewusst gefiltert, Exit0, 0stderr-Bytes. Der unprivilegierte Datei-Verweigerungszweig ist hierbei geprüft; der privilegierte positive Dateizweig stammt ausschließlich aus dem lokalen Rootlauf. mTLS verwendet auch auf der VM nur den eigenen Loopback-Testserver. Dies ist kein Katalogabruf durch den installierten Produktagenten gegen den Internetserver, keine Clock-/Fullhelper-/Applyqualifikation und kein Windowsbeleg.

Exakte Testbinary-SHA256: e8fc4249db06510b6b680f5ddf7e1d539305c54741d1dea2fdc348883f205956. Erhaltener privater nativer Beleg: devstate/updater-passive-catalog-linux/4f3e5a4b-98a9-4acf-9106-dcdd4d5d1823/result.json, SHA256 332c8903506bf17fa8c9a9a0f512bb64ad82867513d2885359a54a80e4750e6d.

Nächster tatsächlicher Lieferweg

Noch offen sind der qualifizierte read-only Fullobserver für aktuelle Vorgänger-/Pin-/Historypreview, die normale unverbrauchte Fulladmission, Agent-/Helper-Artefaktstaging vor Handoff, stabiler Updaterbootstrap und der vollständige dauerhafte Rückweg. Agent supported/accept und Fullpolicy geben weiterhin keinen Updatejob frei. Es wurde kein Agent installiert, Dienst geändert, Code getauscht, Job angelegt oder genehmigt. Notebook nur Entwicklung.