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