Files
rust-discovery/docs/script-console-contract-proposal.md
T
2026-11-14 16:35:11 +01:00

18 KiB
Raw Blame History

Skriptkonsole: Root-/SYSTEM-Vertrag1.20 und tatsächliche Nachweise

Aktualisierung1.20, 2026-11-14: Der User und Rootreview haben den nun in Spezifikation0.1, project-decisions und development dokumentierten Vollwartungs- vertrag beschlossen. Der folgende ursprüngliche Entwurf ist als historische Herleitung zu lesen: Insbesondere „kein neues Wirefeld“ und die Beibehaltung des beschränkten Generalprofils als Wartungsruntime sind überstimmt. Aktuell gilt das additive privileged_script_profile="full_maintenance_v1", getrennte explizite Policyversionen und eine eigene Linux-Helperroute. Kein stilles Erweitern von General/APT/SCM/MSI. Quelle/Build/Unit/Native weiterhin getrennt.

Ursprünglicher Entwurfsstand, Basis 287a784: Damals noch nicht beschlossen oder implementiert. Der aktuelle beschlossene Vertrag und die späteren tatsächlichen Quellen-/Prüfnachweise stehen oben und am Dateiende. Dieser neue Fokus ersetzt die EXE-Priorität; der EXE-Normpatch bleibt ein unbeschlossener separater Archivstand. Vollständige Pflichtdokumente wurden gelesen; Spec1.19/PD/Dev sind bytegleich zum zuvor vollständig gelesenen Stand. Hier werden nur vorhandene Pfade auditiert und konkrete Änderungen vorgeschlagen. Kein Produkt-/Norm-/APIcode, Build, VMkontakt oder Ausführungsjob geändert.

Bereits vorhanden und tatsächliche Lücken

web/src/main.tsx75–90 hat bereits vollständigen UTF-8-Editor, Linux/Windows- Plattformwahl, feste Interpreter, erwartete stdout-Nachbedingung und explizite Identitätsauswahl. Planansicht/Recheck/Submit/Approval bestehen. Operations- und Jobdetails152–165 pollen tatsächlich Zustand/Ergebnis und bieten Abbruch an. Ausgabe erscheint bisher nur im allgemeinen JSON, nicht als lesbare Konsole. SYSTEM ist für RunScript in UI, Domain, Backendpolicy und Helper bewusst gesperrt.

Linux-Rootskripte existieren: zentral root_policy.rs mit allow_root_scripts, root:execute und den allgemeinen Skriptrechten; lokal unabhängiges allow_root_scripts, NativeClock/RootSync und atomarer Originalgrantverbrauch. privileged-helper::script nutzt den vorhandenen Linux-Adapter. Dessen process::run hat Prozessgruppe, feste Umgebung, Timeout und beschränkte Pipes, aber keine laufende Cancel-/Fenceabfrage. Ein Timeout oder unbelegtes Ende wird Unknown; ein Kill beweist keine rückgängig gemachten Wirkungen.

Windows hat einen sicheren PowerShell-Datei-/JobObject-Pfad in actions.rs und process.rs, ist aber ausdrücklich LocalService/SID19. Ein Umbenennen der Identität wäre falsch. SYSTEM muss unter dem tatsächlich authentisierten SYSTEM-Helper/SID18 starten und dessen privaten Arbeitsbereich verwenden. Intent/Abandon/RawMirror sind vorhanden; WindowsClock bleibt ohne echten TrustedClock-Nachweis geschlossen. Linuxbelege ersetzen diesen nicht.

Der aktuelle Protobufvertrag hat nur JobResult.stdout/stderr; keinen JobOutputChunk und keinen implementierten JobProgress-Outputstream. Kleinster vollständiger Batch-Skriptkonsolenpfad: während Ausführung echte Statusanzeige, Laufzeit und Cancel-Anforderung; begrenzte stdout/stderr mit Rohbytes nach dauerhaftem Ergebnis. Keine behauptete Liveausgabe oder interaktive PTY. Falls Root/User Ausgabe bereits während der Ausführung verlangt, ist dafür ein separat zu prüfender begrenzter dauerhafter Chunkvertrag erforderlich; kein UI-Polling von flüchtigen Helperdateien oder vorgetäuschtes Streaming.

Enger Funktions- und Autoritätsvertrag

