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

175 lines
11 KiB
Markdown

# 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.