Files
rust-discovery/docs/agent-updater-server-console.md
T
2026-11-14 21:48:21 +01:00

220 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.