Weiterhin genau RunScript, kein neues Actionformat, universeller Execute- Endpoint oder Terminalserver. Default bleibt agent_service; Root/SYSTEM nur ausdrücklich gewählt. Die kompletten eingegebenen UTF-8-Bytes, Interpreter, Argumente, Ausgabe-/Zeitlimit, Identität, Plattformvariante und gegebenenfalls vorhandenes PowerShell-RemoteSigned-Profil werden vor Hash/Planbindung festgeschrieben. Kein BOM-/Zeilenenden-/Prolognachrüsten nach Genehmigung. Nicht-ASCII-PowerShell braucht das bestehende explizite BOM im Editorinhalt. UI darf Argumente zunächst als feste leere Liste halten; keine freien Executablepfade, URLs oder -Command-/EncodedCommand-Launcherparameter. Linux verwendet /bin/sh -- <privateDatei> oder nachgewiesenes /bin/bash; Windows fest WindowsPowerShell5.1 mit -NoLogo -NoProfile -NonInteractive, optional genehmigtem prozessbezogenen RemoteSigned und -File <privateDatei>. Kein pwsh-Fallback oder ExecutionPolicy-Abschalten, GPO bleibt vorrangig.

Jeder Auftrag bleibt pending_approval ohne Jobs/Outbox/Offers/Grants bis zum tatsächlichen WebUI-Klick. Ersteller und Freigeber benötigen ihre aktuellen Operationsrechte und scripts:execute, zusätzlich root:execute bzw. system:execute. Keine neuen allgemeinen Rechtebezeichner, kein Autoapprove. Zentrale geräte-/principal-/generations-/helperhashgebundene Policy und lokale Helperpolicy müssen privilegierte Skripte zusätzlich ausdrücklich zulassen. Linux verwendet das bestehende Opt-in; Windows erhält ein versioniertes allow_system_scripts-Opt-in, alte SCM/MSI-Settings verweigern weiter Skripte. Interpreter und Maximalbudget sind feste überprüfbare Grenzen, keine Befehlsblockliste. Erforderlich bleiben bisherige Plattform-/Interpretercaps, Helperpins und signedSync; SYSTEM braucht zusätzlich die enge system:run_script-Capability. Nichts davon aus Build oder Bootstrap publizieren.

Kleinste erste Grenzen: Skript1–32768Bytes, insgesamt höchstens65536Bytes stdout+stderr, Laufzeit1–300s für Linux-Root wie der vorhandene zentrale Deckel; SYSTEM zunächst1–120s wie die vorhandene Helper-Lane. UI validiert diese tatsächlichen Grenzen vor Planung. Größere Budgets sind keine stillen Defaults. Keine Wire-/JobPayload-/Grantcodecänderung nötig; Linux- und bisherige agent_service-/PowerShell-RemoteSigned-Goldens bleiben erhalten.

Tatsächliche Privilegien, Sandbox und Reboot

Ein genehmigtes allgemeines Root-/SYSTEM-Skript ist bewusste Volladministration im tatsächlich gestarteten Dienstkontext, keine sichere Standardaktion. Es kann Dateien/PKI/Journale, Konten, Dienste, Paketmanager, Egress und gegebenenfalls den OS-Neustart beeinflussen oder andere Programme nachladen. Der gebundene Skripttext pinnt nicht automatisch alle später von ihm gelesenen Programme und Netzbytes. Keine Befehlsblockliste kann das zu einem harmlosen Profil machen. Ein Angreifer mit genehmigtem Rootcode ist außerhalb der Integritätsgarantie dieses lokalen Helpers; Benutzer mit diesem Recht müssen als Hostadministratoren vertrauenswürdig sein. Die Freigabe ist niemals eine KI-Dauerberechtigung.

Der aktuelle Linux-Generalhelper ist tatsächlich UID0, hat aber unter anderem PrivateNetwork, ProtectSystem, begrenzte Capabilities und Seccomp. Diese Grenzen bleiben im ersten Integrationsslice unverändert; manche Skripte werden damit ehrlich fehlschlagen. Sie sind kein zugesicherter Sandboxschutz gegen allgemeinen Rootcode, insbesondere nicht gegen Delegation an vorhandene privilegierte Betriebssystemdienste. UI muss UID0/SID18 und den konkreten qualifizierten Runtime-/Policykontext zeigen, nicht „uneingeschränkte Hostrechte“ erfinden. Falls uneingeschränkter Hostkontext benötigt wird, braucht er einen gesonderten explizit geprüften und gepinnten Bootstrapprofilwechsel; keine stille Entgrenzung der vorhandenen Helper-/APT-/MSI-Dienste im Skriptslice.

