220 lines
14 KiB
Markdown
220 lines
14 KiB
Markdown
# 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.
|