106 lines
8.2 KiB
Markdown
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.
|