Eine Skriptgenehmigung erlaubt die sichtbaren Skriptbytes und deren mögliche administrative Wirkung, keinen zusätzlichen RMM-Reboot-/Paketjob. Skript- Exit0 beweist nur Prozess-/gebundene stdout-Nachbedingung, keine Paketabnahme. Ein vom Skript ausgelöster Neustart ist kein erfolgreicher typisierter Rebootjob: ohne dessen eigenen unabhängigen Vorher-/Nachher-/Fristbeleg bleibt der Skriptversuch bei fehlendem Ergebnis Unknown. Keine implizite OS-Rebootabnahme, kein nochmaliges Ausführen nach Reconnect und keine aus einem Warntext abgeleitete allgemeine Erlaubnis, tatsächliche Testreboots/Updates durchzuführen.

Dauerhaftigkeit, Abbruch und lesbare Ausgabe

Dieselbe OriginalRequest-/Plan-/Grantprüfung, ein einziger atomarer Start, Outcome zuerst dauerhaft, dann Jobjournal/Ergebnis und normaler SignedSync. Windows verwendet genau den vorhandenen Intent→MayHaveDispatched→Helper-/ RawFullTupleMirror-Pfad. Abandon ausschließlich bei belegtem Nichtdispatch, ohne Script-/Temporärdateiwirkung; Originalgrant nie leeren, Unknown/Missing- Guards nie lockern. Keine zweite Zustandsmaschine oder Ausführungswiederholung.

Linuxprozess erhält einen tatsächlichen kooperativen Cancel-/Fencecallback innerhalb der bestehenden Poll-/Pipe-Schleife. Windows nutzt den vorhandenen JobObject-Prozessbaum mit tatsächlichem SYSTEM-Token und entsprechender Fence-/Cancelprüfung. Nur der eigene beobachtete Prozessbaum darf begrenzt beendet werden; kein globales Kill. Abbruch/Timeout nach möglicher Wirkung bleibt Unknown. Kernelbestätigtes Prozessende ist kein NoEffect-/Rollbackbeweis. Ein durch Root/SYSTEM abgespalteter Dienst/Task kann außerhalb des beobachteten Baums weiterwirken; keine vollständige Prozesskonfinierung behaupten. Wenn Beendigung nicht bestätigt ist, behält der Helper eigene Child-/Handlebindung und die Ressourcensperre; kein neuer Start aus bloßem Pipe-/Channelclose.

UI zeigt getrennte stdout/stderr, Exitcode, Trunkierung, tatsächliche Identität, Zustand/Unknown und Cancelstatus. Rohbytes bleiben unverändert gespeichert; Textdarstellung bekommt explizite Decoder-/Encodingangabe und optional Byteansicht, keine stillen Ersatzzeichen als Originaloutput ausgeben. Nur Reacttext, kein HTML/ANSI-Scriptinterpretieren oder zustandsändernde Aktion aus Logtext. Anzeigenaliase und später mutierte APIobjekte müssen gegen gespeicherte Planpayloadbytes geprüft werden, auch für Linuxroot und WindowsSYSTEM.

Reihenfolge und kleinste Dateigrenzen nach Rootreview

  1. Root beschließt den Skriptvertrag1.20; EXE1.20 wird nicht übernommen.
  2. UI-Konsole/Rootpfad und Cancel-/Outcomeownership lokal qualifizieren; danach tatsächlicher Cloud-Linux-RunScript mit WebUI-Genehmigung, stdout/stderr, Rootidentität, einmaligem Grant und verlorenem Reply/Abbruch korrekt nachweisen.
  3. SYSTEMpfad sourceimplementieren, portable Guards Linux-first→Windows; erst nach echter Clock-/Peer-/Helper-/PERSISTqualifikation Windows-Skriptjobs per WebUI. Keine Windowsfähigkeit aus dem Linuxnachweis ableiten.
Scope Engste Änderungen nach Freigabe
Norm Root: Spec1.20/PD/Dev für Skripte statt EXE; explizite Administrator-/Rebootgrenzen
Web bestehende main/api/safety+betroffene Tests: vorhandenen Editor behalten, SYSTEM-Option für RunScript, verifiedScriptProjection, lesbare Ausgabe/Cancelstatus
Linux agent-linux actions/process; privileged-helper script/main/control und Agenthelper-Routing nur soweit Cancel/gebundene Ownership nötig; keine stille Unitlockerung
Windows actions/process um explizite getrennte LocalService-/SYSTEM-Einstiege; helper_system/helper_runtime/runtime um RunScript unter bestehenden Intent-/Mirrorgrenzen; private gehaltene SYSTEM-Skriptdatei
Domain/Backend jobs.available_for/valid_helper_denial_shape; windows_policy und vorhandene DTO-/Gateprüfungen, bisheriger Rootpfad erhalten; neue lokale bool-Settings nur versioniert und None-omit
Core/Protocol/SQL keine neue Zustandsmaschine oder Job-/Grantfelder geplant; bestehende Codecs/Unlocks unverändert, Chunktransport ausdrücklich nicht Bestandteil des ersten Batchpfads

