From 8a315706eadf11ed04b9eefbf468b2ceb2bf5890 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Sat, 14 Nov 2026 09:21:05 +0100 Subject: [PATCH] Record narrowly approved PowerShell process policy and Windows bootstrap scope --- Rust_RMM_Implementierungsspezifikation.md | 34 ++++++- docs/development.md | 22 ++++- docs/handover.md | 17 +++- docs/project-decisions.md | 27 +++++- docs/windows-powershell-policy.md | 105 ++++++++++++++++++++++ 5 files changed, 201 insertions(+), 4 deletions(-) create mode 100644 docs/windows-powershell-policy.md diff --git a/Rust_RMM_Implementierungsspezifikation.md b/Rust_RMM_Implementierungsspezifikation.md index 2e9ae28..77a1b72 100644 --- a/Rust_RMM_Implementierungsspezifikation.md +++ b/Rust_RMM_Implementierungsspezifikation.md @@ -1,6 +1,6 @@ # Rust RMM: Architektur und Implementierungsspezifikation -Version 1.17 · 2026-11-14 · Sprache: Deutsch +Version 1.18 · 2026-11-14 · 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. @@ -15,6 +15,13 @@ Version 1.17 · 2026-11-14 · Sprache: Deutsch lokaler Helperpolicy präzisiert. Keine Vererbung von Linux-Rootrechten, keine Windowsfähigkeit aus einer bloßen Quellen-/Build-/Linux-Unitqualifikation. +1.17 → 1.18 (2026-11-14): Ausdrückliche Userfreigabe für die feste, vor der +WebUI-Genehmigung sichtbare RemoteSigned-Option je Windows-PowerShell5.1- +Jobprozess, gezieltes Starten des bestehenden W32Time ohne Konfigurationsänderung +und einen erst später abgestimmten manuellen VM-Konsolenneustart präzisiert. +Keine Maschinen-/GPO-Policyänderung, kein Remote-/RMM-Reboot und keine daraus +abgeleitete Clock-/Capability-Abnahme. + 1.16 → 1.17 (2026-11-14): Dauerhafter SYSTEM-Delegationsintent und enges deny-only Abandon mit Originalgrant, unabhängiger Helper-Lineage und vollständiger Snapshotbindung präzisiert. Mehrdeutige Übergaben bleiben Unknown; keine @@ -109,6 +116,31 @@ Deploymentdaten, offene Konfiguration und reale Nachweise: ### 0.1 Auftrag an die implementierende KI +**Ausdrückliche Userentscheidungen Version1.18 — begrenzte Windowsfreigaben:** +Für jeden zuvor mit seinem unveränderlichen Plan in der WebUI genehmigten +Windows-PowerShell5.1-Jobprozess darf die feste Option `RemoteSigned` ausschließlich +im Prozesskontext gesetzt werden. Diese konkrete Option und ihr Prozessumfang +müssen bereits vor der Genehmigung sichtbar und im festen Aktions-/Jobpayload +hash-/signaturgebunden sein; kein nachträglicher Executor-Default oder stiller +Fallback. Der Executor verändert dafür weder Maschinen-, CurrentUser- noch +Gruppenrichtlinien und setzt weder `Bypass` noch `Unrestricted`. GPO-Vorgaben +bleiben vorrangig; eine Blockade wird unverfälscht berichtet. Es entsteht keine +SYSTEM-/Root-Shellberechtigung. Alte Pläne, Jobbytes und Grants werden nicht +umgeschrieben. Umsetzungsvorschlag und offene native Nachweise: +`docs/windows-powershell-policy.md`. + +Der vorhandene Windows-Zeitdienst `W32Time` darf gezielt gestartet werden. +Startart, NTPserver/Peers, ACLs und sonstige Zeitkonfiguration bleiben dabei +unverändert; keine impliziten Updates oder zusätzlichen Neustarts. Running ist +kein Nachweis einer vertrauenswürdigen Uhr: tatsächliche lokale Status-/Boot-/ +Unsicherheitsnachweise und alle bisherigen Clock-/Syncgrenzen bleiben nötig. +Ein manueller Neustart des Windowsgasts über dessen VM-Konsole ist erst später +nach ausdrücklicher zeitlicher Abstimmung mit dem User vorgesehen. Diese +Zustimmung erlaubt keinen Remote-Reboot, keinen RMM-Reboottest und erzeugt +keinen Rebootjob-Abnahmenachweis. Dokumentierte Freigaben sind keine bereits +ausgeführten Schritte. Neue Capabilities werden erst nach ihrer getrennten +nativen Qualifikation eröffnet. + **Technische Präzisierung Version 1.17 — Nichtstart vor SYSTEM-Delegation:** Vor jeder Socketübergabe bindet ein dauerhafter Intent die unveränderten Originalrequest-/Job-/Grant-/Signaturbytes, Plan/Autorisierung, Gerät und diff --git a/docs/development.md b/docs/development.md index e8e8c27..4af9fae 100644 --- a/docs/development.md +++ b/docs/development.md @@ -1,6 +1,6 @@ # Linux-first-Entwicklung und reale VM-Abnahme -Stand: 2026-11-14 · Spezifikation 1.17. Das begrenzte Linux-MVP ist inzwischen +Stand: 2026-11-14 · Spezifikation 1.18. Das begrenzte Linux-MVP ist inzwischen dokumentiert abgenommen; aktuelle Nachweise stehen in [handover.md](handover.md). Die getrennte Windows-SYSTEM-Grenze ist in Spezifikation0.1 und [windows-system-policy.md](windows-system-policy.md) präzisiert; Quellen-/Build- @@ -17,6 +17,26 @@ Deploymentnachweise: [server-deployment.md](server-deployment.md). Die folgenden PC-Server-/Reverse-Tunnel-Abläufe und Nachweise sind historisch. TLS/mTLS, Credentialschutz, Linux-first und WebUI-Plangenehmigung gelten weiter. +## Begrenzte Windowsfreigaben (2026-11-14) + +Der User erlaubt `RemoteSigned` ausschließlich je zuvor WebUI-genehmigtem +Windows-PowerShell5.1-Jobprozess. Die feste Option muss vor der Genehmigung im +unveränderlichen Plan sichtbar und in den Originaljobbytes gebunden sein. +Keine Maschinen-/CurrentUser-/GPO-Policyänderung durch den Executor, kein +Bypass-/Unrestricted-Fallback und kein nachträgliches Ändern alter Pläne. +Quellenstand und nötige Linux-first-/Windowsnachweise: +[windows-powershell-policy.md](windows-powershell-policy.md). Die laufende +gemeinsame Quellen-/Upgradequalifikation wird für diesen Entwurf nicht verändert. + +Der vorhandene `W32Time` darf gezielt gestartet werden; Startart, NTPserver/Peers +und ACLs bleiben unverändert. Anschließend sind tatsächliche lokale Uhrqualität, +Unsicherheit und Bootbindung zu prüfen. Running allein öffnet kein Clockgate. +Ein manueller VM-Konsolenneustart ist erst später nach ausdrücklicher zeitlicher +Abstimmung mit dem User vorgesehen. Kein Remote-Reboot oder RMM-Reboottest; +ein solcher manueller Neustart ist kein genehmigter RMM-Reboot-Erfolgsnachweis. +Notebookhost weiterhin ausschließlich Entwicklung. Dieser Abschnitt dokumentiert +Erlaubnis und offene Nachweise, keine hier ausgeführten Zielaktionen. + ## Ergänzende Userfreigabe und lokale Browserprüfung (2026-11-12) Der User hat temporären Testdienst, harmloses Testpaket, systemd-Agent, einen VM-Reboot diff --git a/docs/handover.md b/docs/handover.md index d7be299..1479235 100644 --- a/docs/handover.md +++ b/docs/handover.md @@ -2,7 +2,7 @@ **M0–M5 sind im vereinbarten begrenzten dev/test-Umfang vollständig nachgewiesen.** Linuxabschluss unter Spezifikation1.15; aktueller Gesamtvertrag -ist1.17. Umfang und Grenzen der Linuxabnahme stehen in +ist1.18. Umfang und Grenzen der Linuxabnahme stehen in [mvp-gates.md](mvp-gates.md) und [mvp-final-audit.md](mvp-final-audit.md). Die frühere Entwicklungspause wurde durch den ausdrücklichen Fortsetzungsauftrag aufgehoben. Ältere offene oder pausierte Zustände unten @@ -53,6 +53,21 @@ Zugänge und private Rohbelege bleiben gitignoriert. ## Aktuelle Windowsfortsetzung +Neue Userentscheidungen1.18: RemoteSigned nur für den einzelnen zuvor in der +WebUI genehmigten PowerShell5.1-Jobprozess, vor Genehmigung sichtbar und fest +gebunden; bestehendes W32Time gezielt starten ohne Startart-/NTP-/ACLänderung; +manueller VM-Konsolenneustart erst nach konkreter Zeitabstimmung. Keine Remote- +oder RMM-Rebootfreigabe. Umsetzung des optionalen Skriptprofils noch offen. +[Begrenzter Vertrag](windows-powershell-policy.md). + +Gemeinsamer Upgradefall `6d2df065…` bisher vor dem Server-Beforecheckpoint +abgebrochen, kein Enter-/Stop-/Swap-/Startintent. Bestehender RMM-Agent meldet +weiter Heartbeats; Reverse-Tunnellistener vorhanden, aber TCP-Weiterleitung +liefert derzeit kein SSH-Banner. Kein Upgradefortschritt daraus ableiten. +Konkrete Zeitabstimmung für den bereits zugesagten manuellen Konsolenneustart +wurde angefragt; bis zur Antwort keine Ziel-Neustartaktion und keine Annahme +eines erfolgten Neustarts. Aktuelle Artefakte weiterhin2bee/921c. + Vollständiger neuer Nur-Lese-Helperwitness auf der Windows-VM bestanden, Fall `f4879e01…`, EXE `d0b2d033…`: tatsächliches SQLite-VFS-Dateihandle, Integrität, drei Basistabellen0/0/1 und zwei leere Intent-Leaves geprüft; diff --git a/docs/project-decisions.md b/docs/project-decisions.md index 09a7379..a84d90e 100644 --- a/docs/project-decisions.md +++ b/docs/project-decisions.md @@ -1,6 +1,31 @@ # Verbindliche Projektentscheidungen -Stand: **2026-11-14**, Spezifikation **1.17** (`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. +Stand: **2026-11-14**, Spezifikation **1.18** (`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. + +## Begrenzte Windowsfreigaben des Users (Version1.18) + +- `RemoteSigned` ist ausschließlich für den einzelnen zuvor WebUI-genehmigten + Windows-PowerShell5.1-Jobprozess erlaubt. Die feste Prozessoption muss vor + Genehmigung sichtbar im unveränderlichen Plan stehen und in den signierten + Originaljobbytes gebunden sein. Kein stilles Nachrüsten alter Pläne, kein + `Bypass`/`Unrestricted`, keine persistente CurrentUser-/Maschinen-/GPOänderung + durch den Executor. GPO-Vorgaben bleiben wirksam; Linux und andere Interpreter + erhalten keinen solchen Override. SYSTEM-Skripte bleiben außerhalb des engen + SYSTEM-SCM-Vertrags. [Entwurf und Nachweisgrenzen](windows-powershell-policy.md). +- Der bestehende `W32Time` darf gezielt gestartet werden. Startart, NTPserver/ + Peers und ACLs dürfen hierfür nicht verändert werden. Ein laufender Dienst + eröffnet keine TrustedClock-/Syncbereitschaft; diese braucht eigene tatsächliche + Status-/Unsicherheits-/Bootnachweise. +- Ein manueller Windows-VM-Konsolenneustart ist für später zugesagt, erst nach + ausdrücklicher Zeitabstimmung. Kein Remote-Reboot, kein RMM-Reboottest und kein + daraus erfundener Rebootjob-Erfolgsnachweis. Der Notebookhost bleibt reiner + Entwicklungsrechner. + +Diese Userfreigaben sind dokumentierte Entscheidungen, keine Ausführungs- oder +Implementierungsnachweise. Die RemoteSigned-Vertragserweiterung ist zunächst +ein Entwurf; laufende qualifizierte Quellbindungen werden dafür nicht verändert. +Clock-, Boot-, Genehmigungs- und native Capabilitygates bleiben geschlossen, +solange ihr jeweiliger tatsächlicher Nachweis fehlt. ## Nachgewiesener Nichtstart vor SYSTEM-Delegation (Version1.17) diff --git a/docs/windows-powershell-policy.md b/docs/windows-powershell-policy.md new file mode 100644 index 0000000..9c0b8e0 --- /dev/null +++ b/docs/windows-powershell-policy.md @@ -0,0 +1,105 @@ +# Windows PowerShell5.1: feste prozessbezogene RemoteSigned-Option + +Stand2026-11-14, Spezifikation1.18. **Userentscheidung dokumentiert, +Implementierungsentwurf noch nicht umgesetzt und nicht nativ abgenommen.** +Diese Arbeit liest Produktquellen und ändert ausschließlich Dokumentation. +Laufende Rust-/Artefaktbindungen bleiben unverändert. Keine VM-/Server-/Gitaktion +oder Capability-/Clock-/Jobkonfigurationsänderung gehört zu diesem Schritt. + +## Autorisierter Umfang + +Der User erlaubt die feste Option `RemoteSigned` für jeden zuvor mit seinem +unveränderlichen Plan in der WebUI genehmigten Windows-PowerShell5.1-Jobprozess. +Der Prozessumfang und die Option müssen bereits vor der Genehmigung sichtbar +und Bestandteil der signierten Originaljobbytes sein. Das erlaubt keine +pauschale Skriptfreigabe, keinen direkten API-/DB-Genehmigungspfad, keine freie +Policyzeichenfolge und keine SYSTEM-/Root-PowerShell. Der erste SYSTEM-Vertrag +bleibt auf seine eigenen typisierten SCM-Fixturen begrenzt. + +Der Executor setzt dafür keine CurrentUser-/LocalMachine-/GPO-Werte, schreibt +keine Registryrichtlinie und verwendet kein `Bypass`/`Unrestricted`. Eine +Gruppenrichtlinie wird nicht verändert oder übergangen. Blockiert sie den +Auftrag weiterhin, wird der tatsächliche Fehler berichtet. Microsoft beschreibt +den Hostparameter als sitzungsbezogen und ohne Registryänderung; Gruppenrichtlinien +bleiben vorrangig. [Windows-PowerShell5.1-CLI](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_powershell_exe?view=powershell-5.1), +[Policybereiche und Vorrang](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-5.1). + +## Kleinster vorgeschlagener Datenvertrag + +Ein optionales, am Ende ergänztes Feld `windows_execution_profile` in +`Action::RunScript` enthält eine endliche typisierte Enum mit zunächst genau +`powershell_51_remote_signed`. Das ist ein technischer Vorschlag zur Prüfung, +noch kein vorhandenes Schema. Der Wert bezeichnet fest Windows PowerShell5.1, +`agent_service` und RemoteSigned im Jobprozess; kein frei übergebbarer +Interpreterpfad, Scope oder CLI-Argumentblock. + +Das fehlende Feld behält die vorhandene Bedeutung `inherited`. Es wird per +Serde-default und `skip_serializing_if = Option::is_none` beim Kodieren vollständig +ausgelassen. Damit bleiben bisherige Linux-/PowerShell-Job- und Plangoldens +bytegleich; vorhandene Pläne erhalten nachträglich keine neue Prozessoption. +Die zusätzlichen Bytes eines neuen RemoteSigned-Auftrags gehen bereits in +`job_payload_hash`, Planhash und den bisherigen signierten Originalgrant ein. +Ein neuer Grantcodec oder ein neues pauschales Genehmigungsrecht ist dafür +nicht nötig. Geänderter Profilwert bedeutet geänderten Plan mit neuer +WebUI-Genehmigung, niemals nachträgliche Anpassung des genehmigten Payloads. + +Nur `interpreter=powershell`, `execution_identity=agent_service`, ein eindeutig +gemeldetes Windowsziel und die konkrete qualifizierte Profilfähigkeit dürfen +den Wert verwenden. Linux, posix_sh/bash, andere Interpreter, gemischte +Plattformcapabilities, Root/SYSTEM und unbekannte Profilwerte verweigern ihn. +Ein gesonderter Profilcapabilityname, beispielsweise +`script.powershell.process_remote_signed/1`, ergänzt `script.powershell/1`; +alte Windowsclients erhalten dadurch keinen unbekannten Auftrag. Die Benennung +und Veröffentlichung bleiben bis Review und tatsächlicher Qualifikation offen. + +## Konkreter Änderungsschnitt nach Freigabe der Quellen + +| Quelle | Eng erforderliche spätere Änderung | +| --- | --- | +| `crates/domain/src/jobs.rs` | Option/Enum, validate/available_for und unveränderte Legacygoldens. Nicht-Windows-/Nicht-PowerShell-Verwendung früh verweigern. Bestehende Konstruktoren erhalten ausdrücklich None ohne Wireänderung. | +| `crates/server/src/jobs.rs` | Feld je `Variant` mitführen: Web-resolve, validate_variants, target_action und Erstvarianten-Konsistenz einschließlich Profil. Gemischte feste Pläne binden das Profil ausschließlich in der Windowsvariante. Typed- und Webeingang gleich prüfen. Vorhandene Submit-/Approval-/Revalidationpfade behalten Hash- und Rechteprüfung. | +| `crates/server/src/job_gateway.rs`, `crates/server/src/synchronization.rs` | Vorhandene zentrale Capability-/Payloadprüfung für Zustellung und Permit prüfen; Erfolgsevidenz bindet angefordertes Profil und Prozessumfang, behauptet ohne Messbeleg keine effektive GPO-Policy. Keine Abschwächung der Grant-, Sync- oder Clockprüfungen. | +| `web/src/api.ts`, `web/src/safety.ts`, `web/src/main.tsx` | Eingabe nur als festes Windowsprofil; keine beliebigen Policyflags. Vor dem Genehmigungsknopf aus hashgeprüften gespeicherten Planbytes je Windowsziel ausdrücklich „Windows PowerShell5.1 · RemoteSigned · nur Jobprozess“ anzeigen. Fehlender/unlesbarer Profil-/Plannachweis blockiert die entsprechende Genehmigung. Alte inherited-Pläne ehrlich als solche zeigen. | +| `crates/agent-windows/src/actions.rs` | Profil prüfen und ausschließlich beim passenden signierten Auftrag `-ExecutionPolicy RemoteSigned` vor `-File` in die festen Einzelargumente aufnehmen. None behält vorhandene inherited-Argumente. Kein Wrapper, keine Prolog-/BOM-/Zeilenendenänderung und keine andere Skriptkopie nach Hashbildung. Evidenz nennt angefordertes Profil/Prozessumfang. | +| `crates/agent-windows/src/runtime.rs` | Neue Profilcapability erst nach separater nativer Clock-/Boot-/Jobpfadqualifikation veröffentlichen. Kein Aktivieren durch den bloßen Codec-/Buildwechsel. | + +Der vorhandene Prozessadapter nutzt bereits einen festen ausführbaren Pfad, +ein minimales eigenes Childenvironment sowie atomare Job-/Handlelisten und +begrenzte stdout/stderr-/Timeout-/Cancelpfade. Diese Verträge bleiben erhalten. +Es wird kein Policywert in die Umgebung des permanenten Agentdiensts übernommen. +Nach `-File` folgen ausschließlich die genehmigten Skriptargumente. Eine +angeforderte Prozesspolicy ist keine Behauptung der tatsächlich effektiven +Policy; bei Bedarf enthält eine separat genehmigte harmlose Abnahme selbst +die unveränderten read-only Get-ExecutionPolicy-Anweisungen als sichtbare +Skriptbytes. Kein stiller Zusatzprozess oder Scriptwrapper zur Liveerhebung. + +## Geplante minimale Nachweise, nicht ausgeführt + +1. Shared Domain-/Grantvertrag lokal prüfen: alte Linux-/PowerShell-Goldens + bytegleich; neues Profil vollständig im Payload-/Planhash; Profilmutation + gegen den Originalgrant verweigert; Linux/anderer Interpreter/Root/SYSTEM/ + unbekannter Wert/fehlende Profilcapability verweigert. Gemischter Plan behält + die unveränderte Linuxvariante und die feste Windowsprofilbindung. +2. Diese gemeinsam betroffenen Vertrags-/Negativfälle zuerst isoliert auf der + tatsächlichen Linux-Test-VM ausführen. Keine tatsächliche Windowsausführung + oder zusätzlich genehmigte Zielwirkung damit vortäuschen. Vorhandene Linux- + Jobhistorie/Grants und Jobzahlen bleiben unverändert; ein Crossbuild ersetzt + diesen Linux-first-Nachweis nicht. +3. Server-/UI-Negativfälle eng prüfen: Option im verifizierten Approvalplan + sichtbar; Mutation, Capabilityverlust und Widerspruch zwischen Variant und + Action verweigert; pending_approval ohne Job/Outbox/Startgrant. Kein API-/DB- + Approval als Testabkürzung. +4. Erst nach den separaten Clock-/Boot-/Jobgates auf der tatsächlichen Windows- + VM einen neuen festen harmlosen PowerShellplan in der WebUI genehmigen. + Prozess, SID, exakte Skript-/Ausgabebytes und angeforderte Option nachweisen. + Falls effektive Policy geprüft wird, stehen diese read-only Befehle bereits + im genehmigten Skript. Persistente CurrentUser-/Maschinen-/GPO-Werte vor/nach + der Abnahme unabhängig lesen und unverändert nachweisen. Kein Reboot für + diesen Skripttest, keine Maschinenpolicyänderung und keine neue Wirkung bei + Redelivery. Browser-Dev/Testsimulation nur sichtbar nach bestehendem Vertrag. + +Der bestehende W32Time darf nach neuer Userfreigabe ohne Startart-/NTP-/ACLänderung +gezielt gestartet werden. Ein späterer manueller VM-Konsolenneustart benötigt +vorher die konkrete Zeitabstimmung mit dem User und ist kein RMM-Reboottest. +Beides ist ein separater Umfang und ersetzt weder eine vertrauenswürdige Uhr +noch die WebUI-Genehmigung eines Skriptjobs.