Implement guarded Linux updater runtime and compatible baseline tooling
Rust development slice / linux (push) Failing after 8s
Rust development slice / linux (push) Failing after 8s
This commit is contained in:
@@ -0,0 +1,174 @@
|
||||
# Kompatibler Linux-Updater: konkrete administrative Controller
|
||||
|
||||
Stand 16. November 2026. Die nachstehenden Quellen sind vorbereitet und lokal
|
||||
geprüft. **Kein erhaltender Dienstwechsel, kein Signierschlüssel, kein neuer
|
||||
Updaterdienst und kein Updatejob wurden durch diese Vorbereitung auf einem Ziel
|
||||
ausgeführt.** Die Zielphasen koordiniert der Rootprozess; RMM-Aufträge brauchen
|
||||
weiterhin den tatsächlichen Weg MCP → `pending_approval` → WebUI → Originalgrant.
|
||||
|
||||
## Genau verwendbare Artefakte
|
||||
|
||||
Das unveränderte ursprüngliche Buildpack `21d20391-6102-4996-8a7a-efbd3e78bd7d`
|
||||
bleibt erhalten. Der neue Agent muss zusätzlich die beiden bereits bestehenden
|
||||
Domaincapabilities `agent.update.apply/1` und `agent.update.check/1` nach einem
|
||||
gültigen geschützten Fullobserver melden. Außerdem muss der bestehende
|
||||
60-Sekunden-Tick das fertige Observerergebnis vor seinem Capabilityvergleich
|
||||
abholen. Andernfalls wurde die alte Probe erst nach dem Vergleich geerntet und
|
||||
konnte beim nächsten Vergleich bereits älter als die erlaubten 90 Sekunden sein.
|
||||
Der Tickaufruf wurde verschoben, ohne Samplerate oder Gültigkeitsgrenze zu ändern.
|
||||
|
||||
Beide Änderungen sind in der eigenständigen Derivation
|
||||
`devstate/linux-updater-capability-build/9923a97f-4c8c-4e0a-bbad-4f1d88f0d43a`
|
||||
eingefroren. Manifest-SHA256:
|
||||
`a41ad700b4b7527bf911bf00f2745914188760c631af0c3255364c05f1ef4fbc`.
|
||||
Source0/Source1 verwenden unverändert 0.1.0/0.1.1.
|
||||
|
||||
| Artefakt | SHA256 |
|
||||
|---|---|
|
||||
| Source0 Agent | `7fef8d0f1e2bcf5cd6c373e567a0c17bfb08d8c780cd4d1925b6c1355e572547` |
|
||||
| Source1 Agent | `4d212066bef226af3fa679ffe95f69c43a9668cbef7e665d53328f4e41aa3799` |
|
||||
| Source0 Helper, unverändert aus 21D | `8fdc6ded02278eb18e64003d0bc7bf45d452cd48ded0450e6e900ca66e44d449` |
|
||||
| Source1 Helper, unverändert aus 21D | `89b28db3afe870c667297dff97ad7a042c550ccce1f712d69108e8de672ad450` |
|
||||
| Stabiler Updater, unverändert aus 21D | `dec6336728eac8af1e0d84d4921c7c9ecbcc45bc4619d357d346b716336be90a` |
|
||||
|
||||
Die Derivation verwendet einen eigenen kopierten Buildcache. Beide Agenten
|
||||
bestanden all-targets Clippy mit `-D warnings` und den Releasebuild im gepinnten
|
||||
Offlinebuilder. Alle 18 zuvor nativ geprüften Contractexecutables, Helper und
|
||||
Updater wurden nicht neu gebaut und ihre Originalhashes erneut verglichen.
|
||||
Der frühere reine Capabilitymarker-Fall `f89fbb79-…` bleibt historisch erhalten;
|
||||
er enthält die Tickkorrektur noch nicht und ist hier nicht die Baseline.
|
||||
|
||||
Der separate öffentliche Metadaten-SDK liegt im eingefrorenen Fall
|
||||
`devstate/linux-updater-bootstrap-sdk/d309c949-3a70-4448-88da-49c710093221`.
|
||||
Manifest-SHA256 `cf9464ff21b48b28903369692e3bb63148b2c488297ec709e8fd9c9881448528`,
|
||||
Binary-SHA256 `6fcc543d538fca30ceb499364880e4dc3689700d50597f18bd11bfe3559a0021`.
|
||||
Sein Worker-all-targets-Clippy und Releasebuild bestanden. Er schreibt keine
|
||||
Zieldateien und startet keine Dienste. Er rendert Full über die bestehenden
|
||||
Rusttypen, erzeugt kanonische öffentliche Manifest-/Record-/Policybytes und
|
||||
misst bei `qualify_pair`/`registry` ausschließlich die wirklichen Zielzeugen.
|
||||
Die Bundlecodecoperation kennzeichnet ausdrücklich nur die Formprüfung.
|
||||
|
||||
## Vorbereitete erhaltende Phasen
|
||||
|
||||
`deploy/linux_updater_compatible_apply.py` trennt folgende explizite Phasen;
|
||||
keine Fehlerantwort startet einen bereits begonnenen Schritt erneut:
|
||||
|
||||
1. `prepare`: Nur lesender Original-CAS auf der VM und lokale Paketvorbereitung.
|
||||
Diese Phase wurde tatsächlich ausgeführt. Der lokale Fall
|
||||
`devstate/linux-updater-compatible/ac6cf439-e0a6-4323-82e1-c55df96b2441`
|
||||
enthält `package.json`, den lesenden Vorbeleg und Manifest-SHA256
|
||||
`d3917236c03b93273b4f43f1df3b6773cc04873018262567d3d31510c993c082`.
|
||||
Es wurde noch kein Paket auf der VM bereitgestellt.
|
||||
2. `stage`: Ausschließlich create-only sieben feste geprüfte öffentliche
|
||||
Artefakte in einem neuen Root-700-Fallverzeichnis bereitstellen.
|
||||
3. `install`: Frischen geschlossenen zentralen Scope und null offene Jobs prüfen;
|
||||
echte Original-PIDs halten, Agent/General/Full stoppen, beide Originalflocks
|
||||
halten und alle ursprünglichen DB-Inodes/Start-/Outcomeaggregate bewahren.
|
||||
Vier feste Dateien mit create-only Vorgänger- und Kandidatennamen ersetzen.
|
||||
Alle drei Dienste bleiben danach gestoppt. Bei bestehendem Intent nur lesen.
|
||||
4. `units`: Den stabilen Updater und die feste Unit create-only installieren,
|
||||
Full-Override `Restart=no` vor der Registry bereitstellen, daemon-reload und
|
||||
tatsächlichen inaktiven Updater/Restartzustand prüfen. Keine Dienststarts.
|
||||
5. `start`: General, Full, Agent jeweils genau einmal starten. Das ist zunächst
|
||||
nur ein Dienststart, noch kein Baselinequalifikationsnachweis.
|
||||
6. `qualify`: Der SDK prüft echte PID/Birth/Image-/Unitzeugen und dieselbe frisch
|
||||
signierte normale Agent-/Helpersynchronisierung mit aktuellem NativeClock,
|
||||
unabhängig gepinnten öffentlichen Jobkeys und erhaltener History. Kein
|
||||
vergangener Clockwert und kein administrativer Ready-Ersatz. Die ausgegebene
|
||||
Qualifikation enthält `ready/helper_ready/unlock/job_authority=false`.
|
||||
7. `registry`: Die wirkliche feste 21-Unit-Schließung, etwaige Rollbacktimer,
|
||||
Host-/Namespaceidentitäten und tatsächliche Dateipins zweimal messen. Ein
|
||||
geladener APTdienst verlangt seinen vierten lokalen Servicepin, bleibt aber
|
||||
inaktiv/disabled und erhält keine neue APT-Laufzeitqualifikation.
|
||||
8. `trust`: Kanonische Form nativ mit dem SDK prüfen, Release- und separate
|
||||
Baselinesignatur über genau diese Bytes zusätzlich mit OpenSSL prüfen,
|
||||
aktuelle Artefakt-/Identitäts-/Registrybindungen vergleichen und die festen
|
||||
Trustdateien create-only anlegen. Private Originalkeys werden nur per
|
||||
Metadaten in die Retainedliste aufgenommen, niemals gelesen oder exportiert.
|
||||
9. `updater-start`: Nach vollständiger Trustinstallation den stabilen Dienst
|
||||
genau einmal starten und seinen echten gehaltenen PID/Imagezeugen prüfen.
|
||||
10. `passive-check`: Nur serverseitig lesen. Die wirkliche normale Agentmeldung
|
||||
muss weniger als 90 Sekunden alt sein, gültige Fullobserver-/Syncbezüge,
|
||||
den exakten Vorgänger/Updater/Policy/Keyring/Healthpin und die benötigten
|
||||
Runtimecapabilities enthalten. Es gibt keinen SQL-Schreibersatz für eine
|
||||
fehlende Capability. `readback` holt nach einem verlorenen Transport nur
|
||||
feste öffentliche Belege ab.
|
||||
|
||||
Der vorhandene Generalpin Schema 1 enthält ausdrücklich keinen Binarypin; der
|
||||
Produktcode verlangt hier `helper_binary_sha256=None`. Seine exakten Bytes und
|
||||
Policy bleiben erhalten. Das erlaubt keine Umdeutung des alten Pins zu einem
|
||||
Native-Abnahmenachweis für die neuen Helperbytes. Dafür ist Schritt 6 getrennt
|
||||
notwendig. Der alte APTproof bleibt unverändert und weiterhin geschlossen.
|
||||
|
||||
## Servertrust und Signieren
|
||||
|
||||
`deploy/updater_server_signing_bootstrap.py` ist ein separat aufzurufender
|
||||
Server-Rootbootstrap. Der reine Read `public-separation` wurde tatsächlich
|
||||
ausgeführt: Er las ausschließlich den bestehenden öffentlichen Timepin und
|
||||
verglich ihn mit dem unabhängig geschützten öffentlichen Jobkey. Timepin-Rawhash
|
||||
`c31d31d2d61f881d04f55f704abbbf98f4822650c016f39e39d4d2318bc3f6e2`;
|
||||
die beiden tatsächlichen Publickey-SHA256-Werte sind
|
||||
`1d9b8f83191a99d69b435dc69e8c9b52650680e8e02025f3e338e5083924def8` und
|
||||
`4338aabe7e7ba77428e969750a7a5323d7b7349aa52ef7e1a5f24c90be12ca7a`.
|
||||
Der Read erzeugte keine Schlüssel und änderte keinen Dienst. Der öffentliche
|
||||
Beleg und der noch nicht ausgeführte `signer-provision-input.json` liegen im
|
||||
lokalen kompatiblen Bootstrapfall `ac6cf439-…`.
|
||||
|
||||
`provision` erzeugt für Linux und Windows jeweils einen
|
||||
eigenen Release-/Baselineschlüssel. Der globale Healthschlüssel wird nur beim
|
||||
ersten Aufruf erzeugt und später ausschließlich nach unveränderter öffentlicher
|
||||
Provenienz und Schlüsselmetadaten wiederverwendet. Der Aufruf verlangt echte
|
||||
Job-/Zeit-Publickey-SHA256-Werte als Ausschlussliste; Rollenalias-IDs genügen
|
||||
nicht. Kein privater Schlüssel verlässt den Server oder erscheint im Output.
|
||||
|
||||
Releasekeys bleiben Root in 0700/0600. Der tatsächliche Server-Trustreader
|
||||
verlangt den bestehenden Jobkey-Dateiowner 10001 auch für Keyring/Healthdatei,
|
||||
Datei 0600/ein Link und geschützten Elternpfad. Deshalb erhält jede Plattform
|
||||
ein eigenes öffentliches Verzeichnis 10001/0700 mit `keyring.json` 0600.
|
||||
Dieses wird später read-only in API **und** Gateway gemountet; der separate
|
||||
Healthkey wird read-only ausschließlich in das Gateway gemountet. Der Container
|
||||
behält seine vorhandene UID und schreibgeschützte Root-FS. Private Releasekeys
|
||||
werden überhaupt nicht in Anwendungscontainer gemountet.
|
||||
|
||||
Neue statische Serverkonfiguration:
|
||||
|
||||
| Einstellung | Zweck |
|
||||
|---|---|
|
||||
| `RMM_AGENT_UPDATE_LINUX_KEYRING_FILE` | ausschließlich geschützter Linux-Keyring |
|
||||
| `RMM_AGENT_UPDATE_WINDOWS_KEYRING_FILE` | ausschließlich geschützter Windows-Keyring |
|
||||
| `RMM_AGENT_UPDATE_KEYRING_FILE` | unveränderter Legacyfallback, nur wenn der Plattformslot fehlt |
|
||||
| `RMM_AGENT_UPDATE_HEALTH_KEY_FILE` | separater Gateway-Healthsignierer |
|
||||
|
||||
Ein vom Netz empfangener Plattformenum wählt ausschließlich einen dieser zwei
|
||||
fest konfigurierten Pfade. Ein leerer/relativer expliziter Plattformslot wird
|
||||
verweigert. Danach gelten weiterhin sämtliche Signatur-, Plattform-, Revocation-,
|
||||
Generation- und Original-Rawhashprüfungen. Ein gemeinsamer Mehrplattformkeyring
|
||||
würde die bestehenden streng plattformgebundenen Clients nicht erfüllen;
|
||||
deshalb wird deren Trustvertrag nicht gelockert. Die beiden gezielten
|
||||
Serververträge bestanden mit echten lokalen Ed25519-Signaturen für beide
|
||||
Plattformen und negativen Kreuzkeyring-/Signatur-/Revocation-/Generation-/
|
||||
Rawhashfällen; Server-all-targets-Clippy bestand ebenfalls. Diese Quellen
|
||||
brauchen noch einen neuen, getrennt koordinierten ARM64-Imagebuild/Deploy.
|
||||
|
||||
`deploy/linux_updater_public_materials.py` verwendet den sealed SDK für
|
||||
`release-input`, `record-input`, `trust-package`. Es signiert nichts. Der Server
|
||||
signiert ausschließlich die zwei fest qualifizierten Linux-Codepaare und die
|
||||
Initialbaseline mit dem tatsächlichen Qualifikationshash. Ein Ausgabe-JSON ist
|
||||
keine lokale Vertrauensquelle. Die kanonischen Manifestcodec-Rundläufe für beide
|
||||
wirklichen Linux-Artefaktpaare und Python-Syntaxprüfung aller drei Controller
|
||||
bestanden lokal; dabei wurden weder Schlüssel noch Signaturen erzeugt.
|
||||
|
||||
Windows-GNU-Artefakte werden ausdrücklich nicht als kanonische Windows-MSVC-
|
||||
Releases signiert. Die tatsächliche MSVC-Qualifikation ist ein eigener offener
|
||||
Schritt. Das ändert weder das Linux-first-Gate noch einen Plattformvertrag.
|
||||
|
||||
## Danach noch tatsächlich abzunehmen
|
||||
|
||||
Die beschriebenen Zielphasen sind weiterhin auszuführen. Neue Servermounts,
|
||||
plattformbezogener Keyring, Gateway-Healthkey, enger Update-Denyscope und
|
||||
Tenantkatalog müssen anschließend konkret und mit erhaltenen Composepins
|
||||
bereitgestellt werden. Erst dann folgen der tatsächlich über MCP beantragte
|
||||
und in der WebUI genehmigte Linux-Updatejob, dessen Originalverbrauch,
|
||||
Codepaarwechsel, signierte Health und endgültiger Record/Floor sowie der
|
||||
bekannte geschlossene Fullstart-Fehlerfall mit erhaltender Rückführung. Lokale
|
||||
Codec-/Build-/Syntaxbelege ersetzen diese nativen Abnahmen nicht.
|
||||
Reference in New Issue
Block a user