Alle Angaben oberhalb sind Sourceaudit und Entwurf. Tatsächliche privilegierte Skript-/Abbruch-/Runtimeabnahmen bleiben offen, bis Root sie getrennt ausführt.

Implementierungsstand des genehmigten1.20-Schnitts

Lokal implementiert: additives strikt nichtnull Profil am Ende der RunScript- Action, Identitäts-/Capability-/Laufzeit-/Outputgrenzen und unveränderte Legacy- Bytes; drei echte Rust-Codecplanfamilien in tests/script_console/codec-golden.json. Zentrale Rootversion2 und SYSTEMversion3 erfordern zusätzliche explizite allowed_script_profiles; beide Akteure benötigen aktuelle Skript- und jeweilige Privilegrechte. Eigene Linuxroute RMM_FULL_MAINTENANCE_HELPER_SOCKET mit RMM_FULL_MAINTENANCE_POLICY_FILE, lokalem FullMaintenanceprofil und unverändertem Sharedledger; bestehende General-/APT-Dienste werden nicht geändert.

deploy/linux/rmm-full-maintenance-helper.service ist ein reviewbarer, noch nicht installierter vollständiger Hostkontext ohne die General-Sandbox. Vor Zieländerung sind tatsächliche zusammengesetzte Unit, Gruppen-/Socket-/Pinpfade, Rootbesitz, Journale und Inodes zu prüfen. Der eigene Socket und Pin müssen explizit auf das FullMaintenanceprofil zeigen; kein Fallback auf General/APT. Eine passende Bootstrapkonfiguration enthält profile=full_maintenance_v1, allow_root_scripts=true, allowed_script_profiles=["full_maintenance_v1"], leere allowed_services, allow_reboot=false und keinen apt_provider. Das letzte Flag begrenzt nur die typisierte Helperaction, nicht den genehmigten Rootcode.

Laufender Linuxabbruch benutzt ausschließlich EOF/Halbschließen des vorhandenen originalrequestgebundenen, beidseitig peergeprüften Unixstreams. Der Agent beobachtet konkreten Attempt-Cancel, aktuelle Kanalgeneration und lokale Clock; der Helper beobachtet Peer/EOF/Clock. Ein abgelaufenes Startticket beendet keinen bereits gültig begonnenen Prozess. Eigene Prozessgruppe wird beendet und unter beibehaltener lokaler Effektlock bis zum belegten Ende lebender Mitglieder beobachtet. Zombieeinträge werden anhand ihres tatsächlichen /proc-Status von lebender Wirkung unterschieden, bei unklarer Beobachtung bleibt die Lock erhalten.

Windows besitzt einen gesonderten SYSTEM-Skriptpfad nach atomarem Verbrauch, mit privater gehaltenem Skriptdateihandle, exakt erhaltenen Bytes, festem PowerShell5.1-argv und JobObject. Clock/Peer/Intent/STOP bleiben beobachtet, Originalgrant wird unmittelbar vor Prozessstart frisch geprüft. Nach Start bleibt seine Startfrist eine Startfrist. Unklare Prozessbereinigung behält JobObject/Prozesshandles und Helperlane bis zum belegten Ende. SID18 und Profil- /Skripthash werden im Ergebnis gebunden; LocalService-Admission bleibt separat. Keine neue Windowscapability ist durch diese Quellen öffentlich aktiviert.

Tatsächliche Zwischenprüfung:22 Domain-Tests lokal im unveränderten Offline- Builder9a76ad37… bestanden, einschließlich alter Bytegoldens und neuer Profile. Weitere Prüfungen und native Cloud-Linux-/Windows-Abnahmen sind noch offen; kein neues RMM-Zielprofil installiert, kein Job gestartet oder genehmigt.

Eingefrorene lokale Qualifikation1.20

