feat: add approval bound full maintenance script console and executors
Rust development slice / linux (push) Failing after 6s

This commit is contained in:
2026-11-14 16:35:11 +01:00
parent 287a784c8f
commit ff78b6a498
51 changed files with 8880 additions and 278 deletions
+109 -1
View File
@@ -1,6 +1,6 @@
# Rust RMM: Architektur und Implementierungsspezifikation
Version 1.19 · 2026-11-14 · Sprache: Deutsch
Version 1.20 · 2026-11-14 · Sprache: Deutsch
**Zweck:** Vollständige, eigenständig nutzbare Grundlage für die Implementierung einer mandantenfähigen Plattform zur Inventarisierung, Überwachung und Fernadministration von Kundengeräten durch eine Coding-KI und ein Entwicklungsteam.
@@ -33,6 +33,14 @@ Abandon mit Originalgrant, unabhängiger Helper-Lineage und vollständiger
Snapshotbindung präzisiert. Mehrdeutige Übergaben bleiben Unknown; keine
Abschwächung der vorhandenen Sync-/Verbrauchsinvarianten.
1.19 → 1.20 (2026-11-14): Der User priorisiert die vollständige, einzeln
WebUI-genehmigte Shell-/PowerShell-Skriptkonsole für KI/MCP und Menschen.
Ein ausdrücklich gebundenes Profil `full_maintenance_v1` ermöglicht nach
getrennter Qualifikation Root-/SYSTEM-Hostwartung; bisherige begrenzte
Dienst-/Paketprofile erhalten dadurch keine zusätzliche Erlaubnis. Batchstatus
und abschließende begrenzte Rohbyteausgabe verwenden die bestehende Jobstrecke;
interaktive PTY-/ConPTY-Sitzungen bleiben späterer eigener Umfang.
## Inhaltsverzeichnis
- [0 Auftrag und verbindliche Produktanforderungen](#0-auftrag-und-verbindliche-produktanforderungen)
@@ -122,6 +130,106 @@ Deploymentdaten, offene Konfiguration und reale Nachweise:
### 0.1 Auftrag an die implementierende KI
**Userentscheidung Version1.20 — vollständige genehmigte Skriptkonsole zuerst:**
Die KI darf über MCP gespeicherte Geräte-/Telemetriedaten im erlaubten Mandanten
lesen, vollständige Shell-/PowerShell-Skripte schreiben und feste Aufträge als
`pending_approval` beantragen. Ein berechtigter Mensch prüft und genehmigt in
der WebUI die gespeicherten exakten Skriptbytes, Interpreter, Argumente, Ziele,
Versuche, Identität und Grenzen. Erst dann darf der Agent ausführen. Der User
wählt zunächst die Batch-Skriptkonsole mit Zustandsverfolgung und abschließender
Ausgabe, ausdrücklich auch mit Root-/SYSTEM-Rechten zur vollständigen
Hostwartung. Diese Strecke hat Vorrang vor weiteren Paketfixture-Erweiterungen.
Die bisherige Einordnung interaktiver Terminals in M7 verschiebt diese
Batchkonsole nicht; PTY/ConPTY, neue Sitzungen und laufendes Outputstreaming
werden hierfür nicht eingeführt. Standardinventar/Heartbeats bleiben passiv;
angeforderte Live-Skripte bleiben Jobs, auch wenn sie nur Logs lesen.
`run_script` erhält das additive optionale Stringfeld
`privileged_script_profile="full_maintenance_v1"`. Fehlend wird es vollständig
ausgelassen und erhält sämtliche alten Codec-/Hashbytes. Explizites `null`,
unbekannte Werte und ein Profil bei `agent_service` sind ungültig. Das Profil
gehört vor Genehmigung in die exakten Aktions-, Job- und Planbytes und wird von
Signatur/Grant, zentraler Policy und lokaler Helperprüfung gebunden. Keine
nachträgliche Hülle, implizite Profilauswahl oder Erweiterung alter Pläne.
Windows-SYSTEM-Skripte benötigen dieses Profil; alte SYSTEM-SCM-/MSI-Policies
erlauben sie weiterhin nicht. Historische Linux-Root-Skripte ohne Profil behalten
ihren bisherigen begrenzten Ausführungsvertrag und werden nicht Vollwartung.
Planersteller und Freigeber benötigen jeweils aktuell `scripts:execute` und
zusätzlich genau `root:execute` beziehungsweise `system:execute`; beide
Identitäten bleiben getrennt. Das Profil braucht zusätzlich ein ausdrückliches,
versioniertes zentrales und lokales Opt-in samt exakten Geräte-/Generations-/
Principal-/Helperhashbindungen. Zentrale Linux-Policyversion2 und lokale
General-Policyversion2 können `allowed_script_profiles` mit genau dem
bekannten Profil enthalten; Windows-SYSTEM-Policyversion3 kann es getrennt von
SCM und MSI enthalten. Fehlend bleibt deny für Vollwartung; vorhandene `null`-
oder unbekannte Profile verweigern. Qualifizierte Capability
`script.full_maintenance/1` kommt zusätzlich zu Aktion, Interpreter,
`root:run_script` beziehungsweise `system:run_script`, Helperhash und signiertem
Sync hinzu. Quelle, Build oder Policydatei allein veröffentlichen sie nicht.
Für das neue Linux-Fullprofil ist zusätzlich `helper_binary_sha256` im
Schema2-Policy-/Pin-/zentralen Scope verpflichtend. Der Roothelper beobachtet
sein eigenes tatsächlich laufendes Image über einen gehaltenen Dateideskriptor
und prüft es vor Probe/neuer Zulassung gegen den geschützten Pin. Der Agent
verifiziert diese Rootpeer-Probe, ohne fremde Root-/proc-Dateien lesen zu müssen,
und meldet nur dann `helper.binary.sha256:<hash>`; die Zentrale verlangt denselben
Hash. Neue optionale Metadaten bleiben bei General/APT vollständig ausgelassen;
Schema1-Pins und deren alte Byte-/Hashverträge bleiben unverändert.
Linux erhält hierfür ein getrenntes explizites Helper-Ausführungsprofil
`full_maintenance_v1`; bestehende General-/APT-Sandboxes bleiben erhalten.
Seine systemd-Start-/Dateisystem-/Netzwerk-/Capabilitybedingungen müssen die
zugesagte Hostwartung tatsächlich erlauben und vor Zieländerung überprüfbar
feststehen. Windows führt mit dem eigenen SYSTEM-Token (SID18) aus, niemals
mit einem nur umbenannten LocalService-Prozess (SID19). Beide verwenden weiter
die unabhängige Originalsignaturprüfung, Peer-/Clock-/Boot-/Sync-/Fenceprüfung
und dauerhaften atomaren Einmalverbrauch. Windows bewahrt zusätzlich Intent,
Dispatchmarker, unabhängigen RawMirror und deny-only Abandon ohne Dateierzeugung
oder Wirkung. Skriptdateien entstehen erst nach erfolgreichem Helperverbrauch
in einem vom jeweiligen Helper geschützten Bereich. Journalidentitäten,
File-IDs/Inodes, Schlüssel und vorhandene Verbräuche bleiben erhalten; keine
Ledgerresets zur Einführung des Profils.
Die erste Vollwartungsstrecke erlaubt 1..32768 exakte UTF-8-Skriptbytes,
höchstens32 Argumente gemäß bestehendem Vertrag und insgesamt höchstens65536
stdout-/stderr-Rohbytes. Laufzeit bleibt ausdrücklich begrenzt: Linux1..300s,
Windows1..120s, zusätzlich zur engeren genehmigten/lokalen Grenze. Interpreter
und argv bleiben fest (`/bin/sh` oder qualifiziertes `/bin/bash` mit privater
Datei; Windows PowerShell5.1 mit `-NoLogo -NoProfile -NonInteractive -File`).
Die getrennte explizite, vor Genehmigung gebundene Prozessoption `RemoteSigned`
aus1.18 darf hinzukommen; kein Executorfallback oder Maschinen-/GPO-Override.
Encoding/BOM/Zeilenenden werden nach Genehmigung nicht verändert.
**Vollwartung ist volle Hostautorität:** Ein genehmigtes Root-/SYSTEM-Skript
kann Dateien, Netzwerk, Konten, Dienste, Agent und Schlüsselbestand ändern und
auch einen Neustart auslösen. Kein Sandbox-, No-Reboot-, Rollback- oder
Geheimnisschutzversprechen für beliebigen privilegierten Code. Nachgeladene
Programme/Netzwerkdaten sind ohne eigenen Vertrag nicht automatisch auf ihren
Inhalt festgelegt. Der Plan zeigt diese Autorität ausdrücklich. Dies ersetzt
keine einzelne Genehmigung und autorisiert keine unangekündigten destruktiven
Abnahmen. Ein Skriptneustart ist keine typisierte Rebootabnahme; fehlender
Abschluss bleibt `unknown` und wird nach Wiederkontakt nicht automatisch erneut
versucht. Exit0 belegt Prozessabschluss, keine beliebige fachliche Wirkung.
Abbruch/Fence/Timeout müssen während der Ausführung beobachtet und ehrlich
berichtet werden. Nur eigene Prozessgruppe beziehungsweise atomar zugewiesenes
Windows-JobObject und erhaltene Handles dürfen beendet werden. Keine Übernahme
fremder PIDs, kein globaler Kill und kein Anspruch, dass ein privilegiertes
Skript keine unabhängigen Dienste/Tasks erzeugen kann. Bereits eingetretene
Teilwirkung bleibt möglich; unklarer Abschluss bleibt `unknown`. Eigene laufende
Kinder/Handles und lokale Sperre bleiben bis belegtem Abschluss kontrolliert;
ein spätes Exit0 heilt keinen Timeout/Abbruch. Bestehende finale Rohbytes samt
Trunkierung werden unverändert gespeichert; WebUI/MCP erhalten die gespeicherten
Plan-/Ergebnisdaten im berechtigten Mandanten. Vollständige Skriptanzeige vor
Genehmigung und sichere Textdarstellung der abschließenden Ausgabe sind Pflicht,
kein behauptetes Livestreaming.
Dieser Abschnitt normiert den Vertrag und ersetzt keine Quellen-, Build-,
VM- oder Capabilitynachweise; aktuelle getrennte Belege stehen in
`deploy/linux/full-maintenance-README.md`. Zuerst Linux-Cloud-VM,
anschließend getrennte native Windows-VM-Abnahme; Notebook nur Entwicklung.
**Ausdrückliche Userentscheidungen Version1.18 — begrenzte Windowsfreigaben:**
Für jeden zuvor mit seinem unveränderlichen Plan in der WebUI genehmigten
Windows-PowerShell5.1-Jobprozess darf die feste Option `RemoteSigned` ausschließlich