126 lines
7.3 KiB
Markdown
126 lines
7.3 KiB
Markdown
# 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:
|
|
|
|
```text
|
|
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.
|