Files
rust-discovery/docs/windows-powershell-policy.md
T
2026-11-14 10:06:10 +01:00

8.3 KiB

Windows PowerShell5.1: feste prozessbezogene RemoteSigned-Option

Stand2026-11-14, Spezifikation1.18. Userentscheidung als Sourcekandidat im isolierten Profilbranch umgesetzt und nativ Linux-first vertraglich geprüft. Die23 Domain-/Coreverträge bestanden auf der Cloud-Linux-VM; Windows22 und die tatsächliche genehmigte PowerShellwirkung bleiben offen. Keine Capability-, Clock- oder Jobkonfiguration aktiviert, kein Deployment. Hauptcheckout und laufende Windowsartefakte bleiben unverändert. Tatsächlicher Nachweis.

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.