175 lines
11 KiB
Markdown
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.
|