Der abschließende lokale Lauf ist vollständig:157 Compiler-/Include-/Fixture-/ Deploymentinputs unverändert vor/nach; Manifest 60a50262f9f8d85c11eb58e1a9e0f6e03be6cd5db7a59bc1745fb7d9dc8a6f65. Linuxfmt/Workspace-Alltargets-Clippy mit -Dwarnings bestanden;284 lokale Tests bestanden und zunächst5DB-Fälle ausgelassen, anschließend sämtliche45Servertests inklusive dieser5 in frischem internem PostgreSQL bestanden (0ignored). WindowsGNU Default/Systemhelper-Alltargets-Clippy bestanden; keine native Windowsprüfung. Release-Linux-Unitlisten und Agent-/Helper-/Serverbinaries sind gebunden gebaut, noch nicht auf Zielen ausgeführt oder installiert. Vorherige unvollständige Packvorbereitungen sind separat protokolliert, keine bestandenen Qualifikationen.

Der separate Create-once-Linuxrunner ist vorbereitet, noch nicht ausgeführt; kein Compilerinput wurde dafür verändert. Konkrete lokale Belege, geplante Befehle, Erwartung83PASS/5expliziteDBignored auf Cloud-Linux und die noch nötige Erhaltungs-/Bootstrap-/WebUI-Abnahme stehen in deploy/linux/full-maintenance-README.md.

Separater Reviewblocker nach der ersten Qualifikation

Ein unabhängiger Review fand nach Packde34 die fehlende tatsächliche laufende Linux-Fullhelperbinarybindung. Dieser Pack bleibt unverändert früherer Beleg und berechtigt keine Fullaktivierung. Ein enger separater Corefix bindet helper_binary_sha256 ausschließlich im neuen Fullschema/Pin/Policy/Probe und zentralen Scope; Root hält/prüft sein echtes laufendes Image, Agent993 benötigt keinen fremden Root-/proc-Zugriff. General/APT lassen die neuen None-Felder vollständig aus. Core-Review erfolgt vor neuem Build; neue tatsächliche Quellen-/Unit-/VM-Belege werden separat ergänzt, nicht vom alten Pack abgeleitet. Der Native-Runner ist vorbereitet und lokal geparst, noch nicht ausgeführt.

Neue tatsächliche lokale Qualifikation nach Binärpinfix

Der neue Pack29461892 ist ein eigener Beleg; de34 und der ursprüngliche Reviewdiff bleiben erhalten. Manifest ddd1a78d1cd289b02b1f98572f9652171ec00be84e01ce099fd722d689bcaacd, 158 Inputs unverändert vor/nach. Format und Linux-/beide Windows-GNU-Clippyprofile mit-Dwarnings bestanden;285 lokale Tests bestanden, anschließend alle45Servertests mit tatsächlichem isoliertem PostgreSQL einschließlich vorheriger5DBignored bestanden (0ignored). Der neue Rootimage-Test prüft in jedem Eigentümerpfad Sicherheitsassertions, kein stilles Skip. Native Linuxlisten22/16/6/45 gebaut, auf der Cloud-VM noch nicht ausgeführt; neue Erwartung84PASS/5expliziteDBignored. Der Native-Runner ist separat ausdrücklich auf diesen neuen Pack gebunden und lokal geparst; seine Supportquellen/Scopetatsachen sind in Intent und Readback streng geprüft. Bisher keine SSH-, VM-, Enrollment-, Dienst-, Policy-, Job- oder Capabilityänderung durch diesen Strang. Aktueller Primärstand und noch geplante Bootstrap-/WebUI-Abnahmen: deploy/linux/full-maintenance-README.md.

Tatsächlich nativ auf Cloud-Linux geprüft

Der korrigierte158-Input-Pack29461892/ddd1a78d wurde durch Root nach beiden Source-Reviews auf der tatsächlichen Cloud-Linux-Test-VM ausgeführt. Fall 7b61ce46-7913-492b-9c6b-414a0c2b6ffc: Domain22, Linuxruntime16, Helperpolicy6, Serververträge40PASS plus5explizite DBignored; insgesamt84PASS. Alle vollständigen Listen wurden zuerst geprüft. Die fünf DBfälle sind nur im separaten isolierten45er-PostgreSQL-Lauf nachgewiesen. NativeproofSHA256 a831a70a3cf76a3e8a9bf5820dcca7100d2ef9860dd9388539fe9c13f949f470. Keine Zielruntime bereitgestellt oder Job-/Capability-/Policyfreigabe. Die tatsächliche WebUI-genehmigte volle Wartung bleibt ein eigener offener Schritt.