From bfdc3da8afb21e2cc8122ac189fc1c5e7b89cc4a Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Wed, 18 Nov 2026 18:07:31 +0100 Subject: [PATCH] Record native ARM64 HTTPS release and installer verification --- Rust_RMM_Implementierungsspezifikation.md | 2 +- crates/agent/src/agent_update_catalog.rs | 3 +- crates/updater/tests/release_contract.rs | 30 ++++++- docs/development.md | 17 +++- .../linux-arm64-installer-20261118.json | 82 +++++++++++++++++++ docs/mvp-completion-plan.md | 2 +- tests/browser/order-composer.spec.ts | 5 +- 7 files changed, 132 insertions(+), 9 deletions(-) create mode 100644 docs/evidence/linux-arm64-installer-20261118.json diff --git a/Rust_RMM_Implementierungsspezifikation.md b/Rust_RMM_Implementierungsspezifikation.md index c072877..90ef907 100644 --- a/Rust_RMM_Implementierungsspezifikation.md +++ b/Rust_RMM_Implementierungsspezifikation.md @@ -38,6 +38,6 @@ Für administrative Skripte gilt zusätzlich das Plattformrecht `root:execute` o Die WebUI erzeugt einen kundengebundenen Einmalcode und zeigt die HTTPS-Installationsanleitung für die verfügbare Plattform. Zum Erstbezug braucht das Gerät eine vertrauenswürdige TLS-Verbindung. Der Installer prüft Vertrauensmaterial und Release, richtet die lokalen Dienste ein und nimmt das Gerät auf. Anschließend verwendet die Installation ihre eigene Identität. Der lokale Administrator richtet den privilegierten Skript-Helper ein, wenn das Gerät auch Administratoraufträge erhalten soll. [Serverseitiger Bootstrap](crates/server/src/bootstrap) -Der Server stellt je Kunde und Plattform Agent und Helper mit einem gemeinsam signierten Manifest bereit. Das Manifest bindet die Hashes und Größen der Binärdateien. Für die Erstaufnahme liefert der Server auch den passenden Bootstrap-Updater. Linux x64 verwendet den GNU/Linux-Kanal, Windows x64 offiziell `x86_64-pc-windows-gnu`. Der lokale Updater fragt regelmäßig nach einer neueren veröffentlichten Generation, prüft die Bindung an Plattform, Schlüsselring, Releasefolge und Binärhashes und aktiviert das geprüfte Paar unter derselben Geräteidentität. Auf Linux steuert ein systemd-Timer den Abruf, auf Windows ein eigener Updatedienst. +Der Server stellt je Kunde und Plattform Agent und Helper mit einem gemeinsam signierten Manifest bereit. Das Manifest bindet die Hashes und Größen der Binärdateien. Für die Erstaufnahme liefert der Server auch den passenden Bootstrap-Updater. Das gemeinsame Linux-Installationsskript erkennt x86-64 und ARM64 auf dem Zielgerät. Beide GNU/Linux-Architekturen haben einen eigenen Releasekanal, Signierschlüssel und Bootstrap-Pin. Windows x64 verwendet offiziell `x86_64-pc-windows-gnu`. Der lokale Updater fragt regelmäßig nach einer neueren veröffentlichten Generation, prüft die Bindung an Plattform, Schlüsselring, Releasefolge und Binärhashes und aktiviert das geprüfte Paar unter derselben Geräteidentität. Auf Linux steuert ein systemd-Timer den Abruf, auf Windows ein eigener Updatedienst. Für Erstinstallation und Update muss das Manifest zum Prüfzeitpunkt gültig sein. Beim bereits installierten Administrator-Helper prüft der Server die Gültigkeit zum gespeicherten Registrierungszeitpunkt des Releases und die Signatur gegen den aktuellen Schlüsselring. Der Ablauf des Manifests allein blockiert daher keinen Adminauftrag auf diesem Client. [Releaseprüfung](crates/server/src/agent_updates.rs) · [Build und Veröffentlichung](docs/development.md) diff --git a/crates/agent/src/agent_update_catalog.rs b/crates/agent/src/agent_update_catalog.rs index 4e8173f..bda32ec 100644 --- a/crates/agent/src/agent_update_catalog.rs +++ b/crates/agent/src/agent_update_catalog.rs @@ -532,7 +532,8 @@ async fn fetch(client: &reqwest::Client, address: SocketAddr) -> Result> crate::https_channel::bounded_body(response, RESPONSE_LIMIT, "application/json").await } -#[cfg(test)] +// These fixtures provision the legacy x86-64 manual updater profile. +#[cfg(all(test, target_arch = "x86_64"))] mod tests { use super::*; use base64::{Engine, engine::general_purpose::URL_SAFE_NO_PAD}; diff --git a/crates/updater/tests/release_contract.rs b/crates/updater/tests/release_contract.rs index 97356ce..f5022b3 100644 --- a/crates/updater/tests/release_contract.rs +++ b/crates/updater/tests/release_contract.rs @@ -66,11 +66,18 @@ fn manifest() -> ReleaseManifest { } fn verify_bytes(payload: &[u8], context: &TrustedContext) -> anyhow::Result { + verify_bytes_with_key(payload, context, key(false, 1, 20)) +} + +fn verify_bytes_with_key( + payload: &[u8], + context: &TrustedContext, + pinned: TrustedUpdateKey, +) -> anyhow::Result { let signer = SigningKey::from_bytes(&[41; 32]); let mut message = RELEASE_SIGNATURE_DOMAIN.to_vec(); message.extend_from_slice(payload); let signature = signer.sign(&message).to_bytes(); - let pinned = key(false, 1, 20); let key_id = pinned.key_id().to_owned(); verify_release( SignedRelease { @@ -166,7 +173,7 @@ fn signed_noncanonical_unknown_duplicate_and_oversize_payloads_are_rejected() { payload.replacen("{", "{\"schema_version\":1,", 1), payload.replacen("\"bytes\":11", "\"bytes\":11,\"path\":\"/etc/passwd\"", 1), payload.replacen("\"release_sequence\":4", "\"release_sequence\":4.0", 1), - payload.replacen("x86_64-unknown-linux-gnu", "aarch64-unknown-linux-gnu", 1), + payload.replacen("x86_64-unknown-linux-gnu", "riscv64gc-unknown-linux-gnu", 1), ] { assert!(verify_bytes(changed.as_bytes(), &context()).is_err()); } @@ -174,6 +181,25 @@ fn signed_noncanonical_unknown_duplicate_and_oversize_payloads_are_rejected() { assert!(verify_bytes(b"", &context()).is_err()); } +#[test] +fn arm64_release_requires_arm64_context_and_key() { + let mut target = manifest(); + target.platform = Platform::LinuxArm64; + let mut context = context(); + assert!(verify(&target, &context).is_err()); + context.platform = Platform::LinuxArm64; + assert!(verify(&target, &context).is_err()); + let arm64_key = TrustedUpdateKey::new( + SigningKey::from_bytes(&[41; 32]).verifying_key().to_bytes(), + Platform::LinuxArm64, + 1, + 20, + false, + ).unwrap(); + let payload = serde_json::to_vec(&target).unwrap(); + assert!(verify_bytes_with_key(&payload, &context, arm64_key).is_ok()); +} + #[test] fn incompatible_clock_platform_state_protocol_and_trust_contexts_are_rejected() { let mut ctx = context(); diff --git a/docs/development.md b/docs/development.md index d679e9d..f7bad0d 100644 --- a/docs/development.md +++ b/docs/development.md @@ -5,11 +5,12 @@ Der Buildrunner verpackt die Quellen eines eingecheckten Git-Stands und baut mit | Ziel | Befehl | Ergebnis | | --- | --- | --- | | Linux-Client x86-64 | `python3 tools/build.py linux-x64 --ref REVISION` | `rmm-agent`, `rmm-privileged-helper`, `rmm-agent-updater` | +| Linux-Client ARM64 | `python3 tools/build.py linux-arm64 --ssh --ref REVISION` | `rmm-agent`, `rmm-privileged-helper`, `rmm-agent-updater` für AArch64 | | Offizieller Windows-Client x64 | `python3 tools/build.py windows-gnu-x64 --ref REVISION` | `rmm-agent-windows.exe`, `rmm-helper-windows.exe`, `rmm-updater-windows.exe` für GNU | | Server auf dem dedizierten ARM64-Host | `python3 tools/build.py server-arm64 --ssh --ref REVISION` | Server und Linux-Zeitbroker im Remote-Buildbereich | | WebUI | `npm --prefix web run build` | TypeScript-Prüfung und Bundle in `web/dist/` | -`--plan` zeigt den Rust-Build einschließlich Quellenrevision und Ziel an. Der Runner verwendet je Ziel einen gemeinsamen Cargo-Cache, lädt bei Bedarf die gesperrten Abhängigkeiten und kompiliert offline. Er meldet den konkreten Ausgabeordner. Lokal liegt er unter `devstate/build//artifacts///`, beim SSH-Build unter `~/rmm-dev-build/server-arm64/artifacts/` auf dem Server. Die Buildquittung `manifest.json` bindet Ziel, Git-Revision, Builder und Binärhashes. +`--plan` zeigt den Rust-Build einschließlich Quellenrevision und Ziel an. Der Runner verwendet je Ziel einen gemeinsamen Cargo-Cache, lädt bei Bedarf die gesperrten Abhängigkeiten und kompiliert offline. Er meldet den konkreten Ausgabeordner. Lokal liegt er unter `devstate/build//artifacts///`, beim SSH-Build unter `~/rmm-dev-build//artifacts/` auf dem Server. Die Buildquittung `manifest.json` bindet Ziel, Git-Revision, Builder und Binärhashes. ## Entwicklungsserver und WebUI aktualisieren @@ -45,7 +46,7 @@ python3 tools/dev_agent_release.py --official-windows \ --minimum-updater-version 2 --prepare-only ``` -Für Linux gilt derselbe Ablauf mit dem Linux-Buildordner und ohne `--official-windows`. Die Mindestversion entsprechend der vom Paket benötigten Updaterfähigkeit setzen. Der offizielle Windows-Kanal nutzt einen eigenen Signierschlüssel. Private Signierschlüssel verbleiben auf dem Signierhost. +Für Linux gilt derselbe Ablauf mit dem Linux-Buildordner und ohne `--official-windows`. Die Mindestversion entsprechend der vom Paket benötigten Updaterfähigkeit setzen. Der offizielle Windows-Kanal nutzt einen eigenen Signierschlüssel. Linux x86-64 und ARM64 haben ebenfalls getrennte Signierschlüssel, Starter und Updater-Pins. Private Signierschlüssel verbleiben auf dem Signierhost. Für die Erstaufnahme in neuen Kundenkatalogen kann der Betreiber einen veröffentlichten Release als Starter auswählen. Die Quelle wird anhand ihrer Kunden-, Plattform- und Release-ID geprüft. Bereits befüllte Kataloge werden je Kunde gepflegt. [Starter veröffentlichen](../tools/dev_customer_starters.py) @@ -54,8 +55,20 @@ python3 tools/dev_customer_starters.py --tenant "$TENANT_ID" \ --platform x86_64-pc-windows-gnu --official-windows --release "$RELEASE_ID" ``` +Für ARM64 beim Starter `--platform aarch64-unknown-linux-gnu` verwenden und `--official-windows` weglassen. Die beiden Release-Overlays für den Server und die öffentliche API binden den ARM64-Schlüsselring und den Bootstrap-Pin ein. + Ein neuer stabiler Updater benötigt eine eigene Rotation des Bootstrap-Hashes. `--rotate-worker-only --rotate-bootstrap-from SHA256` bindet die Umstellung im Zielkunden an den bisherigen Hash. Für den gezielten lokalen Austausch des stabilen Windows-Updaters im Entwicklungsbetrieb prüft der PowerShell-Operator beide Hashes, die Geräteidentität und die installierten Releasepaare. [Releasewerkzeuge](../tools/agent_release.py) · [Windows-Updater austauschen](../deploy/windows/Replace-DevelopmentReleaseUpdater.ps1) +## Linux-Gerät per HTTPS aufnehmen + +Unter **Verwaltung → Geräteaufnahme** den Kunden wählen und einen Einmalcode erstellen. Den gemeinsamen Linux-Befehl auf dem Zielgerät ausführen. `linux.sh` erkennt `x86_64` und `aarch64` und wählt den passenden signierten Agenten, Helper und Updater. + +```sh +curl --fail --show-error --silent 'https://discovery.ease-technologies.de:8443/install/linux.sh' -o linux.sh && sudo sh linux.sh 'https://discovery.ease-technologies.de:8443' --enable-admin-scripts +``` + +Den Einmalcode auf Nachfrage eingeben. Bei direkter Root-Anmeldung entfällt `sudo`. `--enable-admin-scripts` aktiviert den lokalen Skript-Helper. Zusätzliche zentrale Geräterechte und die WebUI-Genehmigung gelten pro Auftrag. + ## Ergebnis prüfen Die folgenden Rust-Tests laufen lokal mit Testidentitäten. Die Transporttests starten einen TLS-Server auf Loopback. diff --git a/docs/evidence/linux-arm64-installer-20261118.json b/docs/evidence/linux-arm64-installer-20261118.json new file mode 100644 index 0000000..d294595 --- /dev/null +++ b/docs/evidence/linux-arm64-installer-20261118.json @@ -0,0 +1,82 @@ +{ + "date": "2026-11-18", + "native_host": "otrs.ease-technologies.de", + "source": { + "client_revision": "247646a2ba74abe4f2d42a2c712e3d3166fd2187", + "server_revision": "6d15f1b3f524c11923ec1a5daba1c1903ff63a27", + "build_receipt_sha256": "35ee5c49744970e140f3e3156980e7dca950eb88a3346e92b8e497fe16265df7", + "maximum_required_glibc": "2.34" + }, + "deployment": { + "database_schema": 40, + "server_sha256": "5681a387a1cdfe459185106e9bdf61c47103472a9051db4396262721d9d0a7eb", + "public_web_index_sha256": "7486a20e0e570c8059d75be7b847ee35a39680d7bfa93498a8a9d26e6e3c4f87", + "api_and_gateway_health": "ok", + "manifest_sha256": "d0f548d0d0a0c0e29e706089d958928d8e48cea29e61e52637be01938dd5df45", + "arm64_customer_starter_published": true, + "existing_devices_after_deploy": [ + { + "platform": "linux-x86-64", + "version": "0.1.0-mvp.7", + "authenticated_contact_at": "2026-11-18T17:05:50.996252Z" + }, + { + "platform": "windows-x64", + "version": "0.1.17", + "authenticated_contact_at": "2026-11-18T17:05:33.93606Z" + } + ] + }, + "public_https_native_probe": { + "machine": "aarch64", + "os": "Ubuntu 22.04.5 LTS", + "glibc": "glibc 2.35", + "origin": "https://discovery.ease-technologies.de:8443", + "installer_sha256": "f22a93fb33021f49ed9d9e56b89d040751c9505313611c73fd1490b1d0618c61", + "tenant_id": "11111111-1111-4111-8111-111111111111", + "release_id": "8f9c1558-a9b6-4338-84a7-4cd376201879", + "sequence": 1, + "version": "0.1.0-arm64.1", + "platform": "aarch64-unknown-linux-gnu", + "artifacts": [ + { + "artifact_id": "2b8efd81-ed48-5d13-92b0-b5e0fdca49ac", + "bytes": 14786512, + "role": "agent", + "sha256": "67fac33df92bf88223c57d2c641518ce35fd7706f8d5031975b2227ad258c869" + }, + { + "artifact_id": "bb4e1fb2-02fa-561c-993c-5c4792493a9a", + "bytes": 13055264, + "role": "helper", + "sha256": "8f64e88b11be8298fc216ccf827787a690419c9e9ebd948a9bd476f7a47dd5b6" + } + ], + "updater": { + "bytes": 8755912, + "sha256": "3a3c272c59fd59ee8b994288372531f9bfb92b7174e31f71bd107542ec044934" + }, + "published_platforms": [ + "aarch64-unknown-linux-gnu", + "x86_64-pc-windows-gnu", + "x86_64-unknown-linux-gnu" + ], + "x86_64_version": "0.1.0-mvp.7", + "native_checks": { + "installer_shell_syntax": true, + "invalid_code_stopped_before_install": true, + "manifest_and_pair_signature": true, + "modified_agent_rejected": true, + "wrong_platform_artifact_http_status": 404, + "missing_code_http_status": 401, + "enrollment_performed": false, + "all_three_elf_images_started_with_help": true + } + }, + "passed_tests": { + "linux_installer": 13, + "release_contract_native_arm64": 10, + "webui_unit": 78, + "webui_enrollment_chromium": 1 + } +} diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index 72f15ef..ed67208 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -29,7 +29,7 @@ Alle acht Versuche lieferten Exitcode 0. Bei beiden Neustarts wurde die Wiederan | Öffentliche Verwaltung und Kundengrenzen | HTTPS-WebUI mit Passwort/TOTP, MCP mit widerrufbarem Token. Gerätebestand, Historie, eingeschränkter und kundenübergreifender Zugriff sowie Widerruf sind geprüft. [Öffentlicher Zugang](evidence/public-access-20261117.json) · [Kunden und Geräte](evidence/customer-fleet-20261117.json) | | Gerätetyp in der Übersicht | Spalte „Type“ nach „Hostname“ mit `physical`, `virtual` und `hypervisor`. Erkannte Proxmox-VE-Hosts zeigen zusätzlich `Proxmox VE` als OS. [Inventarprojektion](../crates/server/src/devices.rs) · [Geräteansicht](../web/src/devices.tsx) | | Von der Auswahl zur Ausgabe | Die WebUI bindet die ausgewählte Skriptversion, zeigt den Inhalt vor Genehmigung und verlinkt das Ergebnis je Gerät. Ein abgelehnter Antrag erzeugte null Jobs. [Auftragsablauf](evidence/webui-auftragsablauf-20261117.json) · [Ergebnislinks und Entscheidungen](evidence/webui-order-history-20261118.json) | -| Frische Installation und periodisches Agentupdate | Beide VMs wurden über HTTPS aufgenommen und übernahmen anschließend ein signiertes Folgepaket mit derselben Geräteidentität. Auf Windows ist der öffentliche GNU-Kanal einschließlich Prüfung des offiziellen Schlüssels belegt. [Linux](evidence/linux-public-installer-update-20261117.json) · [Windows GNU](evidence/windows-gnu-official-vm-20261118.json) | +| Frische Installation und periodisches Agentupdate | Beide VMs wurden über HTTPS aufgenommen und übernahmen anschließend ein signiertes Folgepaket mit derselben Geräteidentität. Auf Windows ist der öffentliche GNU-Kanal einschließlich Prüfung des offiziellen Schlüssels belegt. [Linux](evidence/linux-public-installer-update-20261117.json) · [Windows GNU](evidence/windows-gnu-official-vm-20261118.json). ARM64 erweitert denselben HTTPS-Installer mit automatischer Architekturerkennung. Release `0.1.0-arm64.1` ist veröffentlicht und als Starter verfügbar. Auf Ubuntu 22.04.5 ARM64 wurden die öffentlichen Downloads, die Signaturprüfung, die Ablehnung einer veränderten Agentdatei und der native Start aller drei Dateien im Prüfmodus beobachtet. Die permanente Geräteaufnahme und ein späterer Versionswechsel auf ARM64 stehen aus. [ARM64](evidence/linux-arm64-installer-20261118.json) | | Betriebssystemupdate per PowerShell | Die Windows-Updatevorlage installierte KB890830 v5.147 als SYSTEM. Ergebnis und Windows-Ereignis 19 bestätigen die Installation. [Installationsbeleg](evidence/windows-update-installation-20261117.json) | | Wiederanlauf | Nach einem Gatewaywechsel wurde der Windows-Agent ohne manuellen Dienstneustart wieder bereit. Der Helper glich seine bereits quittierte Ergebnismeldung ab. [Gatewaywechsel](evidence/windows-gateway-clock-recovery-20261117.json) · [Helper-Abgleich](evidence/windows-helper-result-recovery-20261118.json) | diff --git a/tests/browser/order-composer.spec.ts b/tests/browser/order-composer.spec.ts index 95db2be..ec19030 100644 --- a/tests/browser/order-composer.spec.ts +++ b/tests/browser/order-composer.spec.ts @@ -165,7 +165,7 @@ test('shows the execution stop and prepares the Windows restart through a versio expect(writes).toHaveLength(2); }); -test('offers local admin opt-in on both installer commands and keeps the one-time code outside commands', async ({ page }) => { +test('offers one Linux command for x86-64 and ARM64 and keeps the code outside both installer commands', async ({ page }) => { const token = 'f'.repeat(64), api = '/api/v1/tenants/' + tenantId; const requests: string[] = []; await page.route(origin + '/auth/config', r => r.fulfill({ json: { dev_login_enabled: true, oidc_configured: false, oidc_login_url: null } })); @@ -176,7 +176,7 @@ test('offers local admin opt-in on both installer commands and keeps the one-tim if (url.pathname === '/api/v1/tenants') return r.fulfill({ json: listing(auth.tenants) }); if (url.pathname === api + '/enrollment-tokens') return r.fulfill({ json: { token, expires_at: new Date(Date.now() + 900000).toISOString(), bootstrap_origin: 'https://bootstrap.example', - release_platforms: ['x86_64-unknown-linux-gnu', 'x86_64-pc-windows-gnu'] + release_platforms: ['x86_64-unknown-linux-gnu', 'aarch64-unknown-linux-gnu', 'x86_64-pc-windows-gnu'] } }); return r.fulfill({ json: { ...listing([]), pending_count: 0 } }); }); @@ -185,6 +185,7 @@ test('offers local admin opt-in on both installer commands and keeps the one-tim const option = enroll.getByRole('checkbox', { name: /Administratorskripte/ }); await expect(option).not.toBeChecked(); await enroll.getByRole('button', { name: 'Einmalcode erstellen' }).click(); + await expect(enroll.getByRole('heading', { name: 'Linux (x86-64 und ARM64)' })).toBeVisible(); const commands = enroll.locator('pre'); await expect(commands).toHaveCount(2); expect((await commands.allTextContents()).join(' ')).not.toMatch(/enable-admin-scripts|EnableAdministratorScripts/);