Merge reviewed default-deny agent updater source checkpoint
# Conflicts: # docs/agent-updater-linux-native-results.md
This commit is contained in:
@@ -0,0 +1,231 @@
|
||||
# Reviewstand: erhaltene Helper-/Updater-Übergabe
|
||||
|
||||
2026-11-14. **Isolierter Quellvertrag, keine Produktnorm oder Applyruntime.**
|
||||
Basis: vollständige Spezifikation1.19, vollständige1.20-/PD-Ergänzung des
|
||||
Skriptconsole-Worktrees und [bisheriger Vorschlag](agent-updater-proposal.md).
|
||||
Root hat den engen Kernel und den Fullrenderer zur Ausarbeitung beauftragt;
|
||||
Runtimeintegration, Zielaktionen und Veröffentlichung erfolgen erst nach
|
||||
dessen Koordination. Linux-first und die tatsächliche WebUI-Grenze gelten.
|
||||
|
||||
Die neue Crate `rmm-updater-handoff` verändert weder den qualifizierten
|
||||
Releaseverifier noch die beiden vorhandenen nativen Verifier-Abnahmerunner.
|
||||
Sie enthält keinen Installer, Dateischreiber, Dienststart, IPC-Server,
|
||||
Netzwerkclient, SQLiteadapter, Approver oder neuen Server-Journalslot.
|
||||
Aus einem gültigen Handoff oder Healthreceipt entsteht keine Startberechtigung.
|
||||
|
||||
## Konkreter Vorwärtsvertrag
|
||||
|
||||
`Handoff` bindet ursprünglichen Tenant/Asset/Agent, beide Generationen,
|
||||
Plan-/Job-/Versuchs-/Grant-/Authorization-IDs, exakte Originalrequest- und
|
||||
Startzeugenhashes, beide vorhandenen Journal-IDs, Helpercheckpoint und letzten
|
||||
signierten Entscheid, Boot, ursprüngliche Verbindungsgeneration, einmalige
|
||||
Ownernonce, stabilen Updater-/Policyhash, Vorgängerrecord, erhaltene Zustands-
|
||||
und Stagingzeugen sowie Vorgänger-/Zielcodepaar. Der Rendererbeleg und alle
|
||||
benannten alten/neuen Dateihashes sind unveränderlicher Bestandteil.
|
||||
|
||||
Die Helperintegration muss Verbrauch, bestehenden exakten Startzeugen und
|
||||
Handoff **in derselben vorhandenen Ledgertransaktion** persistieren. Eine
|
||||
zusätzliche Transaktion nach `ledger::begin_execution` wäre unzureichend:
|
||||
ein Crash könnte einen Verbrauch ohne bestimmbaren Owner hinterlassen.
|
||||
Jeder andere offene/Unknown-Versuch verweigert die Übergabe. Das Handoff
|
||||
ersetzt weder den Originaljob/-grant noch dessen unabhängige Prüfung.
|
||||
|
||||
Die Writergrenze ist ausdrücklich Bestandteil dieses Vertrags: Der alte
|
||||
Helper persistiert auch den Stopintent vor der Übergabeantwort. Solange er
|
||||
seinen lebenslangen Windowsguard hält, schreibt der Updater kein Event in
|
||||
den gemeinsamen Ledger. Nach Stop/Guardübernahme kann der Updater All-stopped
|
||||
und Ownership zusammen transaktional anhängen. Nach dauerhaftem Rückgabeintent
|
||||
und tatsächlicher Guardabgabe stammen die weiteren Start-/Health-/Outcome-
|
||||
Events ausschließlich vom neuen Helper unter dessen Guard. Der Updater
|
||||
erhält nur die eng typisierte lokale Bridge; kein freies Ledger-Schreibrecht
|
||||
parallel zum neuen Helper. Ein einheitlicher Ledger-/Lock-Inode-/FileID-Hash
|
||||
ist vor Übergabe fest gebunden und wird bei Übernahme, neuem Servicepeer und
|
||||
Health erneut verglichen; bloß ein gleichnamiger Dateipfad reicht nicht.
|
||||
|
||||
Der begrenzte Journalcodec prüft kanonische Bytes, Hashvorgänger, monotone
|
||||
Sequenz/Zeit und höchstens16Events. Für Linux Full sind dies genau:
|
||||
|
||||
1. Stopintent, unabhängiger All-stopped-Zeuge, bestätigter Besitz des gleichen
|
||||
Helperledgers durch den konkreten stabilen Updaterprozess.
|
||||
2. Jeweils ein Intent und ein bestätigter Nachhash für Agent, Helper,
|
||||
Fullconfig und Fullpin; keine neue Dienstgeneration vor vollständigem Paar.
|
||||
3. Neues Code-/Pinpaar und erhaltener Zustandszeuge vollständig bestätigt.
|
||||
4. Dauerhafter Ledger-Rückgabeintent unter gehaltenem Guard, danach Guard
|
||||
tatsächlich abgeben; erst anschließend darf der neue Helper denselben
|
||||
Guard erwerben und starten.
|
||||
5. Konkrete neue Serviceprozesse mit Imagehash, PID und Prozessgeburt,
|
||||
anschließend signierter Healthbeleg und ursprüngliches Outcome-CAS.
|
||||
|
||||
Der Codec nimmt nur Beobachtungen entgegen. `prepare` liefert Bytes für ein
|
||||
append-only CAS gegen den bestehenden Head, **keinen Haltbarkeitsnachweis**.
|
||||
Der Plattformadapter muss Flush/Commit vor Wirkung, echte Service-/Peer-
|
||||
und Guardbeobachtungen, Dateihandles/ACLs sowie ursprüngliche SQLrows und
|
||||
Signaturen prüfen. Historischer Replay allein erkennt keinen abgeschnittenen
|
||||
Suffix; er muss gegen den erhaltenen dauerhaften Head, Rowcount und
|
||||
Ledger-/Inode-/FileID-/Kontrollkettenbeleg geprüft werden. Ein unbekannter
|
||||
Stop/Teilwechsel/Start bleibt lesend zu diagnostizieren, kein erneuter Execute.
|
||||
Ein expliziter Unknown ist im neuen Updatekernel terminal und wird durch
|
||||
spätere Health nicht geheilt. Bestehende allgemeine Outcome-CAS-Regeln bleiben.
|
||||
|
||||
## Fullhelper bleibt Teil des ersten Linux-Applyziels
|
||||
|
||||
Die tatsächliche Zieltopologie hat General, Full und Agent aktiv. Daher ist
|
||||
Full kein pauschaler Ausschluss. `linux_general_full_v1` erhält ein geschlossenes
|
||||
Stopset Agent/General/Full; ein bereits installierter APT-Reader kann zusätzlich
|
||||
als vierter Dienst im Stopset stehen, **nie im Startset**. Alle tatsächlich
|
||||
installierten Shared-Ledger-Reader müssen vor Austausch erkannt und gestoppt
|
||||
sein. Unbekannte Profile und ausgelassene Fullservices verweigern den Schnitt.
|
||||
Agent/General/Full erhalten dieselbe neue Codepaargeneration vor Restart.
|
||||
Die alte APT-Unqualifikation/-Deaktivierung bleibt bestehen; kein alter
|
||||
Acceptancebeleg wird umgeschrieben oder auf die neue Helperdatei übertragen.
|
||||
Zukünftiger APT-Start benötigt eine gesonderte passende Qualifikation.
|
||||
|
||||
`render_linux_full` akzeptiert ausschließlich das bekannte Full-Configschema,
|
||||
die daraus in fester Feldreihenfolge abgeleitete `control::Policy` Schema2
|
||||
und den zugehörigen `GeneralPin` Schema2. Alte Binär-/Policy-/Identitybindungen
|
||||
werden vorher geprüft. Die Rendererdefinitionen sind eine explizite
|
||||
Schemamomentaufnahme; Integration muss sie gegen die tatsächlichen Typen aus
|
||||
dem1.20-Quellstand vergleichen, bevor sie Runtime werden.
|
||||
|
||||
Der unabhängige Quellenreview fand einen echten Kompatibilitätsfehler des
|
||||
ersten Entwurfs: Die aktuelle Full-Rawconfig enthält einen leeren Inlinekey
|
||||
und einen `signing_key_file`-Pfad; die Runtime ergänzt den effektiven öffentlichen
|
||||
Key vor der Policyhashbildung. Der reine Renderer erhält deshalb jetzt den
|
||||
bereits provisionierten, **extern authentisierten** öffentlichen Signierkey
|
||||
als expliziten Parameter. Er öffnet keine Datei. Bei vorhandenem absolutem
|
||||
Keypfad darf der Raw-Inlinekey leer oder genau gleich sein; ohne Keypfad ist
|
||||
der gleiche Inlinekey Pflicht. Effektive Policy und Pin werden wie in der
|
||||
Runtime aus diesem Key abgeleitet; Raw-Inlinekey und Pfad bleiben unverändert.
|
||||
Der Transitionbeleg bindet zusätzlich `effective_signing_key_id`. Ein bloß
|
||||
geparstes `VerifyingKey`-Objekt authentisiert keine Provisionierung; der spätere
|
||||
Adapter muss den Input unabhängig gegen die vorhandene geschützte Keydatei
|
||||
und die gebundene öffentliche Identität prüfen. Eine neue lokale Vertragsprobe
|
||||
belegt den Filekeyfall und gleiche Policy-/Pinbytes zum Inlinefall. Dies ist
|
||||
weiterhin kein Lesen der realen Keydatei oder nativer Renderer-Nachweis.
|
||||
|
||||
Der Renderer ändert nur benannte Top-Level-Wertspans:
|
||||
|
||||
- Config: `helper_binary_sha256`.
|
||||
- Pin: `helper_binary_sha256` und daraus exakt neu berechnetes `policy_sha256`.
|
||||
|
||||
Alle anderen **rohen Config-/Pinbytes** bleiben erhalten, einschließlich
|
||||
Formatierung, Identity, öffentlicher Schlüssel, Keypfad, UID/GID, Socket,
|
||||
Statepfad und Rechtefelder. Er nutzt begrenzte typisierte Deserialisierung
|
||||
und geborgte `RawValue`-Spans; keine globale Stringersetzung, kein JSONpatch.
|
||||
Ein gleicher Hash innerhalb eines anderen Feldes bleibt erhalten.
|
||||
Unbekannte/duplizierte Felder, abweichende Policy, zusätzliche Profile/Services,
|
||||
fremde Identität und escaped Hashwerte werden verweigert.
|
||||
|
||||
Der `LinuxFullTransition` bindet alte/neue Rawconfig-, Rawpin-, Policy- und
|
||||
Helperhashes. Exakte Zielbytes samt Beleg müssen vor der WebUI-Genehmigung im
|
||||
festen Plan aufgelöst und später unabhängig erneut geprüft werden. General-
|
||||
und APT-Konfigurationen werden nicht gerendert. Die zentrale Fullscope wird
|
||||
**nicht migriert**; künftige Fulljobs bleiben ohne neue konkrete Scopebindung
|
||||
deny. Ein Codewechsel erteilt keine neuen Rechte.
|
||||
|
||||
## Enger Health- und Syncanschluss
|
||||
|
||||
Die eigene offene Updatezeile darf **keinen allgemeinen Readyzustand** erzeugen.
|
||||
`HealthReceipt` ist separat domänengebunden (`rmm.agent-update-health.v1\0`),
|
||||
mit strengem Ed25519 geprüft und an den gesamten Handoffhash, Ownernonce,
|
||||
Boot, beide erhaltenen Journale, neue Verbindungsgeneration und sämtliche
|
||||
konkreten neuen Agent-/Helperprozesse gebunden. Er enthält exakte Hashes des
|
||||
tatsächlich angewandten SignedSync-Requests/-Responses, Decision-ID und
|
||||
frisches Inventar samt ACK-Hash. `ready=true` wird ausdrücklich verweigert.
|
||||
Sync und Inventarempfang müssen nach den bestätigten neuen Dienststarts
|
||||
liegen. Health ist nur innerhalb180Sekunden gültig, Gesamtfrist höchstens600;
|
||||
kein Receipt verlängert sie. Der öffentliche Verifikationsschlüssel wird
|
||||
extern vertrauenswürdig provisioniert, nie aus dem Receipt übernommen.
|
||||
|
||||
Noch vor Integration normativ zu bestätigen:
|
||||
|
||||
| Anschluss | Erforderliche enge Änderung |
|
||||
|---|---|
|
||||
| `ledger::begin_execution` | Additive atomare Handoffanlage mit Originalverbrauch/-start im selben Ledger; keine Ersatzzeilen und kein Reset |
|
||||
| Helper-/Agent-Startup | Nur exakt vollständiges, lebendes, gleichbootiges, fristgebundenes Updatehandoff als `inflight` erkennen; vorhandenes Unknown niemals umschreiben |
|
||||
| `HelperSync`/Server-Sync | Typed Inflightdatensatz desselben Versuchs bei weiterhin geschlossenem Ready abgleichen; Originalkontrollkette erhalten |
|
||||
| `ClientSync::confirm_helper` | Bestehende allgemeine Unresolved-Sperre erhalten; neuer expliziter read-only Updatekontrollpfad darf keine Startlease setzen |
|
||||
| Lokales IPC | Eigener fest provisionierter Updaterparticipant mit Dienst-/UID/SID-/PID-/Geburts-/Imagebindung; Root/SYSTEM allein reicht nicht |
|
||||
| Healthroute | Tatsächlich gespeicherter neuer Geräte-mTLS-/Inventory-/Syncbeleg; lokale aktuelle Peer-/Code-/Stateprüfung plus exaktes Receipt vergleichen |
|
||||
| Finalisierung | Neuer Helper speichert ausschließlich das noch fehlende Originaloutcome per unverändertem CAS; danach bestehende Spiegelung/normaler Sync |
|
||||
|
||||
Keine dieser Runtimeänderungen ist durch den isolierten Kernel implementiert.
|
||||
Insbesondere ist ein Hash im Receipt kein Ersatz für die unabhängige Prüfung
|
||||
des zugehörigen aktuellen lokalen Kontroll-/Inventarbelegs. Rotation/Revoke-
|
||||
und Trustprovisionierung müssen den aktuellen sowie historischen Prüfkontext
|
||||
beibehalten; der Kernel implementiert keinen neuen Trustdienst.
|
||||
|
||||
Offen bleiben außerdem genehmigte typisierte Action/Plan/Grant-/UI-/MCP-
|
||||
Integration, Updatekatalog und begrenzter eigener Streamingpfad, OSstaging,
|
||||
stabiler Updaterbootstrap, Dienst-/Dateiaustausch, einmaliger zulässiger
|
||||
Vorgängercode-Rollback, tatsächliche Linux-Abnahme und danach Windows.
|
||||
Windows-Codepaar-/Settingsrenderer und Rollbackzustände sind hier **nicht**
|
||||
implementiert. Der ursprüngliche reine Linux9-/Windows9-Verifiernachweis
|
||||
bleibt unverändert; diese neuen Verträge haben noch keinen VM-Nachweis.
|
||||
|
||||
## Tatsächlich ausgeführte lokale Prüfungen
|
||||
|
||||
Offlinecontainer aus vorhandenem Image
|
||||
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`.
|
||||
Kein Server oder Agent auf dem Notebook gestartet, keine Ziel-/Policyaktion.
|
||||
|
||||
```text
|
||||
cargo check --manifest-path /src/Cargo.toml --offline -p rmm-updater-handoff
|
||||
cargo fmt --manifest-path /src/Cargo.toml -p rmm-updater-handoff
|
||||
cargo test --manifest-path /src/Cargo.toml --locked --offline -p rmm-updater-handoff --all-targets --release
|
||||
cargo clippy --manifest-path /src/Cargo.toml --locked --offline -p rmm-updater-handoff --all-targets -- -D warnings
|
||||
```
|
||||
|
||||
Bestanden: Check, Formatierung, Clippy ohne Warnungen und acht gezielte
|
||||
Vertragsprüfungen ohne Skip. Diese prüfen den vollständigen16-Event-Fullpfad,
|
||||
Originalketten-/Clock-/Limitgrenzen, Stop-/Lock-/Austausch-/Restartreihenfolge,
|
||||
fehlende Fullprozesse/APT-Ausschluss, echte getrennte Healthsignaturen,
|
||||
stale/fremde/ready-Health und terminalen Unknown sowie Rawbyteerhaltung,
|
||||
extern gebundene File-/Inline-Signierkeys und feindliche Fullrenderer-Eingaben.
|
||||
Nur lokale Vertragsnachweise; kein
|
||||
Bootstrapping, dauerhafter SQLite-Commit, nativer Dienst-/Apply-/Rollback-
|
||||
oder Produktionsnachweis. Der erste Formatbefehl scheiterte vor Cargo an
|
||||
einem nicht überschriebenen Image-Entrypoint; mit `--entrypoint cargo`
|
||||
anschließend tatsächlich ausgeführt. Keine Tests als Folge dieses Fehlers
|
||||
erfunden oder Zielaktion wiederholt.
|
||||
|
||||
## Fortschreibung: koordinierter Quellencheckpoint1.21
|
||||
|
||||
Der ursprüngliche a2efb79-Kernel und dessen Belegbytes bleiben unverändert.
|
||||
Sein tatsächlicher enger Linux8-Nachweis steht in
|
||||
[agent-updater-handoff-linux-results.md](agent-updater-handoff-linux-results.md).
|
||||
Die darauf aufbauende Coreintegration speichert Originalverbrauch, bestehenden
|
||||
Startzeugen, Handoff, konkrete Delegation und Stopintent in einer IMMEDIATE-
|
||||
Transaktion des vorhandenen Ledgers. Sie überträgt einen typisierten begrenzten
|
||||
Präfix in Protofeld14 und bestätigt ihn ausschließlich bei beiden Readyflags=false
|
||||
und unlock=false. Persistiertes Unknown bleibt terminal. Leere neue Felder
|
||||
lassen die alten Grant-/Decision-/Startcodecbytes unverändert.
|
||||
|
||||
Der Originalplan bindet separat provisionierten Healthpublickey und Rawpinhash;
|
||||
Admission liest den lokalen Pin unabhängig, historische Prüfung benutzt diesen
|
||||
Originalkontext. Server-Health verlangt originale gespeicherte SignedSync- und
|
||||
Baseinventarbytes samt bestätigender Folgerunde; sie eröffnet keine Admission.
|
||||
Der konkrete Helper muss dieselben lokal tatsächlich angewandten Bytes und
|
||||
Applyzeit innerhalb der belegten Zeitspanne unabhängig nachweisen.
|
||||
|
||||
Linux Full ist vorgesehener ursprünglicher Autorizer/Owner-/Healthguard.
|
||||
General bleibt in diesem Fall geschlossen und darf Nichtzuständigkeit nicht
|
||||
als OwnerLost terminalisieren. Das ist nötig, weil die tatsächlichen General-
|
||||
Capabilities keine Imageprüfung eines breiter berechtigten Fullprozesses erlauben.
|
||||
Kein Generalhärtungs-/Capabilitywechsel ist implementiert oder freigegeben.
|
||||
|
||||
Native Unterintents und Nachlesezeilen hängen im selben Ledger am Originalgrant.
|
||||
Feste Stop-/Dateischritte sind create-once, Rückgabe und genau drei Startclaims
|
||||
committen atomar. Nur ein weiterhin lebender ursprünglicher Worker darf die
|
||||
reservierte Folge nach tatsächlicher Lockabgabe einmal dispatchen. Neue Full-
|
||||
Helper bestätigen echte Start-/Health-/Recordbeobachtungen unter ihrem Guard.
|
||||
InstalledRecord/Floorcodec und separat signierter Bootstrapbaselinecodec sind
|
||||
reine Parsingverträge und ersetzen keine Trust-, Floor- oder OSprüfung.
|
||||
|
||||
Offen bleiben reale enge Fullbridge-/Owner-/Healthadapter, passive gültige
|
||||
Updatezustände/Kandidaten, vollständige erhaltende Baselineprovisionierung,
|
||||
Workerdispatch und End-to-End-Apply. Restore bleibt ausdrücklich verweigert:
|
||||
der eingefrorene Vorwärtskernel hat noch keinen qualifizierten Rollbackpfad.
|
||||
Der Agent meldet bis zur echten Provisionierung nur agent.update/not_configured;
|
||||
keine Applyfähigkeit aus Build/Katalog/Unitnachweis. Kein VM-Apply oder
|
||||
Windows-Applynachweis dieses Checkpoints.
|
||||
@@ -0,0 +1,206 @@
|
||||
# Linux-OS-Port des unabhängigen Updaters
|
||||
|
||||
Stand2026-11-14: neue Bibliothek `rmm-updater-linux`, auf Auftrag des Hauptagenten
|
||||
isoliert neben Domain/Core und Server/WebUI implementiert. **Noch kein laufender
|
||||
Updaterdienst und keine Applyabnahme.** Native Linux-first-Abnahme und sämtliche
|
||||
Zielaktionen bleiben beim Hauptagenten. Der vorhandene Releaseverifier, dessen
|
||||
Native-Runner sowie der separat qualifizierte achtteilige Handoffkernel bleiben
|
||||
unverändert.
|
||||
|
||||
**Aktueller lokaler Quellenstand nach unabhängigem Review:** Der weiter unten
|
||||
erhaltene4-Fälle-Beleg ist historisch. Ein echter Same-PID-Exec-Bindungsfehler
|
||||
wurde korrigiert, mit dem alten Code reproduziert und im neuen lokalen
|
||||
5-Fälle-Nachweis geschlossen. Dieser lokale Schritt allein ist kein nativer
|
||||
VM- oder Applynachweis; die danach separat durch Root ausgeführte native
|
||||
OS-Unitqualifikation ist am Ende ergänzt.
|
||||
|
||||
## Implementierte Betriebssystemstrecke
|
||||
|
||||
`files` öffnet jede Verzeichniskomponente mit gehaltenem `openat`-Dirfd,
|
||||
`O_NOFOLLOW` und `O_CLOEXEC`. Rootgeschützte installierte Verzeichnisse dürfen
|
||||
keine gruppen-/weltbeschreibbaren Vorfahren haben. Dateiprüfungen binden
|
||||
Device/Inode, UID/GID, Modus, vorhandene Linkzahl, Länge und SHA256; Hashing
|
||||
benutzt höchstens32KiB Lesepuffer. Historisch gebundene Hardlinks werden nicht
|
||||
pauschal verboten. Neue Stages haben genau einen Link.
|
||||
|
||||
Die vier Produktionsziele sind geschlossen: Agent, gemeinsame Helperbinary,
|
||||
Fullkonfiguration und Fullpin. Aus einem Request kommt kein Zielpfad.
|
||||
Staging entsteht exklusiv im **gleichen gehaltenen Installationsverzeichnis**,
|
||||
mit exaktem EOF/Längen-/Hashnachweis, ursprünglichen Besitz-/Moduswerten und
|
||||
Datei-/Directory-fsync. Fehlerhafte/partielle Stages bleiben erhalten und
|
||||
werden nicht automatisch wiederverwendet oder gelöscht. Der eingebettete
|
||||
Downloadreader muss selbst IOzeit und Kanalabbruch begrenzen; die Bibliothek
|
||||
prüft das ursprüngliche Boot-/Monotonbudget zwischen IOschritten, kann aber
|
||||
keinen beliebig blockierenden fremden `Read`-Aufruf unterbrechen.
|
||||
|
||||
Ein Austausch verlangt einen tatsächlich gehaltenen `LedgerGuard`. Vor jedem
|
||||
Namespaceeingriff werden dessen aktuelle Dateiidentität, weiterhin gestoppte
|
||||
Reader und Budget geprüft. Der Vorgänger wird mit `RENAME_NOREPLACE` unter
|
||||
seinem erhaltenen Inode auf einen festen Backupnamen verschoben; danach wird
|
||||
die verifizierte Stage ebenfalls ohne Überschreiben an den Originalpfad
|
||||
verschoben. Jede Phase benötigt vorher den dauerhaften `DurableEffectFence`.
|
||||
Ein Crash zwischen den Renames ist ausdrücklich **kein atomarer Bundleswap**:
|
||||
Vorgänger und Stage bleiben nachlesbar, neuer Execute-/Resumeversuch verboten.
|
||||
Ein zulässiges einmaliges Rollback benötigt eine eigene vorab gebundene Fence;
|
||||
es erhält beide Codegenerationen und verändert keine Zustandsdatei oder Floor.
|
||||
|
||||
`process` bindet echte `pidfd`s, ein gehaltenes `/proc/PID`-Verzeichnis,
|
||||
Prozessgeburt, alle UID/GIDwerte und ein gehaltenes Rootimage. Exithinweise
|
||||
und nachträgliche Abweichung verweigern. Imagehashing verwendet `pread`, damit
|
||||
parallele Nachlese keinen gemeinsam verschobenen Dateioffset verwendet.
|
||||
Nicht unterstützte Kernel erhalten keinen PID-/Prozessnamenfallback.
|
||||
Vor und nach dem Hashen wird das **aktuell ausgewählte** `/proc/PID/exe`
|
||||
erneut durch das gehaltene Proc-Verzeichnis geöffnet und per Device/Inode
|
||||
gegen das ursprüngliche Image gebunden; Geburt, Konten und pidfd werden
|
||||
danach nochmals geprüft. Ein noch lesbarer alter Image-FD allein genügt nicht:
|
||||
`execve` behält PID, Geburt und Credentials, wechselt aber die Codegeneration.
|
||||
|
||||
`services` kennt ausschließlich Agent/General/Full und optional den bereits
|
||||
inaktiven, deaktivierten APT-Reader. General und Full müssen dieselbe
|
||||
Helpergeneration haben. Geladene Unit und sämtliche Drop-ins werden als
|
||||
geschützte Fileproofs gebunden; Running/PID/Invocation-ID, native Prozesszeugen
|
||||
und tatsächliche Konten werden unabhängig nachgelesen. Ein Rootpeer genügt
|
||||
nicht: `SO_PEERCRED` muss zur aktuellen konkreten Helper-/Updater-Dienstinstanz
|
||||
mit gehaltenem Prozess passen. Der stabile Updater ist getrennt, UID/GID0,
|
||||
und gehört niemals zum Stopset.
|
||||
|
||||
Stop und Start benutzen feste argv an `/usr/bin/systemctl`, keine Shell oder
|
||||
freien Kommandos. Es gibt keine Enable-, Reboot- oder APT-Startoperation.
|
||||
Stop startet genau eine Systemdanforderung pro gebundenem alten Dienst und
|
||||
beobachtet danach dessen tatsächliches Ende. Nach vollständigem Code-/Pinpaar
|
||||
und Ledger-Rückgabe startet der enge Anschluss General, Full und Agent einmal.
|
||||
Timeout des eigenen Clients beendet nur dessen gehaltenen pidfd-Prozess;
|
||||
Systemd kann den Auftrag bereits übernommen haben. **Jeder Fehler nach
|
||||
möglicher Übergabe bleibt unklar; nie still wiederholen oder als Nichtstart
|
||||
ausgeben.**
|
||||
|
||||
`LedgerGuard` öffnet ausschließlich vorhandene `consumption.sqlite` und
|
||||
`executor.lock` unter `/var/lib/rmm-helper`. Kein Create/Truncate, kein neuer
|
||||
Journal-ID-Slot. Exklusive `flock`-Übernahme erfolgt erst nach bestätigtem Stop
|
||||
aller installierten Reader und bindet beide exakten Dateiidentitäten. Die
|
||||
Lebensdauer leiht `StoppedServices`; ein gleichzeitiger Start derselben
|
||||
Kontrollinstanz ist so ausgeschlossen. Vor Abgabe muss die eingebettete Fence
|
||||
den ursprünglichen `LedgerReturnIntent` dauerhaft gespeichert haben.
|
||||
|
||||
## Lokaler Kanal und noch fehlende Integration
|
||||
|
||||
Der implementierte IPC-Transport bindet ausschließlich den vorher separat
|
||||
provisionierten privaten Rootpfad `/run/rmm-agent-updater/control.sock`.
|
||||
Vorhandene Sockets werden weder entfernt noch wiederverwendet. Vor Parsing und
|
||||
Dispatch wird der tatsächliche aktuelle Helperdienst mit SO_PEERCRED und
|
||||
gehaltenen Prozess-/Unitzeugen authentisiert. Der Client authentisiert den
|
||||
fest provisionierten Updater unabhängig vor dem Senden und vergleicht seine
|
||||
Antwort mit genau diesem Participantbeleg. Ein begrenzter Längenheader erlaubt
|
||||
höchstens32KiB und eine Anfrage pro Verbindung. Methods sind Describe, Activate,
|
||||
Read und Health; keine Approval-, Pfad-, Befehls- oder neue Startgranterteilung.
|
||||
`ready` bleibt zwingend false. Activate-IOfehler erlaubt ausschließlich Read.
|
||||
|
||||
Es wird bewusst **keine permissive Engine/Fence und kein unfertiges Daemonbinary**
|
||||
ausgeliefert. Der Core-Eigentümer integriert Originalsignaturen, aktuelle
|
||||
TrustedClock/Trustpolicy, immutable Handoff/Delegation im bestehenden Ledger,
|
||||
alleinigen logischen Owner, feste Staging-/Fullrendererzeugen und den
|
||||
evidenz-only SignedSync-/Inventarhealthbeleg. Die beiden nativen Rename-Intents
|
||||
pro Datei sind zusätzliche vorhandene-ledger-gebundene Effectintents, keine
|
||||
Verdoppelung der begrenzten16 Handoffevents. Ein verlorener Writer oder
|
||||
definitives Unknown wird niemals durch diese OSbeobachtungen geheilt.
|
||||
|
||||
Noch offen: konkrete Core-Fence-/Engineimplementierung, monotone Floor- und
|
||||
InstalledRecordpublikation, Dienstbootstrap/stabiles Binary, tatsächliche
|
||||
Systemd-/IPC-/Staging-/Dateitausch-/Rückgabekette und zulässiger Rollback im
|
||||
WebUI-genehmigten Updateversuch. Der Loopback-/Rootbootstrapweg ist keine
|
||||
Jobgenehmigung. Notebook bleibt ausschließlich Entwicklungsrechner.
|
||||
|
||||
## Tatsächlich lokal geprüft
|
||||
|
||||
Isolierter Offline-Buildcontainer aus dem vorhandenen Image
|
||||
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`.
|
||||
Private eingefrorene Quellkopie mit nur Domain/Handoff/Linuxport als
|
||||
Workspacemembers, unveränderten Dependencyversionen; der private Lock wurde
|
||||
dort offline aufgelöst, ursprünglicher Workspace/Lock durch diesen Subagenten
|
||||
nicht verändert. Eigener Targetpfad `devstate/agent-updater-linux/target`.
|
||||
|
||||
Bestanden: Releasebuild und **4/4** Prüfungen, keine Skips/Filter, Clippy mit
|
||||
`-D warnings`, Formatcheck. Die beiden echten OSprüfungen betreffen ausschließlich
|
||||
neue private `/run`-Unitfixtures und einen eigenen gehaltenen Sleep-Prozess:
|
||||
Symlink-/Namensersatz-/Modusverweigerung, erhaltene gebundene Hardlinks,
|
||||
PID-/Geburts-/Image-/Konten-/Exitbindung und ursprüngliche Deadline. Der dritte
|
||||
Fall verweigert übergroße, doppelte, unbekannte und ungebundene IPCfelder.
|
||||
Der vierte nutzt ausschließlich ein lokales Unix-Socketpaar und belegt, dass
|
||||
fragmentierte Nachrichten die feste Gesamtlesefrist nicht durch einzelne
|
||||
erfolgreiche Bytes verlängern können; es läuft kein lauschender IPCserver.
|
||||
Die ursprüngliche Jobfrist begrenzt dabei auch jeden einzelnen blockierenden
|
||||
Socketaufruf; der zweite Teilfall belegt die kürzere Jobfrist gegenüber der
|
||||
längeren Framefrist.
|
||||
Dabei fand er einen echten Serde-Fehler: eine leere Unitvariante ignorierte
|
||||
Zusatzfelder; die strikte leere Structvariante ist korrigiert und nachgeprüft.
|
||||
Erster Compilerlauf meldete einen mehrdeutigen `File::by_ref`; typisiert
|
||||
korrigiert. Clippy forderte einen typisierten Stagingdescriptor statt acht
|
||||
einzelner Argumente; kein Lint wurde unterdrückt.
|
||||
|
||||
Keine lokale oder native Dienst-/IPCserversitzung, kein Aufruf von Systemd,
|
||||
kein Zugriff auf echte RMM-Zieldateien, kein Releaseapply und keine VM-Aktion.
|
||||
Diese Nachweise sind keine Abnahme der noch fehlenden Runtimeintegration.
|
||||
|
||||
Der create-only Nachweis liegt privat unter
|
||||
`devstate/agent-updater-linux/qualification-19449c78-6919-4e25-8750-cd3c450fb68e/`.
|
||||
Er bindet die tatsächlich verwendete eingefrorene Quellkopie, Befehle,
|
||||
Exitcodes und stdout/stderr. Linuxport-Quellsatz:
|
||||
`699276d3d3e467143d8ccf0fcb3b51949d3c2fffb1f7d0f0a167239ea2b10404`;
|
||||
Receipt: `ff569473d0ca8179948429f1fc78404e09c1666e4053b6efe672edf079696adc`;
|
||||
qualifiziertes lokales Unitbinary:
|
||||
`25e9de040b8a461291efb9566c02b6b3c2cb98d032ae8d071278dbbc0b2642cf`.
|
||||
Der frühere lokale 3-Fälle-Nachweis bleibt unverändert als historischer Stand
|
||||
erhalten und qualifiziert diese neuere Quelle nicht.
|
||||
|
||||
## Fortschreibung: Same-PID-Exec-Gegenbeleg und Korrektur
|
||||
|
||||
Der unabhängige Review fand, dass `HeldProcess::verify` zunächst nur das alte
|
||||
gehaltene Image erneut hashte. Ein `execve` im gleichen Prozess blieb dadurch
|
||||
unentdeckt. Die Korrektur bindet das aktuelle Kernel-Exeziel vor und nach dem
|
||||
Hashen an den ursprünglichen Dateizeugen und prüft die übrige Prozessidentität
|
||||
erneut. Es gibt keinen Prozessnamen-/PID-Fallback oder gelockerten Proc-Zugriff.
|
||||
|
||||
Die neue echte OSprobe startet ausschließlich einen eigenen Bashprozess,
|
||||
öffnet dessen pidfd/Image/Geburts-/UID-/GIDzeugnisse und lässt ihn über seine
|
||||
eigene Pipe nach `/usr/bin/sleep` execen. Ein neuer unabhängiger Zeuge bestätigt
|
||||
dieselbe PID, Geburt und Konten, ein weiter lebendes pidfd sowie den tatsächlich
|
||||
geänderten Imagehash. Der alte Zeuge muss verweigern. Die Kindumgebung ist
|
||||
geleert; ein RAII-Wächter beendet und wartet ausschließlich dieses eigene Kind
|
||||
auch bei einem Testpanic. Keine RMM-Dienste oder fremden PIDs werden berührt.
|
||||
|
||||
Tatsächlich lokal ausgeführt, isolierter Offlinecontainer mit eingefrorener
|
||||
Domain-/Handoff-/Linuxport-Quellkopie: korrigiert **5/5 ohne Skips/Filter**, Clippy
|
||||
`-D warnings` und Formatcheck bestanden. Danach wurde ausschließlich in dieser
|
||||
privaten Kopie `process.rs` durch die Originalquelle des erhaltenen4er-Belegs
|
||||
ersetzt. Die neue Execprobe scheiterte erwartungsgemäß mit Exit101 genau an
|
||||
`held.verify().is_err()`. Nach Rückkehr zur korrigierten Quelle bestanden erneut
|
||||
alle5Fälle. Das ursprüngliche4er-Receipt und dessen Binärdatei bleiben erhalten.
|
||||
Enger unabhängiger Re-Review des Fixes und seiner Belege: **PASS**.
|
||||
|
||||
Neuer create-only Beleg:
|
||||
`devstate/updater-linux-execfix-aa106c58-8c96-4c8a-8490-635b1d143f07/receipt.json`,
|
||||
SHA256 `f705ba03e5043a411fc3a0642197fc4f16da8627e1e5cbfbac78ed125ecb650c`.
|
||||
Finale lokale Unitexe:1538320Bytes, SHA256
|
||||
`b11b57e6399dcfcfb255619a8fba558beea6a57e4f1ee997ee9c63c769a1e882`.
|
||||
Snapshot und ursprüngliche Logs einschließlich des erwarteten Gegenfehlers
|
||||
bleiben privat erhalten. Nicht ausgeführt: VM, Systemd, IPCserver, Daemon,
|
||||
Releaseapply oder Deployment. Gerade der tatsächliche Generalhelperkontext
|
||||
kann andere Proc-/Capabilitygrenzen besitzen; ein isolierter Rootcontainer
|
||||
qualifiziert diesen noch nicht. Fehlender Proc-/Imagezugriff muss verweigern,
|
||||
keine Sandboxlockerung aus diesem lokalen Erfolg ableiten.
|
||||
|
||||
## Anschließend tatsächlich auf Cloud-Linux geprüft
|
||||
|
||||
Root führte die eingefrorene finale5er-Unitexe anschließend separat auf der
|
||||
festgelegten Linux-Cloud-VM als UID0 aus: Fall
|
||||
`ec030323-85df-4b38-9e70-87be330033c2`, genau5bestanden,0Skips/Filter.
|
||||
Eine getrennte Same-case-Nachlese war identisch. Keine RMM-Jobs, kein Apply,
|
||||
keine Dienststeuerung oder Änderung der laufenden Agent-/Helpergenerationen.
|
||||
Der Fullhelper blieb aktiv, seine Unit weiterhin disabled; daraus folgt kein
|
||||
Autostartnachweis. Der vollständige von Root veröffentlichte Originalbericht
|
||||
wird bytegleich übernommen: [Native Linux-OS5](agent-updater-linux-native-results.md)
|
||||
(Maincommit `c35c440`). Historische lokale Belege bleiben unverändert.
|
||||
|
||||
Das ist ein nativer OS-Unitnachweis, ausdrücklich **keine Qualifikation des
|
||||
restriktiven tatsächlichen Generalhelper-Dienstkontexts**, der konkreten
|
||||
IPC-Peers, Engine/Fence oder Releaseaktivierung. Diese Gates bleiben offen.
|
||||
@@ -0,0 +1,91 @@
|
||||
# Reinen Updater-Prüfkern zuerst auf Cloud-Linux qualifizieren
|
||||
|
||||
Stand 2026-11-14: Runner implementiert, lokal vorbereitet und anschließend vom
|
||||
Eltern-Orchestrator **auf der Cloud-Linux-VM ausgeführt:9/9 bestanden**.
|
||||
Dieser Schritt prüft ausschließlich die neun bereits lokal
|
||||
bestandenen Verifierverträge. Er installiert weder Updater noch Agent/Helper,
|
||||
öffnet keine Capability und führt keine Update-/Installer-/Skript-/RMM-Jobs aus.
|
||||
|
||||
`deploy/agent_updater_contract_acceptance.py` bindet den unabhängig geprüften
|
||||
Kerncommit `cc5c93596d0864c526b69a4f7efca805599b6ea1`, bestehende lokale
|
||||
Qualification, Sourcehashes und unveränderte Testexe. Änderungen an späterer
|
||||
Dokumentation erzeugen keinen falschen Rebuildbedarf. NativeDriver und die
|
||||
wiederverwendeten geprüften SSH-/Receipt-Helpers erhalten eigene Sourcehashes.
|
||||
Ein neuer Driverstand macht alte vorbereitete Manifeste absichtlich ungültig.
|
||||
|
||||
Tatsächlich lokal ausgeführt:
|
||||
|
||||
```text
|
||||
python3 deploy/agent_updater_contract_acceptance.py --help
|
||||
python3 deploy/agent_updater_contract_acceptance.py prepare-local --qualification /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater/local-qualification.json
|
||||
```
|
||||
|
||||
Das bestehende Testimage wurde **nicht neu gebaut oder erneut ausgeführt**.
|
||||
Originalbytes wurden create-only in den neuen geschützten Vorbereitungsordner
|
||||
kopiert. Nur `readelf` lief im gepinnten Offline-Dockerimage. ELF-x64, maximale
|
||||
GLIBC2.34 und benötigte dynamische Bibliotheken wurden ermittelt; native
|
||||
Lader-/Ausführungsfähigkeit bleibt bis zum VM-Lauf offen.
|
||||
|
||||
Lokales Manifest:
|
||||
`devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json`,
|
||||
SHA256 `a7f0903cea77c36c4d40df5ad486161c10e55bb9a9135629a555ffafd411d521`.
|
||||
Testexe unverändert1544584Bytes, SHA256
|
||||
`e3a1a3140da09de2f86055faa45faf7ba05ddddc2d92d23fef3df03a63bf2999`.
|
||||
Python-/erzeugte Remotequellsyntax sowie sechs Ergebnis-Verweigerungsfälle,
|
||||
Readback-ohne-Upload/-Run und fehlendes Native-Opt-in wurden lokal mit
|
||||
Transport-Mocks geprüft; keine SSH-Verbindung und kein erneuter Unitlauf.
|
||||
|
||||
**Anschließend tatsächlich durch den Eltern-Orchestrator ausgeführt:**
|
||||
|
||||
```text
|
||||
python3 deploy/agent_updater_contract_acceptance.py linux --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --execute-native-tests
|
||||
```
|
||||
|
||||
Der Runner liest erst bei diesem expliziten Aufruf die bereits vorhandene streng
|
||||
geparste Linuxzugangskonfiguration aus dem Maincheckout. Ausschließlich der feste
|
||||
Cloudclient als root auf der festgelegten Linux-Test-VM, vorhandener SSH-Key und bestätigter Hostkey sind
|
||||
zulässig. Keine Zugangsdaten im Argument-/Ergebnispayload oder Chat.
|
||||
|
||||
Remote wird ein neuer rootprivater Fall unter
|
||||
`/var/lib/rmm-agent-updater-contracts/<UUID>` einmal angelegt. Die exakt gehashte
|
||||
Testexe muss vor Start alle neun erwarteten Testnamen melden. Sie läuft mit
|
||||
geleerter Umgebung, eigener Scratchdirectory, Netzwerknamespace und CPU-/RAM-/
|
||||
Outputlimits. Vor dem einzigen Lauf steht der dauerhafte Create-once-Startmarker.
|
||||
Bei verlorenem Reply niemals `linux` erneut ausführen oder neu hochladen.
|
||||
Die ursprüngliche UUID steht im lokalen
|
||||
`devstate/agent-updater-native/<UUID>/intent.json`; anschließend ausschließlich:
|
||||
|
||||
```text
|
||||
python3 deploy/agent_updater_contract_acceptance.py readback-linux --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --case <ursprüngliche-UUID>
|
||||
```
|
||||
|
||||
Readback liest Ergebnis oder tatsächlichen Teilstatus desselben Falls. Es darf
|
||||
weder Upload noch Unitstart fortsetzen. Fehlender/unklarer Abschluss bleibt
|
||||
`verified=false`, `retry_allowed=false`. Erst vollständig geprüfte Original-
|
||||
Ergebnisse9/9 ohne Skip schreiben `linux-passed.json`. Dieser Nachweis ist auch
|
||||
dann **nur native Kernqualifikation**, keine erfolgreiche Agentaktualisierung,
|
||||
WebUI-Abnahme, Windowsqualifikation oder Produktdienst-/Capabilityfreigabe.
|
||||
|
||||
## Tatsächlicher Cloud-Linux-Nachweis
|
||||
|
||||
Rootfall `420d53da-6e34-4e04-b871-0b571d8d3fc4` auf dem festgelegten Cloudclient
|
||||
der Linux-Test-VM: Der Runner prüfte zuerst die vollständige tatsächliche Liste
|
||||
der neun erwarteten Tests und führte danach exakt diese neun ohne Skip aus.
|
||||
Exitcode0, kein Timeout und keine Fehlerausgabe. Geleerte Umgebung,
|
||||
Netzwerknamespace und unveränderte gehashte Originaltestexe sind im Ergebnis
|
||||
gebunden. Keine Produktzustandsänderung und kein RMM-Job durch diese Units.
|
||||
|
||||
Der geschützte lokale Beleg `linux-passed.json` neben dem oben genannten
|
||||
Manifest wurde zurückgelesen und unabhängig gegen erwarteten Fall,
|
||||
Manifest-/Artefakthashes und alle neun Testnamen geprüft. Proof-SHA256:
|
||||
`bb98bdbd010d23e2905cdffa37b2ad38639b43c770ed2efafd7fa9ac8a22f9d4`.
|
||||
Die tatsächliche VM-Ausführung erfolgte durch Root; der Verifier-Subagent
|
||||
führte weiterhin keine eigene SSH-/VM-Aktion aus.
|
||||
|
||||
Damit ist der **reine Linux-Prüfkern nativ qualifiziert**. Der danach getrennt
|
||||
ausgeführte Windows-GNU-Schritt bestand ebenfalls9/9; tatsächlicher Beleg und
|
||||
Grenzen stehen in [Windows-Kernqualifikation](agent-updater-windows-contracts.md).
|
||||
Selbstupdateinstallation,
|
||||
Releasekatalog/Streamingtransport, feste Plan-/Grant-/WebUI-Bindung,
|
||||
Updaterprozess und Code-/Pin-Aktivierung/Health/Rollback bleiben unverändert
|
||||
offen. Dieser Erfolg bescheinigt keinen vollständigen Agent-Autoupdater.
|
||||
@@ -0,0 +1,526 @@
|
||||
# Agent-Selbstupdate: kleinster zusätzlicher Schnitt
|
||||
|
||||
Stand 2026-11-14, **Integrationsvorschlag mit implementiertem reinem Prüfkern**,
|
||||
keine neue Produktnorm und kein Installations-/Applynachweis. Die reinen
|
||||
Linux-/Windows-Kernnachweise sind unten getrennt verlinkt. 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**.
|
||||
Der danach durch Root ausgeführte eigene Native-Linux-Schritt bestand9/9
|
||||
auf der Cloud-Test-VM, Fall `420d53da-6e34-4e04-b871-0b571d8d3fc4`,
|
||||
Proof-SHA256 `bb98bdbd010d23e2905cdffa37b2ad38639b43c770ed2efafd7fa9ac8a22f9d4`.
|
||||
Details und klare Grenzen: [Native Kernqualifikation](agent-updater-native-contracts.md).
|
||||
Danach bestand derselbe Prüfkern als Windows-GNU-Unitbinary9/9 auf dem
|
||||
Windowsgast, Fall `1a6dba2a-0db3-4aa8-8e21-dafcaabf85e3`, Proof-SHA256
|
||||
`fc6ef028f0d71639b940914d2cf66e809ed96f9803b4b0b10ea63c6e08978493`;
|
||||
[separater Nachweis](agent-updater-windows-contracts.md), kein MSVC-/Dienstbeleg.
|
||||
Serverintegration und tatsächlicher genehmigter Codewechsel bleiben
|
||||
offen. Kein Installer, keine Dienständerung, keine Freigabe und kein RMM-Job
|
||||
durch diesen reinen Prüfkern; der Subagent führte keine eigene VM-Aktion aus.
|
||||
|
||||
Zusätzlicher lokaler Reviewstand nach1.20: ein isolierter typisierter
|
||||
Handoff-/Healthkernel und geschlossener Linux-Fullrenderer sind implementiert,
|
||||
ohne den qualifizierten Verifier oder Runtime zu ändern. Die tatsächliche
|
||||
Linuxzieltopologie General+Full+Agent wird ausdrücklich berücksichtigt;
|
||||
Full bleibt kein pauschaler Ausschluss. Konkreter Vertrag, acht lokale
|
||||
Prüfungen, notwendige Reviewentscheidungen und weiterhin fehlende Integration:
|
||||
[Erhaltende Handoffgrenze](agent-updater-handoff.md). Dies ist keine neue
|
||||
Produktnorm, Zielinstallation oder native Applyabnahme.
|
||||
|
||||
## 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**.
|
||||
|
||||
## Geprüftes Runtimegate: eigener offener Versuch und Health
|
||||
|
||||
Sourcebefund, **Entwurf ohne Produktänderung**: `HelperSync::apply` in
|
||||
`crates/agent-core/src/helper_reconcile.rs:482` darf einen gültigen negativen
|
||||
signierten Abgleich dauerhaft übernehmen. Die Startlease bleibt geschlossen:
|
||||
`apply_inner` verlangt definitive Outcomes für sämtliche Zeilen und
|
||||
`can_start` zusätzlich null offene `consumed.result IS NULL`-Zeilen
|
||||
(`:575`, `:666`, `:696`). Deshalb darf Update-Health niemals allgemeines
|
||||
`ready=true` voraussetzen oder trotz eigener offener Zeile erzeugen.
|
||||
|
||||
Der normale Wiederabgleich macht gestartete unvollständige Versuche bewusst
|
||||
unknown (`agent-core/src/reconcile.rs:233`, `server/src/synchronization.rs:717`)
|
||||
und `ClientSync::confirm_helper` verweigert offene Helperwirkungen (`:127`).
|
||||
Dies zu ignorieren wäre keine Healthimplementierung. Benötigt wird ein neuer,
|
||||
ausdrücklicher **dauerhafter `pending/inflight`-Handoffvertrag** des genau
|
||||
genehmigten Updateversuchs. Er muss kontrollierte Eigentümer-/Prozessübergaben
|
||||
von einer tatsächlich unklaren Wirkung unterscheiden, ohne frühere Unknown-
|
||||
Events, definitive Unknown-Outcomes, Startzeugen oder Deadlines umzuschreiben.
|
||||
Fehlender Owner-/Handoff-/Zeitnachweis bleibt unknown und geschlossen; ein
|
||||
späterer Healthbeleg heilt ihn nicht und berechtigt keinen erneuten Start.
|
||||
|
||||
Windows hält `LedgerGuard` während der gesamten Helper-Dienstlebensdauer
|
||||
(`agent-windows/src/helper_system.rs:222`, `:822`). Der separate Updater kann
|
||||
denselben echten Lock daher nicht gleichzeitig erwerben und über den neuen
|
||||
Helperstart halten. Empfohlener enger Pfad: alter Helper prüft Originalgrant
|
||||
und verbraucht genau einmal, speichert immutable Delegations-/Ownerintent;
|
||||
stabiler Updater übernimmt denselben Ledger ausschließlich während bestätigtem
|
||||
Helperstop, prüft/tauscht Code+Pins und gibt die Ownership vor dem neuen
|
||||
Helperstart ausdrücklich zurück. Der neue Helper hält danach wieder seinen
|
||||
bestehenden Guard. Kein globaler Umbau zu schwächeren Locks pro Einzelrequest.
|
||||
|
||||
Vorhandene IPC vertraut ausschließlich dem Netzwerkagenten: Linux verweigert
|
||||
Root-Peers ausdrücklich (`privileged-helper/src/main.rs:92`), Windows bindet
|
||||
Agent-Service-SID/SCM-PID/Peerimage (`agent-windows/src/helper_ipc.rs:227`).
|
||||
Ein Updater darf sich nicht als dieser Agent ausgeben. Er benötigt eine neue
|
||||
eng typisierte **lokale Participantbindung** mit festem eigenem Dienst,
|
||||
UID/SID, tatsächlichem PID-/Image-/Prozessgeburts-/Policybeleg und ausschließlich
|
||||
Original-Handoff, Healthbezug und Finalisierung dieses einen Versuchs. Root
|
||||
oder SYSTEM allein sind kein ausreichender Peerbeleg. Bestehende ACL-/FileID-
|
||||
Prüfungen dürfen dabei nicht stillschweigend gelockert werden.
|
||||
|
||||
Gemeinsames erhaltenes Helperledger und aktueller Sync-Wirevertrag reichen für
|
||||
die Historie grundsätzlich; eine zweite ungebundene Server-Journal-ID ist
|
||||
für diesen Pfad nicht erforderlich. Ein negativer aktueller SignedSync ist
|
||||
nur Kontrollkettennachweis. Zusätzlich vorgeschlagen: ein **evidenz-only**
|
||||
signierter `UpdateHealthReceipt` mit eigener Domäne, Originalplan/Job/Versuch/
|
||||
Grant, Manifest/Codepaar/Pins, Ownernonce, Boot/Verbindung, tatsächlich
|
||||
angewandtem SignedSync und frisch serverseitig gespeicherten Inventarbelegen.
|
||||
Er ist weder ExecutionPermit noch Startlease, reaktiviert keine Genehmigung
|
||||
und verlängert weder Originalstart- noch Health-/Gesamtdeadline.
|
||||
|
||||
Erst nach unabhängigem lokalem Code-/Peer-/Intenterhaltungsnachweis und gültigem
|
||||
Receipt dürfte der neue Helper das **noch ausstehende ursprüngliche** definitive
|
||||
Outcome create-once speichern. Originale Signaturen/Events bleiben erhalten;
|
||||
generisches Ersetzen eines vorhandenen Unknown-Outcomes ist ausdrücklich
|
||||
ausgeschlossen (`ledger::persist_outcome`/Completion-CAS). Anschließend sollen
|
||||
vorhandene Helper→Agent-Spiegelung und normaler signierter Abgleich die gleiche
|
||||
Outcome-Bytefolge übernehmen und gezielt entsperren
|
||||
(`agent-core/src/reconcile.rs:898`, `helper_reconcile.rs:616`). Die vorhandenen
|
||||
Reboot-Sonderregeln für geänderte Outcomebytes werden nicht auf Updates
|
||||
verallgemeinert (`helper_reconcile.rs:1312`, `reconcile.rs:1237`).
|
||||
|
||||
Vor Applycode sind Pending-/Inflight-Lebenszyklus, Ownershipwechsel, neue lokale
|
||||
IPC-/ACLbindung und die rein beweisende Receiptsemantik normativ zu prüfen.
|
||||
Dieser Befund ist **keine Freigabe oder Implementierung** dieser Erweiterungen.
|
||||
@@ -0,0 +1,62 @@
|
||||
# Koordinierter Updater-Quellencheckpoint1.21
|
||||
|
||||
2026-11-14. Dieser Checkpoint verbindet den unveränderten signierten Verifier,
|
||||
den eingefrorenen Handoffkernel, Linux-OSports sowie Domain-/Core-/Protokoll-,
|
||||
Server-/MCP-/WebUI-Quellen. Er enthält keine ausgelieferte Applyruntime und
|
||||
keinen erfolgreichen Updatejob auf der Cloud-VM.
|
||||
|
||||
Implementiert sind der feste Updateplan mit zwei eigenen streambaren Artefakten,
|
||||
immutable Tenantkatalog, zusätzliche deny-only Rechte-/Policyprüfung für Ersteller
|
||||
und Freigeber, genaue WebUI-Byte-/Hashanzeige und der eigene passive agent.update-
|
||||
Scope. Der Agent meldet dafür derzeit ausschließlich not_configured; qualifizierte
|
||||
Apply-/Checkcapabilities werden daraus nicht abgeleitet. Der vorhandene kleine
|
||||
Paketartefaktpfad bleibt unverändert.
|
||||
|
||||
Im bestehenden Helperledger werden Verbrauch, alter Startzeuge, Handoff,
|
||||
Delegation und Stopintent atomar gespeichert. Typisierte Inflightkontrolle hält
|
||||
beide Readyflags und Unlock geschlossen. Native Unterintents sind create-once,
|
||||
rollen-/Head-/Nonce-gebunden und erhalten Originalhistorie. Getrennter geschützter
|
||||
Healthkey und Originalplanpin ersetzen jede frühere Jobsignerannahme. Die neue
|
||||
Serverroute prüft gespeicherte Original-Sync-/Baseinventarbelege; der konkrete
|
||||
lokale Fullguard muss diese unabhängig gegen eigene tatsächlich angewandte
|
||||
Rawbytes und Applyzeit prüfen. General ist dafür nicht zuständig und darf ein
|
||||
Originalupdate aus diesem Grund nicht zu Unknown machen.
|
||||
|
||||
Der Worker enthält echte geschützte Dateizeugen, historischen Originalrequest-
|
||||
Replay, Uhr-/Boot-/Deadlineprüfung, tatsächliche Prozess-/Dienstidentitäten,
|
||||
Originalledger- und native Dateieffektzäune sowie lokale Trust-/Baselineprüfung.
|
||||
Diese Bibliotheksbausteine sind kein aktivierter Daemon oder qualifizierter
|
||||
End-to-End-Dispatcher.
|
||||
|
||||
Lokal tatsächlich ausgeführt im vorhandenen Rust-Buildcontainer, Netzwerk aus:
|
||||
|
||||
- Gemeinsamer all-targets Check für Agent, Windowsquellen unter Linux-cfg,
|
||||
privilegierten Helper, Worker und Server: PASS.
|
||||
- Core64, Domain23 und Server45 Tests: PASS; fünf vorhandene Server-DB-Harnesstests
|
||||
ausdrücklich ignored. Diese5 sind kein DB-Abnahmenachweis.
|
||||
- Betroffene gemeinsame all-targets Clippyprüfung mit -D warnings: PASS.
|
||||
- Formatprüfung der betroffenen Pakete: PASS.
|
||||
- Echter separat baseline-/release-signierter Worker-Gegenfall:1/1 PASS.
|
||||
Exakte historische aktive Sequenz/Manifest bestehen; gleiche oder niedrigere
|
||||
Kandidaten am unveränderten Floor, Ablauf und Keywiderruf verweigern.
|
||||
Private Rückmutation auf den früheren Fehler active_release=None scheitert
|
||||
reproduziert mit Exit101. Das ist ein lokaler Trusttest, keine VM-Anwendung.
|
||||
|
||||
Lokale Befehls-/Logbelege liegen geschützt im ignorierten Verzeichnis
|
||||
`devstate/updater-checkpoint-090e6ad9-c88e-4f38-b6e1-f7fc1f189244/`.
|
||||
Die getrennte Deliveryqualifikation dokumentiert PostgreSQL15-Migrations-/RLS-
|
||||
und Webprüfungen in [agent-updater-server-console.md](agent-updater-server-console.md).
|
||||
Der tatsächliche Linux8-Kernel- und Linux5-OSnachweis ist separat in
|
||||
[agent-updater-handoff-linux-results.md](agent-updater-handoff-linux-results.md)
|
||||
und [agent-updater-linux-native-results.md](agent-updater-linux-native-results.md)
|
||||
dokumentiert. Root-OSfixtures ersetzen keinen General-/Full-Dienstkontextnachweis.
|
||||
Historische Belege bleiben unverändert.
|
||||
|
||||
Für eine wirkliche erste Anwendung fehlen weiterhin die enge Fullbridge mit
|
||||
qualifizierter Owner-/Healthguard-Implementierung, atomar übergebene live
|
||||
Workerdispatchstrecke, Record-/Floorpublikation, erhaltende1.21-kompatible
|
||||
Bootstrapbaseline, gültiger passiver Kandidatenzustand, ein neuer konkreter
|
||||
WebUI-genehmigter Linux-Apply sowie dessen unabhängiger Health-/Erhaltungsnachweis.
|
||||
Restore/Rollback bleibt deny, weil der unveränderte Vorwärtskernel noch keinen
|
||||
qualifizierten Rückweg besitzt. Windowsapply ist separat offen. Kein Zielhost
|
||||
wurde durch diesen lokalen Checkpoint installiert, gestoppt oder aktualisiert.
|
||||
@@ -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.
|
||||
@@ -0,0 +1,103 @@
|
||||
# Windows-GNU-Pack für den reinen Updater-Prüfkern
|
||||
|
||||
Stand 2026-11-14: Derselbe unveränderte Prüfkern aus `cc5c935` wurde nach dem
|
||||
tatsächlichen Cloud-Linux-Ergebnis9/9 für `x86_64-pc-windows-gnu` gebaut.
|
||||
**Anschließend nativ auf der Windows-Test-VM:9/9 bestanden.** Dies ist weder ein MSVC-Build noch
|
||||
ein Nachweis für Agentdienst, LocalService/SYSTEM, Zeitvertrauen oder Apply.
|
||||
|
||||
Der neue separate Runner `deploy/agent_updater_windows_contracts.py` bindet
|
||||
den vollständigen tatsächlichen Linuxproof
|
||||
`bb98bdbd010d23e2905cdffa37b2ad38639b43c770ed2efafd7fa9ac8a22f9d4`,
|
||||
dessen Originalmanifest und die vollständigen neun Testnamen. Der bestehende
|
||||
Linux-Runner `22e7e0a8…` bleibt unverändert; sein ursprüngliches Samecase-
|
||||
Readback wird durch diese neue Windowsquelle nicht geändert.
|
||||
|
||||
Tatsächlich lokal ausgeführt:
|
||||
|
||||
```text
|
||||
python3 deploy/agent_updater_windows_contracts.py build-local
|
||||
```
|
||||
|
||||
Gepinntes Offline-Dockerimage mit Rust1.99.1 und GNU-Windows-Toolchain:
|
||||
`sha256:1b2fd985d2c1fcc3545ace602405dc68fa899201bd8a73fa319ff96377203fa9`.
|
||||
Quellmount nur lesbar, eigener Targetordner. Windows-Clippy für alle Targets
|
||||
mit `-D warnings` und Release-Link der einzigen `release_contract`-Testexe
|
||||
bestanden; kein neuer Fremddep und keine Kernquelländerung. Die ungestrippte
|
||||
Originaldatei bleibt neben der gesonderten debuggestrippten Auslieferung erhalten.
|
||||
|
||||
Erster Packfall `build-f15c6c7d-5ff3-421d-b568-2ef0d3c5b649` blieb nach
|
||||
erfolgreichem Clippy/Link ohne Manifest stehen: Die enge DLL-Prüfung kannte das
|
||||
von Rust-std importierte `api-ms-win-core-synch-l1-2-0.dll` noch nicht. Nur dieses
|
||||
beobachtete Windows-API-Set wurde zusätzlich zugelassen. Ein neuer lokaler
|
||||
Packfall verwendete dieselben unveränderten Kernquellen und gecachten Linkbytes;
|
||||
alte Reports bleiben erhalten. Keine Windows-Unit wurde dabei ausgeführt.
|
||||
|
||||
Aktueller Packmanifest:
|
||||
`devstate/agent-updater-windows/build-5a9b7b49-39ba-4d34-b627-b3298886aa18/manifest.json`,
|
||||
SHA256 `341e58c254b0848b0553ddf6cd04bb7c322e73752c9a2c87f1d2162991648bf8`.
|
||||
PE-x64-Auslieferung2537309Bytes, SHA256
|
||||
`6c1d3d679c8558c50049c51755784863fc38f57c77c80e6ef005d89f09542396`.
|
||||
Importe: `KERNEL32.dll`, `USERENV.dll`, `WS2_32.dll`,
|
||||
`api-ms-win-core-synch-l1-2-0.dll`, `bcryptprimitives.dll`, `msvcrt.dll`,
|
||||
`ntdll.dll`. Das sind beobachtete Imports, kein bestandener Loadernachweis.
|
||||
|
||||
Python-Syntax, unveränderter vollständiger Linuxproof, sechs Ergebnis-
|
||||
Verweigerungsfälle, ausschließlich lesendes Samecase-Readback ohne Upload
|
||||
und fehlendes Native-Opt-in wurden lokal geprüft. Der geschützte Beleg
|
||||
`local-driver-guards.json` liegt beim Manifest. Kein SSH, keine Zugangsdaten-
|
||||
abfrage, kein Notebookagent und keine VM-/Dienst-/Policy-/RMM-Jobaktion.
|
||||
Der Orchestrator prüfte anschließend die vollständige Remotequelle mit dem
|
||||
vorhandenen lokalen PowerShell-AST-Parser erfolgreich. Der tatsächlich erzeugte
|
||||
SSH-Prozessaufruf umfasst17874Zeichen und liegt unter der32767Zeichen-Grenze.
|
||||
Der Verifier-Subagent führte weiterhin keine eigene SSH-/VM-Aktion aus.
|
||||
|
||||
**Nach Sourceprüfung tatsächlich durch den Eltern-Orchestrator auf der
|
||||
festgelegten Windows-Test-VM ausgeführt:**
|
||||
|
||||
```text
|
||||
python3 deploy/agent_updater_windows_contracts.py windows --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-windows/build-5a9b7b49-39ba-4d34-b627-b3298886aa18/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --execute-native-tests
|
||||
```
|
||||
|
||||
Nur dieser explizite Aufruf liest den bestehenden privaten Zugang über
|
||||
`credentials/server.conf`, `credentials/windows-dev-access.json` und den
|
||||
bestätigten Windows-Hostkey. Keine Zugangsdaten oder Transportpräfixe in diesem
|
||||
Beleg. Er erzeugt einen neuen privaten Bootstrap-Scratchfall und überprüft
|
||||
vor dem einzigen Testlauf tatsächlich alle neun erwarteten Namen. Die Tests
|
||||
laufen als Bootstrapadministrator mit geleerter Umgebung und begrenzter
|
||||
Laufzeit/Ausgabe. Ein dauerhaftes Create-once-Intent verhindert Wiederholung.
|
||||
|
||||
Nach Antwortverlust niemals neu starten oder neu hochladen; die ursprüngliche
|
||||
UUID steht im lokalen `devstate/agent-updater-windows/<UUID>/intent.json`.
|
||||
Ausschließlich desselben Falls lesend abgleichen:
|
||||
|
||||
```text
|
||||
python3 deploy/agent_updater_windows_contracts.py readback-windows --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-windows/build-5a9b7b49-39ba-4d34-b627-b3298886aa18/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --case <ursprüngliche-UUID>
|
||||
```
|
||||
|
||||
Erst ein vollständiger tatsächlicher9/9-Beleg ohne Skip erzeugt
|
||||
`windows-gnu-passed.json`. Auch dieser Erfolg qualifiziert nur den reinen
|
||||
GNU-Prüfkern auf dem Windowsgast, keine installierte
|
||||
Selbstupdatefunktion oder MSVC-Agentlaufzeit. Normreview, Releasekatalog,
|
||||
Streaming-/Plan-/WebUI-Bindung und eigenständiger Updater mit erhaltendem
|
||||
Code-/Pin-Austausch bleiben ausdrücklich offen.
|
||||
|
||||
## Tatsächliche native Windows-GNU-Ergebnisse
|
||||
|
||||
Rootfall `1a6dba2a-0db3-4aa8-8e21-dafcaabf85e3`: Tatsächliche Liste aller neun
|
||||
gebundenen Testnamen zuerst geprüft, anschließend9/9 ohne Skip bestanden,
|
||||
Exitcode0, kein Timeout und keine Fehlerausgabe. Die Nativeexe entspricht
|
||||
exakt der oben genannten Auslieferung und ist an den ursprünglichen tatsächlichen
|
||||
Linuxproof gebunden. Geschützter Beleg `windows-gnu-passed.json` neben dem
|
||||
Packmanifest, SHA256
|
||||
`fc6ef028f0d71639b940914d2cf66e809ed96f9803b4b0b10ea63c6e08978493`.
|
||||
Der Beleg wurde gegen Fall, Manifest, Linuxproof, Artefakt und alle neun Namen
|
||||
zurückgeprüft.
|
||||
|
||||
Das tatsächliche Ergebnis weist ausdrücklich `local_service_proof=false`,
|
||||
`system_proof=false`, `msvc_runtime_qualified=false`, `rmm_jobs=false` und
|
||||
`activation_implemented=false` aus. Die Units liefen ausschließlich im eigenen
|
||||
Bootstrap-Scratchfall; keine Agent-/Helperinstallation oder Policyänderung.
|
||||
Damit ist derselbe reine Prüfkern **zuerst auf Cloud-Linux, danach auf dem
|
||||
Windowsgast als GNU-Unitbinary** nativ qualifiziert. Der Autoupdater selbst
|
||||
bleibt bis zur gesonderten Runtime-/Genehmigungs-/Health-/Rollbackintegration
|
||||
unimplementiert.
|
||||
@@ -0,0 +1,111 @@
|
||||
# Linux-Worker: konkreter Zwischenstand
|
||||
|
||||
2026-11-14, Spezifikation1.21. `crates/updater-worker` ergänzt die eingefrorenen
|
||||
Linux-OS-Primitiven; es ist noch kein ausgelieferter Updaterdienst und keine
|
||||
Applycapability. Keine Zielaktion oder Genehmigung durch diesen Quellschnitt.
|
||||
|
||||
## Implementiert
|
||||
|
||||
`NativeClock` verwendet eine tatsächlich lesende `adjtimex`-Abfrage samt
|
||||
Synchronisations-/Fehlergrenze und vergleicht die laufende Wanduhr mit dem
|
||||
monotonen ursprünglichen Prozessbezug. IPC-/Serverzeit ist kein Ersatz.
|
||||
|
||||
`Original` prüft den erhaltenen Originalrequest einschließlich Originalsignatur
|
||||
bei dessen unveränderlichem Verbrauchszeitpunkt. Exakte Rekonstruktion des alten
|
||||
Startzeugen, Plan-/Job-/Versuchs-/Grant-/Authorizationbindung, Generationen,
|
||||
Codepaar, Fulltransition und ursprünglicher Boot müssen stimmen. Aktuelle Uhr,
|
||||
Boot und Gesamtfrist bleiben vor späteren Schritten verpflichtend; der alte
|
||||
Startzeitpunkt ist ausdrücklich kein erneuertes Startfenster.
|
||||
|
||||
`RetainedSet` hält Dateideskriptoren und Parent-/Dateiidentitäten. Für Schlüssel
|
||||
und Konfiguration werden zusätzliche Metadatenstempel verglichen, ohne private
|
||||
Schlüsselbytes zu lesen oder auszugeben; mutable Datenbanken dürfen bei gleicher
|
||||
Dateiidentität fortschreiten. Die konkrete vollständig erforderliche Dateiliste
|
||||
muss aus separat geprüfter lokaler Provisionierung kommen. Eine Teilmenge ist
|
||||
kein vollständiger History-/PKI-Erhaltungsnachweis.
|
||||
|
||||
`FullFiles` liest die konkreten geschützten Rawconfig-/Rawpinbytes sowie die
|
||||
unabhängig provisionierte öffentliche Jobsignierkeydatei. Der vorhandene reine
|
||||
Fullrenderer muss exakt den vor WebUI-Genehmigung gebundenen Transitionbeleg
|
||||
ergeben. Nur dessen exakte Config-/Pinbytes werden create-only gestaged.
|
||||
|
||||
`StableParticipant` verlangt den tatsächlichen eigenen MainPID des festen
|
||||
Updaterdiensts mit Prozessgeburt, aktuellem Image, Konto und Unitkomposition.
|
||||
Die ursprüngliche konkrete Helperinstanz wird ebenso gegen die atomare
|
||||
Delegation geprüft. `/proc`-/Capabilityfehler werden verweigert; kein UID0-,
|
||||
Prozessname- oder installierter-Dateipfad-Fallback. Getrennte tatsächliche
|
||||
General-/Full-/Updater-Dienstkontexte sind noch nativ zu qualifizieren.
|
||||
|
||||
`TrustState` lädt ausschließlich geschützte feste Policy-/Keyring-/Healthpin-
|
||||
und InstalledRecord-Dateien. Originale rohe Hashes bleiben maßgeblich. Die
|
||||
initiale Baseline benötigt ihre gesonderte Ed25519-Domänensignatur; aktuelle
|
||||
Schlüsselwiderrufe/-bereiche und Releaseverifikation werden unabhängig geprüft.
|
||||
Health-/Release-/Jobkeys werden getrennt geprüft. Die erste Aktivierung bleibt
|
||||
an den separat signierten Bootstraprecord gebunden. Ein `Updated`-Vorgänger
|
||||
wird bis zur vollständigen Record-/Health-Historyprüfung ausdrücklich verweigert.
|
||||
Keine Floorableitung aus einem bloß geparsten Record, kein Releaseprivatkey
|
||||
auf dem Client. Die getrennte TLS-Keyprovisionierung bleibt ein Bootstrapgate.
|
||||
|
||||
`FileWitnesses` bindet die vier tatsächlich vorhandenen Original-/Stageproofs.
|
||||
Es liest vor jedem einzelnen Schritt unabhängig Original, Stage, erhaltenes
|
||||
Backup oder neues Ziel nach. Historisch gebundene Hardlinks werden erhalten.
|
||||
|
||||
`OwnedLedger` öffnet ausschließlich die vorhandene `consumption.sqlite` ohne
|
||||
CREATE, nachdem ein echter Linux-OS-Guard alle installierten Reader gestoppt
|
||||
bestätigt hat. Derselbe Ledger-/Lockinode, Originalstart, vollständiger
|
||||
Handoffhead und null weitere offene Verbräuche bleiben Pflicht. Der konkrete
|
||||
Coreguard verifiziert tatsächliche Prozesse, Dateien und Statezeugnisse vor
|
||||
append-only Handoff-CAS und nativen Effectintents im selben Ledger.
|
||||
|
||||
`LedgerFence` verwendet die konkreten Core-APIs `claim_native_effect` und
|
||||
`observe_native_effect`. Pro Datei bleibt genau ein Kernel-ReplaceIntent;
|
||||
SavePredecessor und PublishReplacement erhalten getrennte dauerhafte native
|
||||
Intents und Nachlese. Ein fehlgeschlagener/mehrdeutiger Schritt vergiftet den
|
||||
laufenden Fence; keine Resume-/Retrykonstruktion aus einem Teilintent.
|
||||
|
||||
## Offen und standardmäßig verweigert
|
||||
|
||||
Vollständige Engine/Daemonhülle und originale aktivierungsgebundene Stageaufnahme,
|
||||
Full-Control-Bridge vor Stop, drei Stopbeobachtungen vor AllStopped, atomare
|
||||
Rückgabe-/Startreservation, tatsächliche Guardabgabe vor einmaligen Starts,
|
||||
neuer Full-Observer und tatsächlicher Health-/Outcomeanschluss sind noch offen.
|
||||
Floor-/InstalledRecordpublikation braucht zusätzlich die geschlossenen
|
||||
originalen nativen Intents nach Health und erhaltende Record-CAS. Folgeupdates
|
||||
brauchen vollständige geschützte Record-/Health-Historyverifikation.
|
||||
|
||||
Der eingefrorene Vorwärtskernel hat noch keinen qualifizierten Rollbackübergang.
|
||||
`RestorePredecessor` bleibt deshalb auch bei vorab gebundener Recoveryoption
|
||||
verweigert; Fehler/Unknown erteilen keinen impliziten Rollback oder Neustart.
|
||||
Das ist eine offene Apply-/Produktanforderung, kein abgeschlossener Updater.
|
||||
|
||||
## Tatsächliche lokale Prüfung
|
||||
|
||||
Offlinecontainer aus bestehendem Image
|
||||
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`.
|
||||
Der konkrete Ledger-/Native-Fenceanschluss hat
|
||||
`cargo check --locked --offline -p rmm-updater-worker --all-targets`
|
||||
tatsächlich bestanden. Der vollständige aktuelle Checkpoint einschließlich
|
||||
TrustState bestand danach Clippy mit `-D warnings` für alle Crate-Targets.
|
||||
Ein Box-Typfehler und zwei unnötige `as_ref`-Aufrufe wurden
|
||||
korrigiert, ohne Typ- oder Lintunterdrückung.
|
||||
|
||||
Der unabhängige Rootreview fand danach einen konkreten historischen
|
||||
Baselineblocker: `active_release=None` bei `floor=baseline_sequence`
|
||||
verweigert im unveränderten Frozenverifier jede legitime Baseline. Die tatsächliche
|
||||
historische Prüfung bindet jetzt die exakte aktive Baseline-Sequenz und deren
|
||||
Manifesthash; der Floor bleibt unverändert und Kandidaten bleiben aktuell.
|
||||
Der gezielte reale Ed25519-Gegenbeleg benutzt einen kanonischen separat
|
||||
baseline-signierten InstalledRecord und echte Release-Signaturen. Die private
|
||||
Rückmutation auf den alten `None`-Kontext scheiterte erwartungsgemäß genau an der
|
||||
Baselineprüfung (Exit101); derselbe Release-Test mit Korrektur bestand **1/1**.
|
||||
Neuer aktueller Kandidat oberhalb des Floors besteht, gleiche/niedrigere Sequenz
|
||||
mit anderen Bytes, abgelaufenes Angebot und widerrufener Baselinekey werden
|
||||
verweigert. Release-Test, Clippy `-D warnings` und Formatcheck bestanden aus
|
||||
derselben privaten Quellkopie. Kein Frozenverifier wurde dafür verändert.
|
||||
Privater Nachweis:
|
||||
`devstate/agent-updater-worker/baseline-fix-1fcc8bb2-57fe-4425-b166-f416dc1b4703/`.
|
||||
|
||||
Keine Engine gestartet, kein systemd-Aufruf, keine echte Zieldatei geändert,
|
||||
keine VM/SSH-/Job-/WebUI-Aktion und kein nativer Worker-/Applynachweis.
|
||||
Der native Linux-OS5-Nachweis qualifiziert weiterhin dessen eigene eingefrorene
|
||||
Primitiven und ersetzt keine Worker-/Dienstkontextabnahme.
|
||||
+20
-1
@@ -1,6 +1,6 @@
|
||||
# Linux-first-Entwicklung und reale VM-Abnahme
|
||||
|
||||
Stand: 2026-11-14 · Spezifikation 1.20. Das begrenzte Linux-MVP ist inzwischen
|
||||
Stand: 2026-11-14 · Spezifikation 1.21. Das begrenzte Linux-MVP ist inzwischen
|
||||
dokumentiert abgenommen; aktuelle Nachweise stehen in [handover.md](handover.md).
|
||||
Die getrennte Windows-SYSTEM-Grenze ist in Spezifikation0.1 und
|
||||
[windows-system-policy.md](windows-system-policy.md) präzisiert; Quellen-/Build-
|
||||
@@ -17,6 +17,25 @@ Deploymentnachweise: [server-deployment.md](server-deployment.md).
|
||||
Die folgenden PC-Server-/Reverse-Tunnel-Abläufe und Nachweise sind historisch.
|
||||
TLS/mTLS, Credentialschutz, Linux-first und WebUI-Plangenehmigung gelten weiter.
|
||||
|
||||
## Enger paralleler Agentupdater (Version1.21)
|
||||
|
||||
Der User hat signiertes Agent-Selbstupdate parallel vorgezogen. Es bleibt ein
|
||||
festes Release-/Vorgänger-/Versuchs-/Planhashpaket mit tatsächlicher WebUI-
|
||||
Genehmigung; passive Metadaten/Updatezustände sind keine Jobs. Neuer
|
||||
`agent.update`-Scope liefert eigene tatsächliche Beobachtungszeiten und darf
|
||||
kein altes Linux-/Windows-Baseinventar frischstempeln. Beide Binaries werden
|
||||
vollständig vor Handoff gestaged; anschließender read-only Inflight-/Health-
|
||||
Kontrollpfad eröffnet keine Admission oder neue Startlease.
|
||||
|
||||
Vor Zielarbeit: kompatible erhaltende Bootstrap-/Baselineprovisionierung,
|
||||
unabhängiger Source-Review, Linux-first-Units/OSports und danach ein konkreter
|
||||
WebUI-genehmigter Apply mit State-/PKI-/Historyerhaltung und erlaubtem Code-
|
||||
Rollback. Root koordiniert alle Zielaktionen. Notebook bleibt nur Entwicklung.
|
||||
Aktuelle Teilnachweise und fehlende Runtimegates:
|
||||
[Handoff](agent-updater-handoff.md), [Linuxport](agent-updater-linux-port.md),
|
||||
[Server/UI](agent-updater-server-console.md). Keine Applycapability aus einem
|
||||
Build oder Katalogeintrag ableiten; fehlende Qualifikation bleibt deny.
|
||||
|
||||
## Vorrang: genehmigte Batch-Skriptkonsole (Version1.20)
|
||||
|
||||
Der User priorisiert vollständige Shell-/PowerShell-Skripte über MCP/UI mit
|
||||
|
||||
@@ -1,6 +1,50 @@
|
||||
# Verbindliche Projektentscheidungen
|
||||
|
||||
Stand: **2026-11-14**, Spezifikation **1.20** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung.
|
||||
Stand: **2026-11-14**, Spezifikation **1.21** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung.
|
||||
|
||||
## Präzisierung des engen Updatervertrags (Version1.21)
|
||||
|
||||
Healthsignatur und vor Genehmigung gebundener lokaler öffentlicher Healthpin
|
||||
verwenden einen separat provisionierten Schlüssel; kein Jobsignerfallback.
|
||||
Auf Linux autorisiert und prüft Full den Updateowner. General bleibt während
|
||||
des Inflightfalls geschlossen, ohne aus Nichtzuständigkeit Unknown zu erzeugen.
|
||||
Keine Capabilitylockerung umgeht die tatsächliche Prozessimageprüfung.
|
||||
Native Dateiteilintents und Stop-/Startbeobachtungen gehören append-only an den
|
||||
Originalhandoff im selben Ledger. ReturnIntent und feste Startreservation
|
||||
committen vor Lockabgabe; keine Zeile erlaubt späteren Workerresume.
|
||||
Details und offene Runtimegrenzen stehen in Spezifikation0.1 und
|
||||
[agent-updater-handoff.md](agent-updater-handoff.md).
|
||||
|
||||
## Agent-Selbstupdate parallel, eng gebunden (Version1.21)
|
||||
|
||||
Auf ausdrücklichen Userwunsch wird ausschließlich der signierte Agentupdater
|
||||
parallel ausM7 vorgezogen. `update_agent` bleibt fester, tatsächlich WebUI-
|
||||
genehmigter Job mit `updates:apply` plus Root-/SYSTEM-Recht für beide Akteure,
|
||||
separatem immutable Releasekatalog und zwei gebundenen Rohbinaries. Altes
|
||||
Paketlimit bleibt bestehen; Update-only-Streaming ist keine allgemeine
|
||||
Installer-/Dateiupload-/Rootskriptfreigabe. Passive Beobachtung `agent.update`
|
||||
alle60s ist von Baseinventar und täglichem Releasecheck getrennt; fehlende
|
||||
Provisionierung/Qualifikation erzeugt `not_configured`, niemals Applybereitschaft.
|
||||
|
||||
Der verbindliche Handoff-/Owner-/Inflight-/Healthvertrag steht in Kapitel0.1.
|
||||
Atomarer Originalverbrauch+Start+Handoff+Delegation+Stopintent im erhaltenen
|
||||
Helperledger, echter gemeinsamer Lock nur während Helperstop, Rückgabe vor
|
||||
neuem Helperstart und exakter eigener Inflightabgleich bei Ready=false sind
|
||||
Pflicht. Kein zusätzlicher ungebundener Server-Journalslot oder Unknown-Healing.
|
||||
Die nur für diese Aktion signierte `agent_update_plan_id` erhält alte Grantbytes
|
||||
bei allen anderen Aktionen. Fullpins werden eng aus konkreten geschützten
|
||||
Rawbytes gerendert; zentrale Fullrechte werden nicht automatisch migriert.
|
||||
|
||||
Erste Baseline und erlaubtes Rollback müssen bereits die neue Update-/Handoff-
|
||||
Historie dekodieren können. Das aktuelle1.20-Codepaar ist daher kein späteres
|
||||
Rollbackziel. Erhaltender kompatibler Bootstrap, separat release-signierter
|
||||
InstalledRecord/Floor und tatsächliche Linux-first-Qualifikation sind vor dem
|
||||
ersten Apply erforderlich. Keine Daten-/PKI-/Generation-/Journalrücksetzung.
|
||||
|
||||
Quelle ist kein Applynachweis: isolierter Verifier/Handoffkernel und lokale
|
||||
OS-/SQL-/UIteile sind getrennt dokumentiert. Unabhängige Reviews und tatsächliche
|
||||
Messwerte stehen in den verlinkten Updaterberichten; Workerinstallation,
|
||||
genehmigter realer Codewechsel und Windowsnachweis bleiben eigene Gates.
|
||||
|
||||
## Skriptkonsole und vollständige Hostwartung (Version1.20)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user