feat: add pure signed agent release verifier without apply authority
Rust development slice / linux (push) Failing after 7s
Rust development slice / linux (push) Failing after 7s
This commit is contained in:
@@ -0,0 +1,442 @@
|
||||
# Agent-Selbstupdate: kleinster zusätzlicher Schnitt
|
||||
|
||||
Stand 2026-11-14, **Integrationsvorschlag mit implementiertem reinem Prüfkern**,
|
||||
keine neue Produktnorm und kein Installations-/VM-Nachweis. Basis:
|
||||
Spezifikation1.19, Kapitel0,4,13,16,19,22,25.
|
||||
Der User möchte den Agent-Autoupdater jetzt parallel zur Skriptkonsole. Damit
|
||||
wird ausschließlich dieser Teil aus M7 vorgezogen; Restore, HA, Relay und Lasttest
|
||||
werden dadurch keine zusätzlichen MVP-Aufgaben. APT-/MSI-Fixturerezepte verwalten
|
||||
andere Software und implementieren **keinen Agent-Selbstupdater**.
|
||||
|
||||
## Verhalten und Genehmigung
|
||||
|
||||
Der installierte Agent prüft regelmäßig, ob ein passendes, freigegebenes Release
|
||||
vorliegt. Der erste Vorschlag ist ein täglicher passiver Metadatencheck mit
|
||||
Jitter, zusätzlich beim Prozessstart, über den bereits konfigurierten Server.
|
||||
Dies sammelt ausschließlich feste Release-Metadaten und startet keinen Job,
|
||||
Installer, Download beliebiger URLs oder Codewechsel. Fehlende Konfiguration
|
||||
meldet `not_configured`, abgelaufene Metadaten `unknown` samt Zeitpunkt/Fehler.
|
||||
|
||||
Ein Update erhält eine eigene typisierte Aktion `update_agent`. UI/MCP dürfen
|
||||
einen festen Plan vorbereiten und als `pending_approval` beantragen. Der Plan
|
||||
bindet pro Gerät Release-Manifesthash, Artefakte, exakten Vorgänger, Plattform,
|
||||
Versuch, Frist, Parallelitätsgrenze und erlaubte einmalige Wiederherstellung.
|
||||
WebUI-Genehmigung, aktuelle Startprüfung und dauerhafter Einmalverbrauch bleiben
|
||||
erforderlich. Ein Mensch kann einen festen Rollout gemeinsam genehmigen;
|
||||
`latest`, zukünftige Versionen, Wildcardziele und periodische Selbstfreigabe
|
||||
sind keine zulässigen ausführbaren Parameter. `updates:apply` wird zusätzlich
|
||||
zu den jeweiligen Root-/SYSTEM-Rechten geprüft; eine Policy begrenzt nur.
|
||||
|
||||
Der UI-Text muss Agent-/Helper-Dienstunterbrechung und mögliche Management-
|
||||
Unterbrechung anzeigen. Dieser Schnitt fordert keinen Hostreboot an und darf
|
||||
keinen Installer wählen, der ungeplant neu startet. Notwendiger Hostreboot
|
||||
verlangt einen eigenen festen genehmigten Job. Automatischer Versionscheck,
|
||||
freigegebener Rollout und bestätigter Updateerfolg bleiben getrennte Zustände.
|
||||
|
||||
## Festes Releaseformat1
|
||||
|
||||
Ein Release besteht zunächst aus genau zwei Rohdateien: Agent und privilegierter
|
||||
Helper. Kein Archiv, Postinstall-Skript, freier Pfad oder beliebiges Kommando.
|
||||
Linux verwendet `x86_64-unknown-linux-gnu`, Windows
|
||||
`x86_64-pc-windows-msvc`. Die Plattformkennung ist eine geschlossene Auswahl.
|
||||
Ein neuer Updater selbst ist **nicht** Teil dieses ersten Selbstupdatepfads.
|
||||
APT-/MSI-Pakete können später denselben signierten Vertrag umschließen; der
|
||||
erste Rohbinaryschnitt darf nicht als APT-/MSI-Upgrade beworben werden.
|
||||
|
||||
Das Envelope enthält `schema_version=1`, `key_id`, `payload_bytes` und
|
||||
`signature` (feste Ed25519-Signatur,64Bytes). Für JSON-Transport werden
|
||||
`payload_bytes` und `signature` als kanonisches Base64url ohne Padding übertragen,
|
||||
keine unbeschränkten Zahlenarrays. Der erste Bibliothekskern nimmt bereits
|
||||
dekodierte begrenzte Bytes entgegen; die spätere Transportintegration muss das
|
||||
Envelope vor Decodierung begrenzen. Der Payload ist streng typisiertes
|
||||
JSON mit festen Feld-/Listenreihenfolgen, ohne unbekannte Felder, doppelte Keys,
|
||||
Floats oder alternative Encodingform. Nach Parsen muss exakt dieselbe kanonische
|
||||
Serialisierung entstehen. Signaturbytes sind die Domäne
|
||||
`rmm.agent-release.v1\0` gefolgt von den unveränderten Payloadbytes. Der
|
||||
Manifesthash ist SHA256 derselben Payloadbytes. Verifikation begrenzt das
|
||||
Payload vor Parsen auf16KiB und verwendet `verify_strict` aus dem schon gepinnten
|
||||
`ed25519-dalek=2.2.0`; keine Algorithmusverhandlung.
|
||||
|
||||
| Payloadfeld | Festgelegte Bedeutung |
|
||||
|---|---|
|
||||
| `schema_version` | Genau1 |
|
||||
| `release_id` | UUID; unveränderlicher veröffentlichter Datensatz |
|
||||
| `release_sequence` | Positive monotone Veröffentlichungsnummer je Plattform; Versionsvergleich nutzt diese Nummer |
|
||||
| `version` | Sichtbare nichtleere ASCII-Versionskennung; kein lexikografischer Semververgleich |
|
||||
| `platform` | Eine der beiden festen x64-Plattformkennungen |
|
||||
| `published_at`, `expires_at` | UTC-Epochsekunden, gültig nur mit vertrauenswürdigem Clockkontext |
|
||||
| `protocol_major` | Exakte unterstützte Hauptversion; die erste Stufe erlaubt nur dieselbe aktuelle Version |
|
||||
| `state_schema` | Exakte kompatible Zustandsversion; erste Stufe erlaubt **keine** Zustandsmigration |
|
||||
| `minimum_updater_version` | Positive numerische Implementierungsversion des unabhängigen Updaters |
|
||||
| `artifacts` | Genau Agent, danach Helper; je `role`, unveränderliche `artifact_id`, SHA256 und Länge |
|
||||
|
||||
Artefakthashes sind64kleine Hexzeichen; Längen positiv und höchstens256MiB pro
|
||||
Datei. Artefakt-UUIDs dürfen nicht doppelt sein. Rollen sind `agent` und `helper`,
|
||||
keine eigenen Dateinamen aus dem Netzwerk. Die Veröffentlichung ist erst
|
||||
verfügbar, wenn beide vollständigen Dateien existieren und deren Hash/Länge
|
||||
mit dem signierten Manifest übereinstimmen. Serverkatalog und Tenantberechtigung
|
||||
bestimmen Sichtbarkeit; das Manifest selbst verleiht keinerlei Ausführungsrecht.
|
||||
|
||||
## Vertrauen, Ablauf und Versionsschutz
|
||||
|
||||
Update-, Job-/Grant- und Geräte-/TLS-Schlüssel sind getrennt. Lokaler Bootstrap
|
||||
provisioniert einen root-/SYSTEM-geschützten Update-Keyring mit SHA256-Key-ID,
|
||||
rohem32Byte-Publickey, Plattformbindung und zulässigem Sequenzbereich. Kein
|
||||
Schlüssel aus einem Job, Manifest oder Download wird automatisch vertrauenswürdig.
|
||||
Veraltete/gesperrte Keys verweigern auch eine ansonsten passende Signatur.
|
||||
|
||||
Erste kleine Stufe unterstützt Rotation/Widerruf durch kontrollierte, separat
|
||||
provisionierte Keyringgeneration; neue Generation muss größer sein, alte
|
||||
Schlüssel werden nicht implizit übernommen. Dynamisches Online-Rootrotation-
|
||||
Protokoll ist noch offen und wird nicht als TUF-Implementierung ausgegeben.
|
||||
Dies hat eine konkrete Grenze: Ein lange isolierter Client kennt einen späteren
|
||||
Widerruf erst bei frischer authentisierter Trustprovisionierung. Daher beginnt
|
||||
ohne frischen Kontakt und aktuellen Trustkontext kein Apply.
|
||||
|
||||
Lokal gibt es getrennt (a) die aktuell aktive Manifest-ID/Sequenz, (b) die höchste
|
||||
erfolgreich aktivierte Sequenz als Antirollbackgrenze, (c) den höchsten gesehenen
|
||||
Katalogstand für Replaydiagnose und (d) einen offenen Übergabeintent. Bloßes
|
||||
Ansehen eines neuen Releases autorisiert keine Wirkung. Ein älteres Release
|
||||
unter der bestätigten Antirollbackgrenze ist niemals ein neues Updateziel.
|
||||
Gleiche Sequenz mit anderen Manifestbytes ist ein Konflikt; dieselben Bytes sind
|
||||
ein Metadatenduplikat, keine neue Wirkung. Versionslabels allein reichen nicht.
|
||||
|
||||
`verify_release` prüft ausschließlich **zukünftige Updatekandidaten**. Nach
|
||||
einem Code-Rollback (`active=3`, bestätigter Floor=5) verweigert diese Funktion
|
||||
auch das aktive Manifest3 als erneutes Updateziel. Das bedeutet keine Korruption
|
||||
oder Ungesundheit der aktuell laufenden Version. Passive Anzeige und Health
|
||||
verwenden den gesonderten geschützten `InstalledReleaseRecord` mit explizitem
|
||||
Rollbackstatus; sie dürfen diese Kandidatenprüfung nicht als Current-Healthcheck
|
||||
verwenden. `SameActiveManifest` ist nur oberhalb/auf dem unveränderten Floor
|
||||
erreichbar und bleibt ausschließlich ein Metadatenvergleich.
|
||||
|
||||
Die einzige Rückkehr zu einer niedrigeren aktiven Sequenz ist die im selben
|
||||
genehmigten Versuch vorab gebundene letzte bekannte Codeversion, deren Dateien
|
||||
noch unverändert lokal vorhanden sind. Die Antirollbackgrenze wird dabei nicht
|
||||
gesenkt. Widerrufene/ausdrücklich verbotene Vorgänger werden auch als Rollback
|
||||
verweigert. Ein späteres Downgrade verlangt einen getrennten Recoveryvertrag.
|
||||
|
||||
## Servertransport und UI/MCP-Vertrag
|
||||
|
||||
Vorgeschlagener zusätzlicher lesender Endpunkt:
|
||||
`GET /agent/v1/releases/current?platform=<feste-plattform>`, über vorhandenes
|
||||
Geräte-mTLS, ohne Redirects, höchstens32KiB Envelope, Serverzeit und Katalog-
|
||||
beobachtungszeit getrennt. Antwort enthält einen signierten festen Manifestenvelope
|
||||
oder explizites `not_configured`/keine angebotene Version. Kein neuer öffentlicher
|
||||
Login oder allgemein adressierbarer Installerdownload. Ein veraltetes aber noch
|
||||
gültiges Manifest ist durch reine TLS-/Hashprüfung allein nicht als aktuellste
|
||||
Version beweisbar; der Check meldet nur die tatsächlich beobachtete Version.
|
||||
|
||||
Der vorhandene geräte-/Job-/Versuch-gebundene
|
||||
`/agent/v1/artifacts/{artifact_id}`-Pfad kann derzeit nur Artefakte bis256KiB
|
||||
beziehen: `LocalArtifacts::put/get` **und** das SQL-`CHECK` in
|
||||
`migrations/0006_catalog.sql` begrenzen sie entsprechend. Sein512KiB-
|
||||
Chunklimit erweitert weder Store noch SQL und lädt heute das ganze Objekt in
|
||||
einen `Vec`.
|
||||
**Damit kann er Agentbinaries nicht transportieren.** Die bis256MiB großen
|
||||
Deskriptoren des neuen reinen Prüfkerns sind für eine noch offene, ausdrücklich
|
||||
Update-spezifische begrenzte Streaming-Erweiterung vorgesehen. Weder Import,
|
||||
Downloadroute noch Serverlimit werden in diesem Schnitt verändert. Spätere
|
||||
Integration muss dieselben Geräte-/Job-/Versuchs- und exakten Manifestbindungen
|
||||
auch für große Streams durchgehend erhalten. Kein vom LLM gelieferter
|
||||
Downloadhost, TCP-Override, Dateipfad oder TLS-Ausnahmeschalter.
|
||||
Der zukünftige Download wird gestreamt und vor Verwendung gegen
|
||||
Länge/SHA256 geprüft; Zusatzbytes und vorzeitiges EOF verweigern. Nach Reconnect
|
||||
stammt neue Startautorität immer aus dem normalen Plan-/Grantpfad.
|
||||
|
||||
`operations.plan(action=update_agent)` erhält nur die gespeicherte Release-ID
|
||||
und feste Ziele; Server löst unveränderliche Bytes aus dem berechtigten Katalog
|
||||
auf und bindet tatsächlichen gespeicherten Vorgänger sowie beide Artefakte.
|
||||
`operations.submit` bleibt Antrag; `jobs.get` zeigt Staging, Übergabe,
|
||||
Dienstprüfung, erhaltene Identität, Rollback und tatsächlichen Ausgang. Vor
|
||||
Genehmigung zeigt WebUI alle Hashes, Versionen, Rechte und Ausfall-/Rollbackgrenzen.
|
||||
Neue Datenverträge sind mit dem Skriptkonsolen-Eigentümer abzustimmen; dieser
|
||||
Vorschlag ändert noch keine Domain-/Protokoll-/Server-/Webdatei.
|
||||
|
||||
## Unabhängiger Worker und erhaltende Übergabe
|
||||
|
||||
Der Netzwerkagent bleibt unprivilegiert. Ein kleiner separat installierter
|
||||
Updater wird unter Root/SYSTEM mit restriktiver IPC/Peerprüfung angesteuert.
|
||||
Er prüft selbst Releasekey, Manifest, exakten Originaljob/-grant, aktuelle
|
||||
Identitäts-/Zuordnungs-/Boot-/Clock-/Syncbindung und lokalen Policykontext.
|
||||
Die schon vorhandenen Helperprüfungen dürfen nicht durch bloßes `approved=true`
|
||||
oder einen Dateimarker ersetzt werden. Sein eigener Journal-/Verbrauchsbezug
|
||||
muss vor Start serverseitig bekannt und unabhängig synchronisiert sein.
|
||||
|
||||
Der Updater startet nicht aus der gerade zu ersetzenden Agent-/Helperdatei und
|
||||
überlebt deren Stop. Geräteweite Locks serialisieren Paketmanager, Updates,
|
||||
Root-/SYSTEM-Skriptwartung und Reboots. Offene oder unbekannte Versuche sperren
|
||||
die erste Updateversion; keine Aktualisierung mitten in einer Wirkung.
|
||||
|
||||
1. Exakten Vorgänger, Trust-/Policy-/Serviceidentitäten, freie Kapazität und
|
||||
Zustandskompatibilität prüfen. Geschützte Stagingdateien create-only auf
|
||||
demselben Dateisystem; Files und Verzeichniseinträge dauerhaft flushen.
|
||||
2. Manifest und beide Dateien unabhängig prüfen; keine Wirkung vor Genehmigung.
|
||||
Ein Downloadfehler vor Übergabe bleibt belegter Nichtstart der Aktivierung.
|
||||
3. Vor Stop/Swap dauerhaften Intent mit Originaljob/Versuch/Grant und allen
|
||||
Vorherzeugen schreiben, Grant/Versuch einmalig verbrauchen. Nach unklarem
|
||||
Ausgang ausschließlich Zustand desselben Intents lesen, nie Execute wiederholen.
|
||||
4. Dienste geordnet einmal stoppen; aktive handles/Locks und SQLiteintegrität
|
||||
prüfen. Identitäten, Geräteschlüssel, Zertifikats-/Rotationstore, Konfiguration,
|
||||
ACLs, DBinodes/FileIDs, Originaltabellen/-zeilen, Journale/Signaturen und offene
|
||||
Outbox bleiben erhalten. Private Schlüsselbytes werden nicht exportiert.
|
||||
5. Für den ersten Aktivierungsschnitt empfehle ich **bestehende feste
|
||||
Service-Imagepfade erhalten**. Der unabhängige Updater stoppt und bestätigt
|
||||
beide Dienste, tauscht alle gebundenen Code-/Pin-Dateien unter den Locks,
|
||||
prüft vollständig die neue Kombination und startet erst dann einen Dienst.
|
||||
So läuft kein altes/neues Paar gleichzeitig, obwohl die Dateiersetzungen
|
||||
**kein atomarer Dateisystem-Bundleswap** sind. Der dauerhafte Intent benennt
|
||||
jede bereits erfolgte Ersetzung; ein Absturz lässt beide Dienste bis zum
|
||||
eindeutig belegten Abschluss oder Code-Rollback gesperrt. Vorhandene Runner
|
||||
zeigen dieses Wartungsfenster bereits, sind aber noch kein Selfupdater.
|
||||
Ein neuer Launcher würde Service-PID-/Image-/Peerprüfungen verändern und ist
|
||||
für diesen ersten Schnitt unnötig. Ein einzelner atomarer Versionsselector
|
||||
bleibt eine spätere Alternative mit eigener vollständiger Qualifikation.
|
||||
6. Neue Dienste einmal starten; actual Imagehash/Identität, passive Heartbeats,
|
||||
bestätigtes Inventar und erfolgreiches signiertes Sync mit geschlossenen
|
||||
Effectgates bis zum vollständigen Abgleich nachweisen. `Running` allein reicht
|
||||
nicht. Erst dann aktives Release/Antirollbackgrenze dauerhaft bestätigen.
|
||||
7. Bekannter Fehlstart darf genau die vorab gebundene Codeversion einmal
|
||||
zurückselektieren und starten; derselbe aktuelle Datenzustand bleibt liegen.
|
||||
Keine DB-/Ledger-/Generation-/Clock-/ACLrücksetzung. Fehlender/unklarer
|
||||
Rückkehrnachweis bleibt `unknown`, keine Schleife automatischer Startversuche.
|
||||
|
||||
Vorhandene SSH-Bootstraprunner (`vm_runtime_upgrade.py`,
|
||||
`cloud_shared_core_upgrade_v2.py`, `windows/runtime_feature_upgrade.py`) zeigen
|
||||
nützliche erhaltene DB-/Inode-/FileID-/Schlüsselmetadatenprüfungen und dauerhafte
|
||||
einmalige Intents. Sie sind administrative Einzeltools, keine ausgelieferten
|
||||
Selfupdater und keine Ersatzgenehmigung dieses Produktpfads. Frühere fehlerhafte
|
||||
Verifierberichte bleiben historisch; neue Abnahme muss konkrete aktuelle Daten
|
||||
binden, einschließlich vorhandener zulässiger Hardlinkpublikationen.
|
||||
|
||||
## Kleinster prüfbarer Quellschnitt und danach offene Arbeit
|
||||
|
||||
Nach Entwurfsreview implementiert: neue kleine `crates/updater`-Bibliothek,
|
||||
keine Daemonhülle. Dateien `Cargo.toml`, `src/lib.rs`, `src/manifest.rs` und
|
||||
neun gezielte Vertragsprüfungen mit vollständiger kanonischer Goldenfixture.
|
||||
Root-`Cargo.toml`/`Cargo.lock` nur für Workspacebindung; keine neuen fremden
|
||||
Paketversionen. Alle benutzten Abhängigkeiten waren bereits im Lockfile.
|
||||
Implementierte Funktion: bounded canonical manifest decode, strikte Ed25519-Verifikation gegen
|
||||
getrennten übergebenen Keyring, Plattform-/Clock-/Kompatibilitäts-/Versionsprüfung
|
||||
und begrenzte Streaming-Hash-/Längenprüfung von Artefakten. Keine Aktivierung,
|
||||
kein Netzwerk, keine generische OS-Dateischreib-API. Ein validiertes Objekt
|
||||
beweist nur gültige Releasebytes; dessen API darf weder Approval noch Startgrant
|
||||
behaupten oder aus dessen Besitz ein Applyrecht ableiten.
|
||||
|
||||
Der Kern wurde mit echten lokalen Signaturen und manipulierten/alten/falschen
|
||||
Releasebytes geprüft, ohne einen Agenten auf dem Notebook zu starten.
|
||||
Danach bleiben explizit offen: Serverkatalog/Veröffentlichung und echter
|
||||
Releasekeybetrieb, täglicher Agentcheck und gespeicherte Updatebeobachtung,
|
||||
typisierte Plan-/Grant-/UI-/MCP-Bindung, getrennte Updater-Verbrauchssynchronisation,
|
||||
geschütztes OS-Staging, unabhängiger Updaterbootstrap, mehrstufiger Dateiaustausch,
|
||||
Health-/Rollbackpfad, echte Linux-VM-Abnahme zuerst und Windows-VM-Abnahme danach.
|
||||
Ein Bibliotheksbuild ist weder Autoupdaterinstallation noch AT-26-/MVP-Erfolg.
|
||||
|
||||
Tatsächlich ausgeführt: vollständige Pflichtnormen gelesen und vorhandene
|
||||
Upgrade-/Kryptoverträge untersucht; eigener isolierter Worktree ab287a784.
|
||||
Der vorhandene Dockerbuilder mit Rust1.99.1 wurde offline, ohne Netzwerk und
|
||||
mit nur lesbarem Quellmount verwendet, eigener Targetausgabe. Image-ID:
|
||||
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`.
|
||||
Alle folgenden Prüfungen bestanden für `x86_64-unknown-linux-gnu`:
|
||||
|
||||
```text
|
||||
cargo fmt --manifest-path /src/Cargo.toml -p rmm-updater -- --check
|
||||
cargo clippy --manifest-path /src/Cargo.toml --locked --offline --target x86_64-unknown-linux-gnu -p rmm-updater --all-targets -- -D warnings
|
||||
cargo test --manifest-path /src/Cargo.toml --locked --offline --target x86_64-unknown-linux-gnu -p rmm-updater --all-targets --release
|
||||
```
|
||||
|
||||
Neun ausgeführte Vertragsprüfungen bestanden ohne Skip. Sie prüfen feste
|
||||
kanonische Bytes, echte domänengetrennte Ed25519-Signaturen, falschen/gesperrten
|
||||
Key und dessen Sequenzbereich, unbekannte/doppelte Felder,16KiB-Grenze,
|
||||
Plattform/Clock/Trustgeneration/Protokoll/Zustand/Updaterkompatibilität,
|
||||
Versionsfloor und gleichen Sequenzkonflikt, exakt zwei Artefaktrollen,
|
||||
Hash-/EOF-/IOfehler sowie512KiB+7Bytes mit tatsächlichem32KiB-Readlimit.
|
||||
Der verwendete private Testsignierschlüssel ist ausschließlich eine feste
|
||||
öffentliche Testfixture und wird nie als Vertrauensanker ausgeliefert.
|
||||
|
||||
Lokaler Beleg (gitignored): `devstate/agent-updater/local-qualification.json`
|
||||
bindet Quellen, Image-ID, tatsächliche Befehle/Loghashes und alle neun Testnamen.
|
||||
Die Linux-Release-Testexe ist1544584Bytes groß, SHA256
|
||||
`e3a1a3140da09de2f86055faa45faf7ba05ddddc2d92d23fef3df03a63bf2999`.
|
||||
Das ist ein lokaler Container-/Vertragsnachweis, **kein Cloud-VM-Nachweis**.
|
||||
Native Linux-Test-VM vor Windows, Serverintegration und tatsächlicher
|
||||
genehmigter Codewechsel bleiben offen. Kein Installer-/VM-Aufruf, keine
|
||||
Dienständerung, keine Freigabe und kein RMM-Job durch diesen Quellschnitt.
|
||||
|
||||
## Nächster Integrationsschnitt zur Freigabe: fester Codepaar-Updatejob
|
||||
|
||||
Die folgende Änderungsliste ist **nur Entwurf, nicht implementiert**. Sie
|
||||
ersetzt keine Sourcefreigabe, Bootstrapabstimmung oder native Abnahme. Mit dem
|
||||
Skriptkonsolen-Eigentümer abgestimmt: `update_agent`, `agent.update.apply/1`
|
||||
und `updates:apply` kollidieren nicht mit `full_maintenance_v1`. Dessen separater
|
||||
Helperpfad und das allgemeine/APT-Profil bleiben getrennt; alle benutzen dieselbe
|
||||
geräteweite Wirkungssperre und erhaltene Verbrauchshistorie.
|
||||
|
||||
### 1. Unveränderliche Action und Planbindung
|
||||
|
||||
Vorgeschlagene additive `Action::UpdateAgent { update: ResolvedAgentUpdate }`,
|
||||
eigener Modulvertrag `crates/domain/src/agent_update.rs`. Kein Aufruf von
|
||||
`run_script`, APT oder MSI. Alte Action-/Job-/Plan-/Grantbytes bleiben exakt
|
||||
erhalten. `JobPayload` behält seine bestehenden IDs, Identitätsgenerationen,
|
||||
Zeitgrenzen und Limits; `ExecutionPermit.action` lautet `update_agent` und
|
||||
bindet wie bisher den gesamten `job_payload_hash`. Vor Genehmigung erzeugt
|
||||
der Server die vollständigen Bytes je festem Ziel/Versuch.
|
||||
|
||||
`ResolvedAgentUpdate` hat in dieser festen kanonischen Feldreihenfolge:
|
||||
|
||||
| Feld | Typ und Bindung |
|
||||
|---|---|
|
||||
| `schema_version` | Genau1 |
|
||||
| `profile` | Genau `fixed_code_pair_v1` |
|
||||
| `release_envelope` | Schema1, Update-Key-ID, Payload/Signatur als Base64url ohne Padding; keine freien URLs |
|
||||
| `release_envelope_sha256` | SHA256 des kanonischen vollständigen Envelopes, einschließlich Signatur/Key-ID |
|
||||
| `manifest_sha256` | SHA256 der dekodierten exakten Release-Payloadbytes |
|
||||
| `predecessor` | Feste Release-ID, Sequenz, Manifesthash, `installed_record_sha256`, Agent-/Helperhash |
|
||||
| `updater` | Exakter installierter Updaterbinaryhash, lokale Policyhash, Keyringgeneration und Keyringhash |
|
||||
| `peer_pin_transition` | Typisierte Plattformvariante, feste Vorher-/Nachher-Settings-/Pinhashes; siehe unten |
|
||||
| `recovery` | Genau `restore_exact_predecessor_once` |
|
||||
| `health_profile` | Genau `mtls_inventory_sync_v1` |
|
||||
| `health_timeout_seconds` | Genau180 im ersten Schnitt; gesamter Job maximal600Sekunden |
|
||||
| `no_reboot` | Genau `true` |
|
||||
|
||||
Die beiden Artefakte und ihre Reihenfolge kommen ausschließlich aus dem signierten
|
||||
Manifest. `artifact_ids` als zusätzliche Requestparameter sind für diese Action
|
||||
verboten. Der Plan enthält je Job/Versuch genau die beiden daraus abgeleiteten
|
||||
`JobArtifactReference`s; generisches Nachladen weiterer Dateien ist verweigert.
|
||||
Weil die bisherigen Resolver kleine `artifacts` voraussetzen, erhält ausschließlich
|
||||
`update_agent` einen eigenen Resolver gegen den Updatekatalog. Alte Resolver und
|
||||
ihre Grenzen bleiben bestehen. Fehlende/doppelte/fremde Referenzen, geänderter
|
||||
Vorgänger oder ein von der Plattform abweichendes Release sperren bereits Planung
|
||||
und nochmals Submit, WebUI-Genehmigung, Revalidation, Startgrant und Download.
|
||||
Der vollständige Job muss weiter in die vorhandene64KiB-Helpergrenze passen.
|
||||
|
||||
Erste Einrichtung importiert die tatsächlich installierte bekannte Codepaar-
|
||||
Baseline als separat release-signierten Datensatz mit eigener Sequenz, prüft
|
||||
ihre Dateien und provisioniert daraus `InstalledReleaseRecord` und Floor.
|
||||
Dadurch besitzt auch das erste Update einen exakten bekannten Vorgänger; kein
|
||||
`unknown`, frei vom Agenten behaupteter Hash oder ungeprüftes Legacy-Downgrade.
|
||||
Dies ist Teil des gesonderten erhaltenden Updaterbootstraps, kein Codeupdate.
|
||||
|
||||
Windows benötigt einen festen Pure-Renderer: ausschließlich
|
||||
`Settings.agent.binary_sha256` und `Settings.helper.binary_sha256` werden aus
|
||||
den Zielartefakten ersetzt; alle Rechte, Dienste, Identitäten, Pfade, Runtime-
|
||||
und Clockflags bleiben gleich. Der daraus kanonisch abgeleitete Settingshash
|
||||
und öffentliche `Pin`-Hash stehen **vor Genehmigung** fest. Grundlage ist ein
|
||||
typisierter aktueller öffentlicher Deploymentbeleg des bestehenden Helpers,
|
||||
keine Secretdatei. Der lokale Updater prüft vor/nach unabhängig, dass exakt diese
|
||||
beiden Felder geändert werden. Der Server darf nur die exakt genehmigte neue
|
||||
Code-/Policybindung aktivieren; dadurch entstehen keine neuen Aktionsrechte.
|
||||
Linux verwendet bei unverändert codeunabhängigen Generalpins die Variante
|
||||
`unchanged_general_pin_v1`. APT-Akzeptanzbelege werden nicht neu signiert oder
|
||||
als für neue Codebytes gültig ausgegeben; gegebenenfalls bleibt APT geschlossen.
|
||||
Nicht unterstützte weitere Pinprofile sperren dieses erste Update, statt sie
|
||||
automatisch mitzunehmen oder neue Akzeptanznachweise zu erfinden.
|
||||
|
||||
### 2. Rechte, Beobachtung und Capability
|
||||
|
||||
Planurheber und Freigeber benötigen jeweils die üblichen Operationsrechte plus
|
||||
`updates:apply` und Linux `root:execute` beziehungsweise Windows `system:execute`.
|
||||
`scripts:execute` wird nicht daraus abgeleitet. Eine zusätzliche versionierte
|
||||
zentrale/local-Updaterpolicy begrenzt exakte Geräte-/Generations-/Principal-,
|
||||
Updater-/Keyring-/Manifest-/Vorgänger- und Pinbindungen. Standard bleibt deny.
|
||||
Die WebUI zeigt Ziel und Vorgänger, beide Binärhashes, Rechte, Unterbrechung,
|
||||
Rollback, Pinänderung und Fristen; MCP verwendet nur Plan/Submit/Status.
|
||||
|
||||
`agent.update.check/1` wird nach tatsächlich funktionierendem reinem Metadaten-
|
||||
Check gemeldet. `agent.update.apply/1` erst nach nativer aktueller Qualifikation
|
||||
des installierten unabhängigen Updaters, IPC-/Peer-/Lock-/Ledgerprüfung und
|
||||
bestätigtem signiertem Sync. Ein Librarybuild erzeugt keine Capability. Check
|
||||
speichert Quelle, tatsächlich beobachteten Manifesthash, Zeit, Qualität und
|
||||
`available`/`same`/`not_configured`/`error`; er lädt keine großen Dateien und
|
||||
legt weder Jobs noch Outbox für Wirkungen an. `rolled_back` beim installierten
|
||||
Record ist von der angebotenen Kandidatenversion getrennt sichtbar.
|
||||
|
||||
### 3. Begrenzter Releasekatalog und eigener großer Artefaktpfad
|
||||
|
||||
Neue immutable Tenanttabellen `agent_releases` und `agent_release_artifacts`
|
||||
mit zusammengesetzten Tenant-FKs, RLS/FORCE-RLS und ohne UPDATE/DELETE für die
|
||||
Anwendungsrolle. Release-ID/Sequenz/Plattform sind eindeutig; Publizieren
|
||||
verifiziert Signatur, kanonische Bytes, Rolle, Länge und Hash beider Dateien.
|
||||
Keine Änderung am262144Byte-`CHECK` der bestehenden `artifacts`-Tabelle.
|
||||
Ein tenantgebundener `AgentReleaseStore` arbeitet mit bereits geprüften
|
||||
content-addressierten, unveränderlichen Objekten und begrenzten Readhandles;
|
||||
kein `get()->Vec<u8>` für bis256MiB. Publikation ist ein Plattformbetriebsrecht,
|
||||
kein vom Modell befüllbarer allgemeiner Upload-/Signierdienst.
|
||||
|
||||
Neuer `GET /agent/v1/update-artifacts/{artifact_id}` mit `job_id`, `attempt_id`,
|
||||
`offset`, `length`: Geräte-mTLS, genau genehmigter aktueller `update_agent`-Job,
|
||||
aktuelle Tenant-/Geräte-/Generations-/Rechte-/Planbindung und exakt eine der
|
||||
beiden Referenzen. Jeder Chunk prüft diese Bindung erneut; höchstens512KiB,
|
||||
Gesamtobjekt höchstens256MiB, begrenzte Parallelität/IOzeit und kein Redirect.
|
||||
`Content-Range`, Gesamtgröße und SHA256 sind an den Deskriptor gebunden.
|
||||
Server verifiziert Objektidentität/-länge vor Read und streamt begrenzt;
|
||||
Agent/Updater prüft unabhängig den vollständigen Gesamt-SHA256 und exaktes EOF.
|
||||
Nach Antwortverlust dürfen nur fehlende Downloadbytes desselben geschützten
|
||||
Stagingobjekts weiterbezogen werden, niemals ein neuer Installer-/Aktivierungs-
|
||||
versuch. Eine fortgesetzte Datei wird vor Verwendung vollständig neu gehasht.
|
||||
|
||||
### 4. Stabiler Updater, einmalige Übergabe und Absturzverhalten
|
||||
|
||||
Separat bootstrapped stabiles Updaterbinary; dieser erste Updatejob verändert
|
||||
es nicht. Feste Linux-UID-/Windows-Dienst-SID-/PID-/Image-/ACLprüfungen, keine
|
||||
vom Agenten gewählten Programme/Pfade. Bestehende Agent-/Helper-Servicepfade
|
||||
bleiben erhalten. Alle tatsächlich installierten Profile, die dieselbe
|
||||
Helperbinary verwenden, müssen im fest provisionierten Dienstset stehen und
|
||||
vor Austausch bestätigt gestoppt sein; unbekanntes Profil verweigert. Der
|
||||
Updater gehört selbst nicht zu diesem Stopset.
|
||||
|
||||
Die erste Empfehlung ist **denselben bestehenden Helperverbrauchsledger und
|
||||
`executor.lock`** zu verwenden, wie heute schon mehrere Helperprofile, statt
|
||||
einen ungebundenen neuen Ready-/SQLitepfad zu eröffnen. Bootstrap fügt nur eigene
|
||||
append-only Updateintents hinzu, ohne alte Zeilen/Schemaobjekte zu ersetzen.
|
||||
Updater prüft seinen aktuellen Prozess-/Boot-/Clock-/Signatur-/Syncbezug selbst;
|
||||
ein anderer Prozess vererbt keine Bereitschaft. Ob der vorhandene gemeinsame
|
||||
Helpersnapshot dies ohne Wireerweiterung vollständig bindet, ist vor Runtime-
|
||||
Code anhand `HelperSync`/`ExecutorLedgerGuard` zu prüfen. Falls nicht, bleibt
|
||||
Apply geschlossen bis zu einer separat versionierten Participantbindung;
|
||||
kein weiterer Journal-ID-Slot wird stillschweigend in alten Tags versteckt.
|
||||
|
||||
Der Updater darf seinen eigenen Updateversuch nach Verbrauch als einzigen
|
||||
offenen Versuch führen; jeder **andere** offene/unknown-/unsettled-Versuch
|
||||
sperrt. Root-/SYSTEM-Wartungsskripte und Paket-/Rebootwirkungen verwenden
|
||||
dieselbe Sperre. Nach Übergabe überlebt der Updater Agent-/Helperstop und
|
||||
journalisiert im eigenen erhaltenen Intent die folgenden Phasen:
|
||||
|
||||
| Phase | Dauerhafter Beleg und zulässige Folgerung nach Absturz |
|
||||
|---|---|
|
||||
| `staged_verified` | Nur geprüfte Dateien vorhanden, noch kein Stop/Swap; Nichtstart nur mit unabhängig belegtem Nichtdispatch |
|
||||
| `handoff_consumed` | Originaljob/Grant/Versuch und vollständige Vorherzeugen fest, kein zweites Execute |
|
||||
| `stop_intent` / `all_stopped` | Einmaliger Stop angekündigt/bestätigt; unklare Dienste erst lesen, nicht blind erneut stoppen/starten |
|
||||
| `replace_intent(role)` / `replaced(role)` | Jede einzelne Code-/Pinersetzung bindet Original-/Zielhash, ACL und retained Backup; tatsächliche Datei entscheidet über Teilzustand |
|
||||
| `pair_verified` | Gesamtes neues Code-/Pinset vollständig geprüft, vor jedem neuen Dienststart |
|
||||
| `start_intent(service)` / `started(service)` | Jeder Start nur einmal, tatsächliche SCM-/systemd-/PID-/Imagebelege, kein Retry bei verlorenem Reply |
|
||||
| `health_verified` | Neues mTLS, tatsächlicher Codepaarbeleg, Inventar-ACK und signierter Sync für selben Originalversuch innerhalb180Sekunden |
|
||||
| `rollback_intent` / `rollback_verified` | Ausschließlich gebundene Originalcode-/Pinbytes einmal zurück, gleicher aktueller Datenzustand und unveränderter Floor |
|
||||
| `outcome_persisted` | Originalerfolg oder bekannter Fehlstart samt Rollbackresultat dauernd gespeichert; unverändert bis ACK erneut übermitteln |
|
||||
|
||||
Anwendungsweite Effectgates bleiben während Wechsel und Health geschlossen;
|
||||
der eigene bereits verbrauchte Updateversuch darf gezielt abgeglichen werden,
|
||||
ohne dadurch neue allgemeine Starts zu erlauben. Sonst würde die eigene offene
|
||||
Updatezeile Health-Sync dauerhaft blockieren. Nach frischem Prozessstart ist
|
||||
kein alter Gate-/Leasezustand gültig. Ein unbekannter Teiltausch/Start bleibt
|
||||
`unknown`; Recovery liest vorhandene Dateien/Intents und darf daraus keine
|
||||
neue Wirkungserlaubnis konstruieren. Allgemeines Resume bei ungeklärtem
|
||||
Dispatch und Endlosschleifen automatischer Rollbacks gehören nicht dazu.
|
||||
|
||||
### 5. Konkrete Datei-/Abnahmefolge nach erneutem Review
|
||||
|
||||
| Lieferung | Geplanter enger Dateiscope und überprüfbares Ergebnis |
|
||||
|---|---|
|
||||
| Gemeinsamer Vertrag | Additives `domain/src/agent_update.rs`, zugehörige `Action`-Matches und Golden-/Legacyfixtures; `updater` bleibt eigenständiger Verifier, keine OSwirkung |
|
||||
| Katalog und feste Planung | Neue Migration, `server/src/agent_releases.rs`, eigener Store/Streaminghandler, begrenzte Ergänzungen in `jobs`, `job_gateway`, Policy und MCPschema; alte Paketlimits bleiben bestehen |
|
||||
| Passive Agentbeobachtung | Bestehende Transport-/Inventarworker ergänzen festen Releasecheck und gespeicherte Beobachtung; keine angeforderte Liveaktion als Telemetrie tarnen |
|
||||
| Geschlossener Updaterworker | Neues unabhängiges Binary/OSadapter und versionierte Bootstrapdefinition, feste IPC/Locks/Ledger/Intents/Pinrenderer; keine offenen neuen Capabilities vor Qualifikation |
|
||||
| Linux-Abnahme zuerst | Reine Kernunits nativ auf Cloud-Linux; danach ein fixes WebUI-genehmigtes Update samt getrennten belegten Fehler-/Redelivery-/Stateerhaltungsfällen |
|
||||
| Windows danach | Native Kern-/IPC-/SCM-/Pin-/Codepaar-/Rollbackabnahme auf Windowsgast, dieselbe WebUI-/Tenantgrenze; keine Notebookdienste |
|
||||
|
||||
Vor Runtimefreigabe sind vor allem gemeinsamer Syncteilnehmer, exakt erlaubte
|
||||
Pinprofile und erfolgreiche Health bei ausschließlich eigenem offenen
|
||||
Updateversuch zu entscheiden. Diese Liste enthält keine neue Terminalengine,
|
||||
generischen Paketprovider, Keyrotationplattform, Restorefunktion oder weiteren
|
||||
Produktumfang. Alle genannten Dateien/Befehle/Abnahmen dieses Abschnitts sind
|
||||
**geplant, nicht ausgeführt**.
|
||||
Reference in New Issue
Block a user