Files
rust-discovery/docs/linux-updater-compatible-controllers.md
T
2026-11-16 15:25:46 +01:00

11 KiB

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.