Files
rust-discovery/docs/windows-powershell-policy.md
2026-11-14 09:21:05 +01:00

8.2 KiB

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, Policybereiche und Vorrang.

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.