From 663e846415f7df96db61490e6df7d6166fb6d1a8 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Wed, 18 Nov 2026 10:53:16 +0100 Subject: [PATCH] Ship Windows x64 through a separately signed official GNU release channel --- Cargo.lock | 2 +- Rust_RMM_Implementierungsspezifikation.md | 10 +++-- crates/agent-windows/Cargo.toml | 2 +- crates/server/src/agent_updates.rs | 54 ++++++++++++++++------- crates/server/src/bootstrap/install.ps1 | 2 +- crates/server/src/bootstrap/starter.rs | 10 ++++- deploy/server.public-access.compose.yaml | 4 +- deploy/server.releases.compose.yaml | 4 +- docs/development.md | 14 ++++-- docs/handover.md | 2 +- docs/mvp-completion-plan.md | 2 +- docs/project-decisions.md | 4 ++ tools/agent_release.py | 22 +++++++-- tools/dev_agent_release.py | 7 ++- tools/dev_customer_starters.py | 12 +++-- web/src/main.tsx | 4 +- 16 files changed, 110 insertions(+), 45 deletions(-) diff --git a/Cargo.lock b/Cargo.lock index 6d3bb0f..a560ff7 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -2213,7 +2213,7 @@ dependencies = [ [[package]] name = "rmm-agent-windows" -version = "0.1.0" +version = "0.1.11" dependencies = [ "anyhow", "base64 0.22.1", diff --git a/Rust_RMM_Implementierungsspezifikation.md b/Rust_RMM_Implementierungsspezifikation.md index e45062b..d229660 100644 --- a/Rust_RMM_Implementierungsspezifikation.md +++ b/Rust_RMM_Implementierungsspezifikation.md @@ -1,6 +1,6 @@ # Rust RMM: Architektur und Implementierungsspezifikation -Version 1.37 · 2026-11-17 · Sprache: Deutsch +Version 1.38 · 2026-11-18 · Sprache: Deutsch **Zweck:** Vollständige, eigenständig nutzbare Grundlage für die Implementierung einer mandantenfähigen Plattform zur Inventarisierung, Überwachung und Fernadministration von Kundengeräten durch eine Coding-KI und ein Entwicklungsteam. @@ -114,6 +114,10 @@ Minuten nach Empfang nutzbar (bisher 100 ms). Details Kapitel 0.3. ## 0 Auftrag und verbindliche Produktanforderungen +### 0.9 Offizieller Windows-Kanal (Version 1.38) + +Für Windows x64 wird `x86_64-pc-windows-gnu` als offizielles Ziel gebaut, signiert und vom HTTPS-Installer standardmäßig gewählt. Das veröffentlichte Agent-/Helperpaar und der stabile Updater stammen aus einem nachgewiesenen GNU-Build. Der offizielle Schlüssel ist vom Entwicklungsschlüssel getrennt. Alle Verwaltungs- und Geräteprozesse einer Installation verwenden denselben offiziellen Schlüsselring. Die native Abnahme umfasst Erstaufnahme, Ablehnung einer Entwicklungssignatur, automatisches Folgeupdate unter derselben Geräteidentität und einen genehmigten Skriptauftrag. MSVC bleibt ein optionales weiteres Buildziel. + ### 0.8 Skripte, Aufträge und Genehmigungen in der WebUI (Version 1.37) Die Geräteübersicht ist die Startseite. „Skripte“ veröffentlicht benannte Versionen pro Kunde. „Aufträge“ weist ein einmaliges Skript oder eine feste Bibliotheksversion ausgewählten Geräten eines Kunden zu, reicht den unveränderlichen Plan ein und zeigt den Verlauf und die Ergebnisse je Gerät. Die Auswahl im Gerätebestand kann in einen neuen Auftrag übernommen werden. Einreichungen lassen sich für denselben gespeicherten Plan idempotent fortsetzen. @@ -140,7 +144,7 @@ Der Betreiber hat die Löschung des als `closed_unknown` abgeschlossenen Entwick Nach einem abgeschlossenen temporären Windows-Wartungsfenster darf der Entwicklungsoperator eindeutig terminale lokale Arbeitsprojektionen mit ihren Nachweisen archivieren und die an dieses Fenster gebundene Helper-Zuordnung lösen. Vorbedingungen sind der geschlossene zentrale Scope, eine leere aktive Auftragsliste und die geprüfte Geräte-/Releasebindung. Serverseitige Ergebnisse bleiben erhalten. -Der dedizierte Produktgateway liefert Jobs ausschließlich in Antworten auf HTTPS-Anfragen des Geräts. Der Windows-GNU-Entwicklungsrelease trägt sein tatsächliches Buildziel `x86_64-pc-windows-gnu` und einen eigenen Signaturschlüssel. Der Windows-MSVC-Kanal ist separat adressiert. +Der dedizierte Produktgateway liefert Jobs ausschließlich in Antworten auf HTTPS-Anfragen des Geräts. Der damalige Windows-GNU-Entwicklungsrelease trägt sein tatsächliches Buildziel `x86_64-pc-windows-gnu` und einen eigenen Signaturschlüssel. Der Windows-MSVC-Kanal ist separat adressiert. Für die mitgelieferte PowerShell-Vorlage „Windows-Updates installieren“ darf der feste Plan ein längeres Ausführungsfenster bis 3600 Sekunden auswählen. Es gilt nur für die geprüften Originalbytes und die ausgewählte Bibliotheksrevision. Server- und Gerätescope müssen das längere Fenster ausdrücklich erlauben, und der Agent muss es unterstützen. Der engste der gesetzten Grenzwerte gilt. Das Ergebnis meldet den von Windows festgestellten Neustartbedarf. Ein Neustart ist ein eigener Wartungsauftrag. @@ -1448,7 +1452,7 @@ Das Repository MUSS einen Cargo-Workspace, eine Webanwendung, versionierte Migra Nicht jeder spätere Adapter muss sofort als leere Crate angelegt werden. Die erste Strecke erzeugt nur tatsächlich verwendete Module; die vorgegebenen Grenzen bleiben erhalten. `server-api`, `mcp-adapter` und `agent-gateway` dürfen keine parallelen Varianten derselben Fachlogik implementieren. -Erstes natives Linux-MVP-Buildziel ist `x86_64-unknown-linux-gnu`; `x86_64-pc-windows-msvc` folgt erst nach Linux-MVP-Abnahme. Noch später folgen `aarch64-pc-windows-msvc` und `aarch64-unknown-linux-gnu`. Abhängigkeiten und Installationspakete müssen jeweils zum Ziel passen. Der Linux-Build richtet sich nach der ältesten freigegebenen glibc-Basis. Cross-Compilation ist ein Buildnachweis; Dienststart, Installer und Betriebssystemintegration benötigen Tests auf dem tatsächlichen Ziel. Alle Features sind zuerst auf der tatsächlichen Linux-Test-VM nachzuweisen. +Erstes natives Linux-MVP-Buildziel ist `x86_64-unknown-linux-gnu`; `x86_64-pc-windows-gnu` ist nach Kapitel 0.9 das offizielle Windows-x64-Ziel. Noch später folgen `aarch64-pc-windows-msvc` und `aarch64-unknown-linux-gnu`. Abhängigkeiten und Installationspakete müssen jeweils zum Ziel passen. Der Linux-Build richtet sich nach der ältesten freigegebenen glibc-Basis. Cross-Compilation ist ein Buildnachweis; Dienststart, Installer und Betriebssystemintegration benötigen Tests auf dem tatsächlichen Ziel. Alle Features sind zuerst auf der tatsächlichen Linux-Test-VM nachzuweisen. `docs/platform-support.md` führt je Kombination Betriebssystemversion, Architektur, Buildstatus, native Abnahme, verfügbare Capabilities, PVE/PBS-Kompatibilität und gegebenenfalls RustDesk-Kompatibilität. „Geplant“, „Build erfolgreich“ und „freigegeben“ sind getrennte Angaben. diff --git a/crates/agent-windows/Cargo.toml b/crates/agent-windows/Cargo.toml index de52267..4615324 100644 --- a/crates/agent-windows/Cargo.toml +++ b/crates/agent-windows/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "rmm-agent-windows" -version.workspace = true +version = "0.1.11" edition.workspace = true license.workspace = true diff --git a/crates/server/src/agent_updates.rs b/crates/server/src/agent_updates.rs index e49bfea..61a090d 100644 --- a/crates/server/src/agent_updates.rs +++ b/crates/server/src/agent_updates.rs @@ -143,7 +143,7 @@ fn verifier_platform(platform: Platform) -> rmm_updater::Platform { Platform::WindowsGnuX64 => rmm_updater::Platform::WindowsGnuX64, } } -/// Network input can choose only one of two statically named protected +/// Network input can choose only among statically named protected /// configuration slots. It never supplies a path or introduces update trust. fn keyring_path_with( platform: Platform, @@ -152,7 +152,19 @@ fn keyring_path_with( let name = match platform { Platform::LinuxX64 => "RMM_AGENT_UPDATE_LINUX_KEYRING_FILE", Platform::WindowsX64 => "RMM_AGENT_UPDATE_WINDOWS_KEYRING_FILE", - Platform::WindowsGnuX64 => "RMM_AGENT_UPDATE_WINDOWS_GNU_KEYRING_FILE", + Platform::WindowsGnuX64 => { + // The shared device gateway and both management APIs must select the same + // official trust. A legacy development key is usable only in isolated dev. + let official = "RMM_AGENT_UPDATE_WINDOWS_GNU_OFFICIAL_KEYRING_FILE"; + if let Some(path) = lookup(official)? { + return FsPath::new(&path).is_absolute().then(|| path.into()) + .ok_or_else(|| fail("AGENT_UPDATE_NOT_CONFIGURED")); + } + if lookup("RMM_PROFILE")?.as_deref() != Some("development") { + return Err(fail("AGENT_UPDATE_NOT_CONFIGURED")); + } + "RMM_AGENT_UPDATE_WINDOWS_GNU_KEYRING_FILE" + } }; if let Some(path) = lookup(name)? { if path.is_empty() || !FsPath::new(&path).is_absolute() { @@ -162,6 +174,9 @@ fn keyring_path_with( } // Exact legacy compatibility only when the platform-specific slot is // absent. An invalid explicit slot must never silently choose other trust. + if platform == Platform::WindowsGnuX64 { + return Err(fail("AGENT_UPDATE_NOT_CONFIGURED")); + } lookup("RMM_AGENT_UPDATE_KEYRING_FILE")? .map(Into::into) .ok_or_else(|| fail("AGENT_UPDATE_NOT_CONFIGURED")) @@ -171,21 +186,6 @@ pub fn verify_envelope( binding: Option<&rmm_domain::agent_update::UpdaterBinding>, ) -> Result { let platform = envelope.decode().map_err(|_| invalid())?.manifest.platform; - if platform == Platform::WindowsGnuX64 - && std::env::var("RMM_PROFILE").as_deref() != Ok("development") - { - return Err(fail("AGENT_UPDATE_DEVELOPMENT_CHANNEL_REQUIRED")); - } - verify_signed_envelope(envelope, platform, binding) -} - -// The public management process can copy an operator-selected release into an empty -// catalog. Network-supplied publications additionally go through the profile check above. -fn verify_signed_envelope( - envelope: &ReleaseEnvelope, - platform: Platform, - binding: Option<&rmm_domain::agent_update::UpdaterBinding>, -) -> Result { let raw = keyring_bytes(platform)?; verify_envelope_with_keyring( envelope, @@ -1075,6 +1075,21 @@ mod tests { FsPath::new("legacy-relative.json") ); } + let dev_only = BTreeMap::from([ + ("RMM_AGENT_UPDATE_WINDOWS_GNU_KEYRING_FILE", "/trust/dev.json"), + ("RMM_AGENT_UPDATE_KEYRING_FILE", "/trust/legacy.json"), + ]); + assert!(choose(Platform::WindowsGnuX64, &dev_only).is_err()); + let mut mixed = dev_only; + mixed.insert("RMM_PROFILE", "development"); + assert_eq!(choose(Platform::WindowsGnuX64, &mixed).unwrap(), FsPath::new("/trust/dev.json")); + mixed.insert("RMM_AGENT_UPDATE_WINDOWS_GNU_OFFICIAL_KEYRING_FILE", "/trust/official.json"); + for profile in ["development", "production"] { + mixed.insert("RMM_PROFILE", profile); + assert_eq!(choose(Platform::WindowsGnuX64, &mixed).unwrap(), FsPath::new("/trust/official.json")); + } + mixed.insert("RMM_AGENT_UPDATE_WINDOWS_GNU_OFFICIAL_KEYRING_FILE", ""); + assert!(choose(Platform::WindowsGnuX64, &mixed).is_err()); let only_linux = BTreeMap::from([("RMM_AGENT_UPDATE_LINUX_KEYRING_FILE", "/trust/linux.json")]); assert!(choose(Platform::WindowsX64, &only_linux).is_err()); @@ -1155,6 +1170,11 @@ mod tests { }; (envelope, keys) }; + let (official, official_keys) = make(Platform::WindowsGnuX64); + let (development, _) = make(Platform::WindowsGnuX64); + let official_ring = encode(&official_keys).unwrap(); + assert!(verify_envelope_with_keyring(&official, None, &official_ring, 100).is_ok()); + assert!(verify_envelope_with_keyring(&development, None, &official_ring, 100).is_err()); let (linux, linux_keys) = make(Platform::LinuxX64); let (windows, windows_keys) = make(Platform::WindowsX64); let linux_raw = encode(&linux_keys).unwrap(); diff --git a/crates/server/src/bootstrap/install.ps1 b/crates/server/src/bootstrap/install.ps1 index 5676dba..a25a88e 100644 --- a/crates/server/src/bootstrap/install.ps1 +++ b/crates/server/src/bootstrap/install.ps1 @@ -5,7 +5,7 @@ param( [Parameter(Mandatory)][Uri]$BootstrapBase, [Security.SecureString]$EnrollmentToken, [ValidateSet('x86_64-pc-windows-msvc','x86_64-pc-windows-gnu')] - [string]$Platform = 'x86_64-pc-windows-msvc' + [string]$Platform = 'x86_64-pc-windows-gnu' ) $ErrorActionPreference = 'Stop' Set-StrictMode -Version Latest diff --git a/crates/server/src/bootstrap/starter.rs b/crates/server/src/bootstrap/starter.rs index 3d12ebf..18eb03d 100644 --- a/crates/server/src/bootstrap/starter.rs +++ b/crates/server/src/bootstrap/starter.rs @@ -42,7 +42,13 @@ pub(super) async fn publish_missing( if exists { continue; } - let path = distribution.join(format!("{name}.json")); + let path = if platform == Platform::WindowsGnuX64 + && std::env::var_os("RMM_AGENT_UPDATE_WINDOWS_GNU_OFFICIAL_KEYRING_FILE").is_some() + { + distribution.join(format!("{name}-official.json")) + } else { + distribution.join(format!("{name}.json")) + }; if !path .try_exists() .map_err(|_| fail("STARTER_CONFIGURATION"))? @@ -64,7 +70,7 @@ pub(super) async fn publish_missing( continue; } let package: Starter = serde_json::from_slice(&protected_file(&path, 65536)?)?; - let manifest = verify_signed_envelope(&package.envelope, platform, None)?; + let manifest = verify_envelope(&package.envelope, None)?; if manifest.platform != platform { return Err(invalid()); } diff --git a/deploy/server.public-access.compose.yaml b/deploy/server.public-access.compose.yaml index 55ca888..76ea228 100644 --- a/deploy/server.public-access.compose.yaml +++ b/deploy/server.public-access.compose.yaml @@ -22,10 +22,10 @@ services: RMM_AGENT_UPDATE_ARTIFACT_DIR: /release-objects RMM_AGENT_UPDATE_LINUX_KEYRING_FILE: /release-config/linux-keyring.json RMM_AGENT_UPDATE_WINDOWS_KEYRING_FILE: /release-config/windows-keyring.json - RMM_AGENT_UPDATE_WINDOWS_GNU_KEYRING_FILE: /release-config/windows-gnu-keyring.json + RMM_AGENT_UPDATE_WINDOWS_GNU_OFFICIAL_KEYRING_FILE: /release-config/windows-gnu-official-keyring.json RMM_AGENT_BOOTSTRAP_LINUX_FILE: /release-config/linux-bootstrap.json RMM_AGENT_BOOTSTRAP_WINDOWS_FILE: /release-config/windows-bootstrap.json - RMM_AGENT_BOOTSTRAP_WINDOWS_GNU_FILE: /release-config/windows-gnu-bootstrap.json + RMM_AGENT_BOOTSTRAP_WINDOWS_GNU_FILE: /release-config/windows-gnu-official-bootstrap.json ports: ["127.0.0.1:18445:18443"] volumes: - ../devstate/api-pki:/pki:ro diff --git a/deploy/server.releases.compose.yaml b/deploy/server.releases.compose.yaml index cc24f96..3b9dbe9 100644 --- a/deploy/server.releases.compose.yaml +++ b/deploy/server.releases.compose.yaml @@ -4,8 +4,8 @@ x-release-environment: &release-environment RMM_AGENT_UPDATE_WINDOWS_KEYRING_FILE: /release-config/windows-keyring.json RMM_AGENT_BOOTSTRAP_LINUX_FILE: /release-config/linux-bootstrap.json RMM_AGENT_BOOTSTRAP_WINDOWS_FILE: /release-config/windows-bootstrap.json - RMM_AGENT_UPDATE_WINDOWS_GNU_KEYRING_FILE: /release-config/windows-gnu-keyring.json - RMM_AGENT_BOOTSTRAP_WINDOWS_GNU_FILE: /release-config/windows-gnu-bootstrap.json + RMM_AGENT_UPDATE_WINDOWS_GNU_OFFICIAL_KEYRING_FILE: /release-config/windows-gnu-official-keyring.json + RMM_AGENT_BOOTSTRAP_WINDOWS_GNU_FILE: /release-config/windows-gnu-official-bootstrap.json services: api: diff --git a/docs/development.md b/docs/development.md index 0dcd87d..299a2e1 100644 --- a/docs/development.md +++ b/docs/development.md @@ -9,11 +9,11 @@ Die Befehle werden im Repository ausgeführt. Der [Buildrunner](../tools/build.p | Ziel | Befehl | Ergebnis | | --- | --- | --- | | Linux-Client x86-64 | `python3 tools/build.py linux-x64` | Agent, privilegierter Helper und stabiler Updater | -| Windows-Client x86-64, Entwicklung | `python3 tools/build.py windows-gnu-x64` | Windows-GNU-Agent, SYSTEM-Helper und stabiler Windows-Updater. | +| Offizieller Windows-Client x86-64 | `python3 tools/build.py windows-gnu-x64` | Windows-GNU-Agent, SYSTEM-Helper und stabiler Windows-Updater. | | Server ARM64 vom Notebook | `python3 tools/build.py server-arm64 --ssh` | Überträgt den Runner und ausgewählte Quellen des Git-Commits per geprüftem SSH. Baut Server und Zeitbroker im separaten Bereich `~/rmm-dev-build/server-arm64/` auf dem nativen ARM64-Host. Ausgabe enthält Remote-Pfad und Hashes. | | Server ARM64 direkt auf einem passenden Linux-Buildhost | `python3 tools/build.py server-arm64` | Serverbinary für API/Gateway und Zeitbroker. Der lokale Modus erwartet Git-Checkout, gepinnten ARM64-Builder, Docker, Python 3, git, tar und rsync. | | WebUI | `npm --prefix web run build` | TypeScript-Prüfung und Vite-Bundle in `web/dist/`. Im frischen Checkout zuerst `npm --prefix web ci` ausführen. | -| Windows-Binaries nativ mit MSVC | Vorhandenen [MSVC-Runner und Voraussetzungen](../deploy/windows/msvc/README.md) verwenden. | Geplant, nicht ausgeführt. Eigener Preflight und Build auf passendem Windows-Builder. Der GNU-Weg ist für schnelle Iteration auf dem Gast vorgesehen. | +| Windows-Binaries nativ mit MSVC | Vorhandenen [MSVC-Runner und Voraussetzungen](../deploy/windows/msvc/README.md) verwenden. | Geplant, nicht ausgeführt. Eigener Preflight und Build auf passendem Windows-Builder. Optionales zusätzliches Buildziel. | Der lokale Runner gibt den **konkreten Artefaktordner** aus. Unter `devstate/build//artifacts///` liegen die Binaries und `manifest.json` mit Quellrevision, Zielarchitektur, Builder und SHA-256. Ausgelieferte Binärdateien immer am Hash identifizieren: Zwei Builds aus demselben Commit können unterschiedliche Bytes haben. Ein Build erstellt noch keinen signierten Produktrelease. @@ -55,7 +55,7 @@ Die früheren Entwicklungsprotokolle einschließlich der alten Notebook-/Reverse ## Signierte Agentversion im Entwicklungsmandanten veröffentlichen -Der Buildordner enthält das in der Buildquittung gebundene Agent-/Helperpaar und den stabilen Bootstrap-Updater. Ein Linux-Build benötigt `rmm-agent`, `rmm-privileged-helper` und `rmm-agent-updater`. Auf Windows heißen die Dateien `rmm-agent-windows.exe`, `rmm-helper-windows.exe` und `rmm-updater-windows.exe`. Beim GNU-Entwicklungsbuild den Updater mitbauen. Der Katalog führt Linux GNU, Windows MSVC und Windows GNU als getrennte Ziele. Windows GNU ist auf dem Entwicklungsserver freigeschaltet. +Der Buildordner enthält das in der Buildquittung gebundene Agent-/Helperpaar und den stabilen Bootstrap-Updater. Ein Linux-Build benötigt `rmm-agent`, `rmm-privileged-helper` und `rmm-agent-updater`. Auf Windows heißen die Dateien `rmm-agent-windows.exe`, `rmm-helper-windows.exe` und `rmm-updater-windows.exe`. Der GNU-Build enthält den stabilen Updater. Der Katalog führt Linux GNU, Windows MSVC und Windows GNU als getrennte Ziele. Für offizielle Windows-Pakete den eigenen Signierschlüssel verwenden. ```bash python3 tools/dev_agent_release.py \ @@ -100,3 +100,11 @@ Der [Operatorablauf](windows-update-dev-window.md) beschreibt die Einrichtung de ## Öffentliche Verwaltung `tools/dev_public_access.py` provisioniert den lokalen Passwort-/TOTP-Zugang, startet die zusätzliche API intern und aktiviert den vorhandenen öffentlichen TLS-Ingress. Die tatsächlichen Befehle und die privaten Dateipfade stehen im [Betriebsablauf](public-access.md). Der normale Deploymentrunner aktualisiert anschließend auch den öffentlichen API-Dienst. + + +## Offizielle Windows-Veröffentlichung + +1. `python3 tools/build.py windows-gnu-x64 --ref REVISION` erzeugt das Agent-/Helperpaar, den stabilen Updater und die Buildquittung. +2. `python3 tools/dev_agent_release.py --official-windows --artifacts ORDNER --build-receipt ORDNER/manifest.json --sequence NUMMER --version VERSION --minimum-updater-version 2 --prepare-only` bindet die Binärhashes an den separaten Schlüssel auf dem Signierhost. Die Sequenz muss größer als die letzte im Zielkatalog sein. Schlüssel und Konfiguration liegen in den getrennten Slots `windows-gnu-official`. Nur die öffentlichen Prüfmaterialien werden in die Serverprozesse eingebunden. +3. Auf dem Entwicklungsserver denselben Aufruf ohne `--prepare-only` für Development A verwenden. Für weitere Kunden die signierten Artefakte über die reguläre Katalog-API mit der Berechtigung des Zielkunden veröffentlichen. `tools/agent_release.py publish --help` beschreibt den Login mit lokalem Konto und TOTP. Bei einer Workerrotation den bisherigen Hash angeben. +4. `python3 tools/dev_customer_starters.py --official-windows --tenant UUID --platform x86_64-pc-windows-gnu --release RELEASE_UUID` veröffentlicht den gewählten Starter für neue Kunden. Befüllte Kataloge benötigen ihren eigenen Import. Bestehende Entwicklungsinstallationen besitzen einen anderen lokalen Schlüsselring. Die erstmalige Umstellung erfolgt über eine geprüfte Neuaufnahme oder eine separat autorisierte lokale Vertrauensmigration. diff --git a/docs/handover.md b/docs/handover.md index e307f73..fc6e14d 100644 --- a/docs/handover.md +++ b/docs/handover.md @@ -4,7 +4,7 @@ **Lieferstand am 18. November 2026.** Lieferbranch `codex/webui-review`, API und Gateway auf Revision `a0b3aa4`, WebUI auf `6d4f53d`, Datenbankschema 35. WebUI und MCP sind unter `https://discovery.ease-technologies.de:8443/` beziehungsweise `/mcp` erreichbar. Die WebUI verwendet das lokale Passwort-/TOTP-Konto, MCP eigene scoped Bearer-Tokens. Die private Bootstrapdatei für die Einrichtung liegt unter `credentials/public-webui-login.json`. Öffentlicher dev/test-Login und OAuth sind deaktiviert. [Öffentliche Abnahme](public-access.md) -Die Windows-Test-VM läuft mit `0.1.9`. Nach dem Geräteabgleich und dem Neustart des Gateways lieferte der einmal genehmigte PowerShell-Auftrag „Geräteabgleich geprüft“ mit Exitcode 0. Auf Linux lief unter `0.1.0-mvp.4` auch die Bibliotheksrevision „Linux-Kernelversion“ erfolgreich. Beide Ergebnisse sind in der öffentlichen WebUI sichtbar. Die Rechtekorrekturen und SQLite 3.54.1 sind bereitgestellt. Der öffentliche Windows-MSVC-Kanal und der ältere Starterbestand in Development B sind im [Lieferplan](mvp-completion-plan.md) ausgewiesen. [Abnahme und laufende Komponenten](evidence/windows-release-blockers-20261118.json) +Die Windows-Test-VM läuft mit `0.1.9`. Nach dem Geräteabgleich und dem Neustart des Gateways lieferte der einmal genehmigte PowerShell-Auftrag „Geräteabgleich geprüft“ mit Exitcode 0. Auf Linux lief unter `0.1.0-mvp.4` auch die Bibliotheksrevision „Linux-Kernelversion“ erfolgreich. Beide Ergebnisse sind in der öffentlichen WebUI sichtbar. Die Rechtekorrekturen und SQLite 3.54.1 sind bereitgestellt. Der Betreiber hat GNU als öffentliches Windows-Ziel gewählt. Abnahme und Starterbestand in Development B sind im [Lieferplan](mvp-completion-plan.md) ausgewiesen. [Abnahme und laufende Komponenten](evidence/windows-release-blockers-20261118.json) Die Skriptbibliothek lässt sich nach Name und Plattform filtern. Die Kopfzeile zeigt den Kunden auch beim Seitenwechsel und übernimmt in einer Detailansicht den zugehörigen Kunden. Gerätebestand und Genehmigungseingang kennzeichnen ihre eigenen kundenübergreifenden Filter. Die öffentliche Sichtprüfung um 09:28 Uhr MEZ umfasste Development A und B sowie Desktop und Mobil. [Nachweis](evidence/webui-script-catalog-context-20261118.json) diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index 0913af4..e3663b0 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -103,7 +103,7 @@ Der erste Windows-Versuch unter `0.1.8` endete nach dem Abbruch durch die WebUI Schema 35 und der bereitgestellte Server prüfen die Berechtigung von Planersteller, tatsächlichem Einreicher und Genehmiger für ihre jeweilige Rolle. Sensible gespeicherte Logausgaben und historische Logergebnisse ohne Schutzklasse erfordern zusätzlich `logs:read_sensitive`. Auf beiden VMs stimmen die Hashes von Agent, Helper und stabilem Updater mit den geprüften Buildartefakten mit SQLite 3.54.1 überein. Auf Linux läuft der Updatetimer wieder. [Native Nachweise und WebUI-Ergebnisse](evidence/windows-release-blockers-20261118.json) -**Verteilstand.** Development A und der Starter für neue Kundenkataloge enthalten die korrigierten Pakete. Development B hat keine eingeschriebenen Geräte und einen bereits initialisierten Katalog mit den älteren Paketen. Die private Veröffentlichungsanmeldung ist auf Development A beschränkt. Für einen öffentlichen Windows-Produktivrelease fehlt ein qualifiziertes Paket im vorgesehenen MSVC-Kanal. Die zehn Windows-Pakete im geprüften Katalog gehören zum GNU-Entwicklungskanal. +**Verteilstand.** Development A und der Starter für neue Kundenkataloge enthalten die korrigierten Pakete. Development B hat keine eingeschriebenen Geräte und einen bereits initialisierten Katalog mit den älteren Paketen. Die private Veröffentlichungsanmeldung ist auf Development A beschränkt. Die zehn damaligen Windows-Pakete gehörten zum GNU-Entwicklungskanal. Am 18. November wurde GNU als offizielles Windows-x64-Ziel beschlossen. Der nächste Schritt ist die native Abnahme des getrennt signierten offiziellen Kanals. ### Wiederanlauf nach frühem Abbruch — nativ abgenommen diff --git a/docs/project-decisions.md b/docs/project-decisions.md index 2f98712..20ab056 100644 --- a/docs/project-decisions.md +++ b/docs/project-decisions.md @@ -2,6 +2,10 @@ Stand: **2026-11-17**, Spezifikation **1.37** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung. +## Offizieller Windows-x64-Release (Version 1.38, 18. November 2026) + +Der Betreiber hat GNU für den öffentlichen Windows-Kanal gewählt. Der Linux-Entwicklungsrechner baut alle drei Windows-Binaries. Der Windows-Gast dient der nativen Abnahme. Offizielle und Entwicklungsmanifeste führen dasselbe tatsächliche Ziel und verwenden getrennte Ed25519-Schlüssel. Das Installationsskript wählt GNU. MSVC bleibt optional. Eine bestehende lokale Entwicklungsvertrauensstellung erfordert eine bewusste Migration. Die Neukopplung und die Löschung der alten Kopplung auf der Windows-Test-VM wurden ausdrücklich freigegeben. + ## Bedienwege für Skriptaufträge (Version 1.37) Bibliotheksarbeit, Gerätezuweisung und die abschließende Entscheidung haben eigene Reiter. Die Bibliotheksversion wird beim Planen gebunden. Für Einreichungen aus WebUI und MCP gilt derselbe Genehmigungseingang mit Prüfung je Kunde. „Aufträge“ zeigt Ergebnis und Ausgabe je Gerät. [Bedienung und Abnahme](mvp-completion-plan.md) diff --git a/tools/agent_release.py b/tools/agent_release.py index 6410f6a..85c0742 100755 --- a/tools/agent_release.py +++ b/tools/agent_release.py @@ -126,6 +126,13 @@ def https(value): return url +def release_label(platform, official_windows): + if official_windows: + check(platform == WINDOWS_GNU, 'official Windows releases require a GNU x64 build receipt') + return 'windows-gnu-official' + return {LINUX: 'linux', WINDOWS: 'windows', WINDOWS_GNU: 'windows-gnu'}[platform] + + def prepare(args): provision_folder(args.state) provision_folder(args.state/'private') @@ -141,7 +148,7 @@ def prepare_locked(args): check(minimum in (1,2), 'unknown minimum updater version') check(0 < args.days <= 3650, 'invalid validity in days') platform, blobs = binaries(args.artifacts, args.build_receipt) - label = {LINUX:'linux', WINDOWS:'windows', WINDOWS_GNU:'windows-gnu'}[platform] + label = release_label(platform, getattr(args, 'official_windows', False)) check(minimum == 1 or platform == WINDOWS_GNU, 'version 2 currently applies to the GNU Windows worker') provision_folder(args.state) config, private = args.state / 'config', args.state / 'private' @@ -288,14 +295,19 @@ def publish(args): check(bool(args.rotate_bootstrap_from) == bool(args.bootstrap_state), 'rotation needs previous SHA and local signing state') check(not (args.rotate_bootstrap_from and args.bootstrap_worker), 'a rotation uses the new receipt-bound stable worker') client = Publisher(args.origin, args.ca) - if args.dev_login_file: + if args.local_username: + login = {'username': args.local_username, 'password': getpass.getpass('WebUI password: '), + 'totp_code': getpass.getpass('Authenticator code: ')} + elif args.dev_login_file: path = args.dev_login_file check(path.stat().st_mode & 0o077 == 0, 'dev login file requires private permissions') credentials = json.loads(path.read_bytes()) login = {k: credentials[k] for k in ('username','password')} else: login = {'username': args.dev_username, 'password': getpass.getpass('Development WebUI password: ')} - client.request('POST', '/auth/dev/login', encoded(login), {'Content-Type': 'application/json'}) + route = '/auth/local/login' if args.local_username else '/auth/dev/login' + client.request('POST', route, encoded(login), {'Content-Type': 'application/json'}) + client.headers['X-RMM-Tenant'] = str(uuid.UUID(args.tenant)) session = client.request('GET', '/auth/session') client.headers['X-CSRF-Token'] = session['csrf_token'] try: @@ -319,7 +331,7 @@ def publish(args): check(result['sha256'] == blob['sha256'] and result['size_bytes'] == blob['bytes'], 'artifact receipt differs') if args.rotate_bootstrap_from: stable = blobs[-1] - label = {LINUX:'linux', WINDOWS:'windows', WINDOWS_GNU:'windows-gnu'}[platform] + label = release_label(platform, getattr(args, 'official_windows', False)) rotate_pin(args.bootstrap_state,label,tenant,args.rotate_bootstrap_from, {'sha256':stable['sha256'],'bytes':stable['bytes']}) if worker_only: @@ -340,6 +352,7 @@ def main(): for name, fn in (('prepare', prepare), ('publish', publish)): cmd = sub.add_parser(name) cmd.set_defaults(run=fn) + cmd.add_argument('--official-windows', action='store_true', help='Use the dedicated Windows GNU production signing key and bootstrap state') cmd.add_argument('--artifacts', type=Path, required=True) cmd.add_argument('--build-receipt', type=Path, required=True) if name == 'prepare': @@ -360,6 +373,7 @@ def main(): cmd.add_argument('--envelope', type=Path, help='Prepared agent and helper release') cmd.add_argument('--rotate-worker-only', action='store_true', help='Rotate the stable worker independently of a code-pair release') auth = cmd.add_mutually_exclusive_group(required=True) + auth.add_argument('--local-username', help='Sign in with the public WebUI password and a fresh TOTP code') auth.add_argument('--dev-username') auth.add_argument('--dev-login-file', type=Path) args = parser.parse_args() diff --git a/tools/dev_agent_release.py b/tools/dev_agent_release.py index 44c9b5d..80898fd 100755 --- a/tools/dev_agent_release.py +++ b/tools/dev_agent_release.py @@ -52,6 +52,8 @@ def on_server(options): if hashlib.sha256(dest.read_bytes()).hexdigest() != digest: raise ValueError('staged slot already contains different build: ' + name) inputs = ['--artifacts', str(build), '--build-receipt', str(build / options['receipt'])] + if options['official']: + inputs.append('--official-windows') if not options['worker_only']: subprocess.run(['python3', '-I', str(tool), 'prepare', *inputs, '--state', str(state), '--gateway', options['gateway'], '--service-uid','10001','--minimum-updater-version',str(options['minimum']),'--sequence',str(options['sequence']),'--version',options['version']],check=True) @@ -128,6 +130,7 @@ def main(): parser.add_argument('--rotate-worker-only',action='store_true',help='Publish just the stable worker from its build receipt and rotate its tenant pin') parser.add_argument('--gateway',default='https://discovery.ease-technologies.de') parser.add_argument('--tenant',default='11111111-1111-4111-8111-111111111111') + parser.add_argument('--official-windows',action='store_true',help='Sign with the separate official Windows GNU key') parser.add_argument('--prepare-only',action='store_true') args=parser.parse_args() if args.rotate_worker_only: @@ -144,8 +147,8 @@ def main(): params={'files':{f.name:hashlib.sha256(f.read_bytes()).hexdigest() for f in files},'tool':hashlib.sha256(tool.read_bytes()).hexdigest(), 'receipt':args.build_receipt.name,'sequence':args.sequence,'version':args.version,'tenant':args.tenant, 'worker_only':args.rotate_worker_only,'worker_sha':descriptors[-1]['sha256'], - 'minimum':args.minimum_updater_version,'rotate':args.rotate_bootstrap_from,'gateway':args.gateway,'prepare_only':args.prepare_only,'label':{agent_release.LINUX:'linux', - agent_release.WINDOWS:'windows',agent_release.WINDOWS_GNU:'windows-gnu'}[platform]} + 'minimum':args.minimum_updater_version,'rotate':args.rotate_bootstrap_from,'gateway':args.gateway,'prepare_only':args.prepare_only,'official':args.official_windows, + 'label':agent_release.release_label(platform,args.official_windows)} subprocess.run([sys.executable,str(ROOT/'tools/dev_stage.py'),'server',*map(str,files),str(tool)],check=True) command=inspect.getsource(on_server)+'\non_server('+repr(params)+')\n' subprocess.run([*ssh_prefix('server'),shlex.join(['python3','-I','-'])],input=command,text=True,check=True) diff --git a/tools/dev_customer_starters.py b/tools/dev_customer_starters.py index 01aac8c..4b81633 100644 --- a/tools/dev_customer_starters.py +++ b/tools/dev_customer_starters.py @@ -15,10 +15,14 @@ import uuid from dev_stage import ssh_prefix -def publish(tenant, platform, release, *, root=Path('/opt/rust-discovery/devstate/mvp-releases'), +def publish(tenant, platform, release, official_windows=False, *, root=Path('/opt/rust-discovery/devstate/mvp-releases'), database_container='rust-discovery-server-postgres-1', service_uid=10001): labels = {'x86_64-pc-windows-gnu': 'windows-gnu', 'x86_64-unknown-linux-gnu': 'linux'} label = labels[platform] + if official_windows: + if platform != 'x86_64-pc-windows-gnu': + raise ValueError('Official Windows starter requires GNU x64') + label = 'windows-gnu-official' source = root / 'objects' / tenant config = root / 'config' dest = config / 'customer-starters' @@ -71,7 +75,8 @@ def publish(tenant, platform, release, *, root=Path('/opt/rust-discovery/devstat if not stat.S_ISREG(info.st_mode) or info.st_size!=size: raise ValueError('Missing regular package file') write(digest,iter(lambda:f.read(1024*1024),b'')) - write(platform+'.json',[json.dumps(desc,separators=(',',':')).encode()]) + descriptor = platform + ('-official.json' if official_windows else '.json') + write(descriptor,[json.dumps(desc,separators=(',',':')).encode()]) directory_fd = os.open(dest, os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW) try: os.fsync(directory_fd) @@ -84,10 +89,11 @@ def main(): parser=argparse.ArgumentParser(description=__doc__) parser.add_argument('--tenant',required=True,type=uuid.UUID) parser.add_argument('--platform',required=True,choices=['x86_64-unknown-linux-gnu','x86_64-pc-windows-gnu']) + parser.add_argument('--official-windows',action='store_true') parser.add_argument('--release',required=True,type=uuid.UUID) args=parser.parse_args() imports='import hashlib,json,os,re,stat,subprocess,tempfile\nfrom pathlib import Path\n' - script=imports+inspect.getsource(publish)+'\npublish'+repr((str(args.tenant),args.platform,str(args.release))) + script=imports+inspect.getsource(publish)+'\npublish'+repr((str(args.tenant),args.platform,str(args.release),args.official_windows)) subprocess.run([*ssh_prefix('server'),'python3 -I -'],input=script,text=True,check=True) diff --git a/web/src/main.tsx b/web/src/main.tsx index d2ff000..6729ea2 100644 --- a/web/src/main.tsx +++ b/web/src/main.tsx @@ -259,8 +259,8 @@ function DeviceEnrollment({ tenantId, auth, customerName }: { tenantId: string; {copied &&

Einmalcode wurde kopiert.

} {enrollment.origin && enrollment.platforms.includes('x86_64-unknown-linux-gnu') && <>

Linux, mit einem Administratorkonto ausführen

{`curl --fail --show-error --silent '${enrollment.origin}/install/linux.sh' -o linux.sh && sudo sh linux.sh '${enrollment.origin}'`}
} - {enrollment.origin && ['x86_64-pc-windows-msvc','x86_64-pc-windows-gnu'].filter(p => enrollment.platforms.includes(p)).map(platform => -

Windows {platform.endsWith('-gnu') ? 'GNU (Entwicklungsrelease)' : 'MSVC'}, in einer administrativen Windows PowerShell ausführen

+ {enrollment.origin && ['x86_64-pc-windows-gnu','x86_64-pc-windows-msvc'].filter(p => enrollment.platforms.includes(p)).map(platform => +

Windows {platform.endsWith('-gnu') ? 'x64 (GNU)' : 'x64 (MSVC)'}, in einer administrativen Windows PowerShell ausführen

{`Invoke-WebRequest -UseBasicParsing '${enrollment.origin}/install/windows.ps1' -OutFile .\\windows.ps1
 .\\windows.ps1 -BootstrapBase '${enrollment.origin}' -Platform '${platform}'`}
)} }