Add gated agent update planning, preserved handoff and Linux worker ports
Rust development slice / linux (push) Failing after 6s
Rust development slice / linux (push) Failing after 6s
This commit is contained in:
@@ -0,0 +1,219 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user