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

106 lines
8.2 KiB
Markdown

# 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.