# Agent-Selbstupdate: Serverkatalog, Transport und feste WebUI-Pläne 2026-11-14, isolierter Quellenstand im Updaterbranch. Server und WebUI sind implementiert und lokal geprüft; **kein Deployment, kein nativer Applylauf und noch kein aktiver Autoupdater**. Der beauftragte Schnitt verwendet ein eigenes signiertes Agent-/Helper-Codepaar, keine APT-/MSI-Fixture und kein Wartungsskript. Domain, lokale Helper-/Handoffruntime und signierter Inflightabgleich werden getrennt integriert. Die Produktentscheidung und Zielabnahme bleiben beim Hauptagenten; diese Seite ersetzt weder dessen Review noch die Linux-first-Gates. ## Planung und unveränderte Genehmigungsgrenze HTTP und MCP benutzen dieselbe neue `plan_request`-Auflösung. Für `action="update_agent"` sind ausschließlich folgende Aktionsparameter erlaubt: ```json { "release_id": "11111111-1111-4111-8111-111111111111", "execution_identity": "root", "timeout_seconds": 600, "max_output_bytes": 65536 } ``` Dies ist ein synthetisches Schemafragment, kein ausführbarer Auftrag. Feste Asset-IDs, Fristen, Rolloutlimits und Grund stehen wie bisher daneben. Keine freien URLs, Dateipfade, Artefaktlisten, Vorgänger, Updater- oder Peerpins vom Aufrufer. Auch der alte typisierte `PlanInput` erlaubt keine alternative Einreichung eines selbst zusammengestellten `ResolvedAgentUpdate`. Der Server löst den festen Releasekatalog und je Ziel die letzte gespeicherte `agent_update`-Beobachtung auf. Neben dem bestehenden Baseinventar akzeptiert er gezielt den eigenen passiven Scope/Source `agent.update` mit Schema1 und exakt `{"agent_update": AgentUpdateObservation}` als Daten. Der normale authentisierte Ingest verlangt die angebotene Capability `agent.update/1`; Tenant, Agent, Boot und Generationen stammen weiterhin ausschließlich aus dem geprüften Envelope. Die eigene 60s-Quelle behauptet kein neues Windows-Baseinventar und löst keine angeforderte Liveerhebung aus. Verlangt werden gültige Quelle/Qualität, höchstens fünf Minuten alte Erhebung/Empfang/Updatebeobachtung, frischer Kontakt, gleicher aktueller Boot, unveränderte Identitätsgenerationen, bestätigter Agent-/Helpersync und keine Restore-/Sequence-/Recoverysperre. Die bezeichnete ursprüngliche signierte Syncentscheidung muss im erhaltenen Servercheckpoint existieren, bei der Beobachtung gültig gewesen sein und zu Boot, Verbindungsgeneration, Gerät und beiden aktuellen Journalidentitäten passen. Ein neuerer normaler Sync macht die historische Entscheidung nicht nachträglich zu einer neuen Lease. Genau die passende passive Kandidatenpreview bindet Zielrelease und typisierten Peerpinübergang. Der Release liegt über dem beobachteten Aktivierungsfloor. Fehlende, alte oder widersprüchliche Beobachtung ergibt keine Planung und wird nicht durch eine Liveabfrage oder angenommene Baseline ergänzt. Geräte-mTLS liefert Herkunft, keine unabhängige Hardware-/OS-Attestierung; der privilegierte Updater muss sämtliche lokalen Bindungen vor Wirkung erneut selbst prüfen. Der gespeicherte Plan enthält sämtliche festen Updatejobs mit exakten Release-/Envelopehashes, Vorgänger-/InstalledRecordhash, Agent-/Helperdateien, Updater-/Policy-/Keyringbindung, Konfigurations-/Peerpinübergang und einmaligem zulässigem Vorgängercode-Rollback. Je Versuch werden exakt die zwei signierten Artefaktreferenzen abgeleitet. Fehlende, zusätzliche, doppelte oder fremde Referenzen verweigern Revalidation, Zustellung, Grant und Download. Die Updaterbindung enthält zusätzlich den festen separaten Health-Publickey `health_public_key_hex` und dessen `health_key_pin_sha256`. Beide stehen in den kanonischen Planbytes direkt nach dem Keyringhash, werden vollständig angezeigt und von der eigenen deny-only-Policy exakt verglichen. Das ersetzt weder den Jobsignierschlüssel noch erlaubt es einen Fallback auf ihn. Der signierte Executionpermit bezeichnet ausschließlich bei Updatejobs zusätzlich die ursprüngliche Plan-ID; ältere Aktionen behalten ihre ursprünglichen Grantbytes. Ersteller und Freigeber benötigen aktuell `updates:apply` sowie getrennt `root:execute` oder `system:execute`. Das erteilt keine Genehmigung. `operations.submit` bleibt der unveränderte persistente Antrag `pending_approval`, vor der interaktiven WebUI-Genehmigung ohne Jobs/Outbox/ JobOffer/Grant. Die vorhandene Autorisierungs- und Auditschicht wird nicht ersetzt; kein neuer Approve-API-/MCP-/DB-Pfad. Aktualisierte Rechte, Capabilities, Scope, Releasevertrauen und gespeicherte Vorgänger werden weiter geprüft. ## Getrenntes Vertrauen und deny-only-Policy `RMM_AGENT_UPDATE_KEYRING_FILE` verweist auf eine separat provisionierte, geschützte Datei mit dem gemeinsamen `UpdateKeyringFile`-Schema1: Generation und höchstens16 Publickeys, jeweils Plattform, Sequenzbereich und Widerrufsflag. Der Server prüft Eigentümer wie beim vorhandenen Jobsignierschlüssel, 0600, reguläre einzelne Datei ohne Symlink sowie nicht fremdschreibbaren Elternpfad; begrenzt eingelesene Originalbytes und gehaltene Dateimetadaten werden verglichen. Der vollständige Rawhash/Generation muss zur festen Updaterbindung passen. Keine Schlüssel aus einem Job, Download oder Katalogeintrag werden vertraut. Verifikation benutzt den unveränderten bereits nativ qualifizierten reinen `rmm-updater`-Verifier: feste Ed25519-Domäne, kanonische Manifestbytes, Signatur, Plattform, Gültigkeit und kompatibles Protokoll/Zustandsschema. Die serverseitige Kandidatenprüfung ersetzt den lokalen Aktivierungsfloor nicht. Die eigene Datei `RMM_AGENT_UPDATE_POLICY_FILE` ist im ersten Entwicklungsprofil ein ausdrückliches Schema1-Opt-in mit Ablauf und höchstens64 festen Scopes. Jeder Scope bindet Tenant/Asset/Agent/Generationen, aktuelle Principals, qualifizierte Helperpolicy/-binary, Updaterbinary/-policy, Keyringgeneration/-hash, separaten Health-Publickey/-Pin, erlaubte konkrete Manifest-/Vorgängerrecordhashes und Abnahmenachweis-ID. Fehlend, falsch, abgelaufen oder Produktion ohne passenden Adapter bleibt deny. Bestehende General-, Fullskript-, SCM-, MSI- und APT-Policies erteilen dadurch keine Updateerlaubnis. Kein Codepfad provisioniert diese Dateien oder Mitgliedschaften. Zusätzlich sind die abgestimmten tatsächlichen Capabilities erforderlich: `update_agent`, `agent.update.apply/1`, `rmm.sync.v1`, unabhängiger Root-/SYSTEM- Helper, `root:update_agent` beziehungsweise `system:update_agent` und konkrete Helper-/Updatercode-/Updaterpolicyhashes. Quelle oder Build allein öffnet sie nicht. ## Eigene große Artefakte und passive Metadaten Migration0015 legt nur die getrennten Tabellen `agent_update_artifacts` und `agent_update_releases` an. Beide haben erzwungene Tenant-RLS, zusammengesetzte Tenant-/Artefakt-/Hash-/Längen-Fremdschlüssel und unveränderliche Inhalte. Die Anwendungsrolle besitzt nur SELECT/INSERT, keine Tabellen und kein RLS-Bypass. Alte APT-/MSI-Artefakttabelle, Route, SQLgrenze und Store bleiben bei256KiB. | Pfad | Vertrag | | --- | --- | | `POST /api/v1/tenants/{tenant}/agent-update-artifacts?artifact_id=…&sha256=…&size_bytes=…` | Interaktive Katalogverwaltung mit CSRF und `catalog:write`; binärer Stream mit exakter Content-Length, höchstens256MiB und180s; kein Job | | `POST /api/v1/tenants/{tenant}/agent-releases` | Strikter signierter Envelope; Veröffentlichung erst nach vollständiger Prüfung beider bereits importierter Dateien; kein Job | | `GET /api/v1/tenants/{tenant}/agent-releases` / MCP `updates.list_releases` | Gespeicherte feste Metadaten, berechtigt und paginiert; abgelaufene Metadaten bleiben lesbar und gesondert gekennzeichnet | | `GET /agent/v1/releases/current?platform=…` | Geräte-mTLS und passende Plattform; tatsächlich beobachtetes höchstes Katalogrelease oder `not_configured`; kein Nachweis weltweiter Aktualität und kein Apply | | `GET /agent/v1/update-artifacts/{artifact}?job_id=…&attempt_id=…&offset=…&length=…` | Geräte-mTLS, genehmigter fester Job/Versuch, aktuelle Rechte/Policy/Identität und exakte Manifestreferenz; höchstens512KiB je Antwort | Upload liest kein vollständiges Binary in einen Vec: feste32KiB-Schreibstücke, bounded Hash/Längenzählung, create-only privates Staging, Flush vor unveränderlicher Publikation. Frühes EOF, Zusatzbytes und Hashabweichung verweigern Veröffentlichung. Die feste180s-Frist wird ausdrücklich vor und nach jedem Streampoll, nach der Frameverarbeitung sowie vor Veröffentlichung geprüft. Damit können auch sofort verfügbare oder leere Frames den Ablauf nicht umgehen; das eigene unveröffentlichte Staging wird beim Abbruch über den vorhandenen Drop entfernt. Während des Streams wird keine SQLtransaktion gehalten; vor Veröffentlichung werden interaktive Berechtigung und CSRF erneut geprüft. Unterbrochene eigene Stagingdateien werden entfernt; Prozess-/Hostcrash kann verwaiste eigene Stagingdateien hinterlassen, ohne daraus ein veröffentlichtes Objekt zu machen. Download benutzt ein gehaltenes reguläres No-follow-Handle und prüft vollständige Länge/Hash mit32KiB-Puffer, dann den begrenzten Bereich und Dateimetadaten. Das lädt kein vollständiges großes Objekt in RAM; der erste einfache Adapter hashprüft das Objekt allerdings pro Chunk erneut. Der Client muss weiterhin vor Staging/Verwendung unabhängig vollständige Länge, EOF und Releasehash prüfen, ohne Redirect oder beliebigen Downloadhost. Produktionsobjektspeicher und weitergehende Durchsatzoptimierung sind kein behaupteter Nachweis dieses Adapters. ## WebUI und tatsächliche lokale Prüfungen Die WebUI bietet eine feste Release-ID und zeigt gespeicherte Releases sowie alle Update-/Rollbackbindungen vor Genehmigung. Sie prüft ursprüngliche Planhashbytes, rekonstruiert den gesamten kanonischen Updateplan und Jobhash, dekodiert den kanonischen Envelope und prüft Manifest-/Envelopehashes und genau zwei Artefakte je Versuch. Byte-/Ansichtsänderung sperrt die Freigabe. Signaturprüfung gegen provisionierte Schlüssel bleibt Server/Helperaufgabe; die Anzeige eines Key-ID-Feldes behauptet keine eigene UI-Vertrauenskette. Ein getrenntes Katalogformular nimmt den signierten Envelope und genau zwei Dateiauswahlen entgegen. Der Browser übergibt die Filebodies direkt, ohne im Anwendungscode ein vollständiges Binary-ArrayBuffer anzulegen. Der Server prüft die vollständigen Hashes und Längen. Erst zwei bestätigte Importbelege führen zur getrennten Veröffentlichung der signierten Metadaten. Fehlgeschlagene Schritte erzeugen keine automatischen Retries oder Installationsjobs; tatsächliche Teilimportbelege bleiben im Fehlerzustand sichtbar. Sitzungs-/CSRFdaten bleiben im normalen Browserkontext, kein Tokenexport für einen separaten Approver. Tatsächlich lokal ausgeführt, kein RMM-Server oder -Agent auf dem Notebook: - Server `cargo check --locked --offline -p rmm-server` bestanden. - Server `cargo test --locked --offline -p rmm-server --bin rmm-server`: **43bestanden,0fehlgeschlagen,5bestehende DB-Fälle ausdrücklich ignoriert**. Einschließlich vollständigem echten Rustcodec-Plan, exakter per-Versuch- Artefaktmenge, verweigerten freien lokalen Pins und großem Store mit Trunkierungs-/Korruptions-/Fremdtenant-/Legacygrößengrenzen. - Server Clippy für alle Targets mit `-D warnings` und gezielte Formatierung bestanden. Unveränderter Verifier und alte nativen Runner nicht umgeschrieben. - Web Typecheck, Vitebuild und **54/54Tests** bestanden, davon fünf neue gezielte Updateprüfungen mit tatsächlichen Rustcodec-Fixtures. Diese enthalten ausdrücklich synthetische Signaturen und dürfen niemals publiziert/ausgeführt oder als Kryptografie-/Releasequalifikation ausgegeben werden. Der zusätzliche Filetransportfall verweigert falsche Länge und widersprüchliche Importbelege und prüft direkte Filebodyübergabe an die feste gleiche Origin; dies ist noch kein Browser-/Netzwerk- oder nativer großer Streamnachweis. - Frischer isolierter PostgreSQL17.6 ohne Netzwerk/Ports: Migrationen1–15 als Nicht-Superuser-Migrator ausgeführt; Tenant-RLS, fehlender und nach Commit zurückgesetzter Kontext, Cross-Tenant-FKs, App-UPDATE-/DELETEverweigerung, unveränderliche Inhalte auch gegenüber dem Migrator und null neue Jobs, Outbox, Grants/Autorisierungen bestanden. Eigener Testcontainer entfernt. Fall `postgres-19cdb94c…`, ResultatSHA256 `bbb649a184e59a645f638d39f2e3182df6aef39353bff0bf43712f03297c99ce`. Dieser SQLnachweis ersetzt die fünf ausgelassenen anderen DB-Fälle nicht. Anfänglicher Web-Typecheck erreichte wegen fehlendem `tsc` noch keine Prüfung; nach `npm ci --offline --ignore-scripts` liefen die genannten Prüfungen wirklich. Ein zwischenzeitlicher `--locked`-Lauf verweigerte vor Compile die noch nicht abgestimmte Workspace-Lockfortschreibung; erst der koordinierte Lockstand wurde geprüft. Keine Paketversion wurde für diese Ergänzung gezielt hochgezogen. Der unabhängige Review des Server-/WebUI-Abschnitts fand keine kritischen Blocker an Binding, Autorisierung, Genehmigungsgrenze, RLS oder Store. Die dabei benannten engen Ergänzungen betreffen die ausdrückliche Uploadfrist und die eigene passive Updaterquelle; Gesamtintegration und Zielabnahme bleiben davon getrennt. Nach diesen beiden Änderungen wurden Servercheck und Clippy für alle Servertargets mit unverändertem Lock/offline und `-D warnings` erneut tatsächlich bestanden; `git diff --check` war sauber. Für diese erste Ergänzung blieb die WebUI unverändert und wurde nicht erneut gebaut oder getestet. Ein180s-Netzwerklauf wurde für diese kleine Quellenergänzung nicht ausgeführt; die vier ausdrücklichen Deadlineprüfungen sind Quellencodebefund, kein behaupteter nativer Last-/Zeitnachweis. Beim folgenden separaten Healthkey-Vertragsnachtrag wurden die drei Codec-Fixtures erneut direkt aus dem erweiterten Rustbeispiel erzeugt. Die WebUI bekam dafür die strikte kanonische Feldfolge und verlangt beide Healthbindungen. Tatsächlich erneut bestanden: Web-Typecheck, Vitebuild, die fünf relevanten Update-Webtests einschließlich Anzeige beider Healthfelder sowie Server-Clippy aller Targets mit `-D warnings`, unverändertem Lock und offline und die beiden gezielten `agent_updates::tests` mit den neu erzeugten Rustcodecbytes. Die übrigen49Webtests wurden nach diesem begrenzten Nachtrag nicht erneut ausgeführt; der frühere54/54-Lauf bleibt als früherer Nachweis ausgewiesen. Keine native Health-/Applyprüfung daraus abgeleitet. **Noch offen:** Vollständiger aktueller Linuxruntime-/Handoff-/Health-/Rollbackanschluss, echte signierte Releaseveröffentlichung, qualifizierter Updaterbootstrap und Linux-first-VM-/WebUI-Applyabnahme; danach Windows. Produktionsadapter, Dauerbetrieb und Kapazität sind nicht abgenommen. Alle Zielaktionen und Genehmigungen bleiben ausschließlich beim Hauptagenten.