From fb2376443ca6cbd0747f05a2ed953ac8ee2b070f Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Wed, 18 Nov 2026 18:21:51 +0100 Subject: [PATCH] Document OTRS ARM64 root-script helper activation --- docs/development.md | 2 + ...linux-arm64-otrs-root-helper-20261118.json | 49 +++++++++++++++++++ docs/mvp-completion-plan.md | 2 +- 3 files changed, 52 insertions(+), 1 deletion(-) create mode 100644 docs/evidence/linux-arm64-otrs-root-helper-20261118.json diff --git a/docs/development.md b/docs/development.md index 9f2ee12..f70ceee 100644 --- a/docs/development.md +++ b/docs/development.md @@ -75,6 +75,8 @@ curl --fail --show-error --silent 'https://discovery.ease-technologies.de:8443/i 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. +Auf einem bereits aufgenommenen Linux-Gerät kann der gleiche HTTPS-Installer den Root-Skript-Helper nachträglich einrichten. Dazu `--enable-admin-scripts` verwenden. Der Installer übernimmt die vorhandene Geräteidentität. Für die WebUI muss die zentrale Geräteregel zusätzlich das berechtigte Konto und die authentisiert gemeldete Helper-Bindung enthalten. [Richtlinie und Berechtigungen](public-access.md#administrator-skripte-anfordern) + ## 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-otrs-root-helper-20261118.json b/docs/evidence/linux-arm64-otrs-root-helper-20261118.json new file mode 100644 index 0000000..29592ed --- /dev/null +++ b/docs/evidence/linux-arm64-otrs-root-helper-20261118.json @@ -0,0 +1,49 @@ +{ + "date": "2026-11-18", + "target": "otrs.ease-technologies.de", + "evidence_id": "linux-arm64-otrs-root-helper-20261118", + "source_revision": "4b3d0136e93e9b6d1de2ddaf3aae2cdade0dbb85", + "before": { + "managed_helper_unit": "not-found", + "root_script_capability": false + }, + "device": { + "platform": "aarch64-unknown-linux-gnu", + "version": "0.1.0-arm64.1", + "release_id": "8f9c1558-a9b6-4338-84a7-4cd376201879", + "agent_sha256": "67fac33df92bf88223c57d2c641518ce35fd7706f8d5031975b2227ad258c869", + "helper_binary_sha256": "8f64e88b11be8298fc216ccf827787a690419c9e9ebd948a9bd476f7a47dd5b6", + "helper_policy_sha256": "40da24bd6ad91817ab6e17e18a1ece89587d53a5bb2578bfd6281de727266deb", + "last_authenticated_contact": "2026-11-18T17:18:45.609656Z", + "connection_generation": 4, + "identity_preserved": true, + "services_active": true + }, + "server": { + "central_device_rule": true, + "release_anchor": true, + "planner_scope": "one existing WebUI account", + "server_roles_read_back": [ + "api", + "public-api", + "gateway" + ], + "helper_sync_ready": true, + "mcp_opt_in": false, + "approval_granted": false + }, + "preview": { + "public_webui_preview": "accepted", + "identity": "root", + "target_count": 1, + "counts": { + "plans": 1, + "approval_requests": 0, + "jobs": 0, + "outbox": 0, + "start_grants": 0 + }, + "testsimulation": false, + "approval_required": true + } +} diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index 7bd6af3..e96b8e6 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -28,7 +28,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 `Proxmox VE` als OS. Am 18. November wurde `c599baa` auf dem öffentlichen Server aktiviert. Der Serverrunner bestätigte API, Gateway und öffentlichen API-Dienst mit Binärhash `4f9c8c60…`. Der öffentliche WebUI-Index stimmte mit dem gebauten Bundle überein. Die unveränderten Geräteidentitäten meldeten nach regulärem signierten Update `virtual` auf Linux mit `0.1.0-mvp.7` um 16:45 UTC und Windows mit `0.1.17` um 16:47 UTC. Geräteliste, Details, Mobilansicht mit 390 px und Historie sind in der öffentlichen WebUI geprüft. Beide Pakete sind in Development A und B und als Starter für leere Kataloge veröffentlicht. Die Typen `physical` und `hypervisor` sind mit Testdaten geprüft. Die Feldabnahme auf einem physischen Gerät und einem Proxmox-VE-Host steht aus. [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) | +| 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) Auf OTRS ARM64 wurde der Root-Skript-Helper nachträglich mit dem HTTPS-Installer aktiviert. Die zentrale Geräteregel bindet das berechtigte WebUI-Konto an diese Installation und den signierten Helper. Die öffentliche WebUI-Vorschau akzeptierte Root für OTRS. Die Probe blieb bei einer Vorschau und erzeugte null Anträge, Jobs, Outbox-Einträge und Startgrants. [OTRS-Nachweis](evidence/linux-arm64-otrs-root-helper-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. OTRS ist mit Gerätezertifikat aufgenommen und meldet authentisierte Heartbeats. Die erste Kontaktprüfung wartet seit der Korrektur auf das Zertifikat. Der öffentliche Installer lief auf OTRS erneut ohne Traceback und ohne neuen Einmalcode. Der ARM64-Katalogabruf ist bestätigt. Ein späterer Versionswechsel auf ARM64 steht aus. [ARM64-Release](evidence/linux-arm64-installer-20261118.json) · [Geräteaufnahme und Nachtest](evidence/linux-arm64-enrollment-heartbeat-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) |