11 KiB
Vorschlag für den engsten EXE-Vertrag nach Spezifikation1.19
Stand2026-11-14, Root-Reviewentwurf, nicht beschlossen oder implementiert. Spezifikation1.19 erlaubt an dieser Stelle ausschließlich den bestehenden MSI-Vertrag. Die folgenden Änderungen benötigen eine bewusste Präzisierung1.20 durch Root. Keine neuen Exporte, Capabilities, Policies oder Ausführungsgates wurden aktiviert. Der Sourcebuild ist kein nativer Installationsnachweis.
1. Exakt zwei eigene Artefakte und ein typisierter Plan
Ausgangspunkt ist der geprüfte Fixturebuild
build-e85496e8-b6dd-4834-8c17-843ee5c5b3da, Qualification-SHA256
f74c207e8fa6a9254759b103e8d81c962ec2becca9ee2feb9b1156fd395e1061.
Die Kandidaten sind bewusst unsignierte Entwicklungsartefakte:
| Ziel | EXE-SHA256 | Bytes |
|---|---|---|
| 1.0.0 | 9a972430614625b99985cd3db69f7f8f47e561c954697d57ba21e79fd5b787dc |
23040 |
| 1.1.0 | 196d22893eaea74d332782c597d4cbce631522006786a4aae074ad0a2bea8c89 |
23552 |
Nur diese beiden Artefakte gehören zum ersten EXE-Profil; kein beliebiges EXE
mit ähnlich benannten Registrywerten. Ein anderer Build braucht eine neue
explizite Profil-/Rezeptentscheidung und eigene Qualifikation. Die einzige
abgeleitete Argumentliste lautet --quiet --norestart; keine Argumentfelder,
URLs, Repair-, Uninstall-, Shell-, Dienst- oder Rebootoptionen.
Action::EnsurePackage erhält am Ende ein optionales
windows_exe_manifest: Option<Box<ResolvedWindowsExe>>. Fehlend wird als None
ausgelassen; vorhandenes null, Enum-Objekte und unbekannte Felder werden
abgewiesen. JsonSchema beschreibt die optionale Eigenschaft ohne null.
Genau eines von APT/MSI/EXE darf vorhanden sein. Alte APT-/MSI- und Linux-
Job-/Planbytes müssen unverändert bleiben; kein JobPayload-/Grant-/IPC-
Versionswechsel. Die Action ist ausschließlich execution_identity=system,
provider=exe, package=rmm-windows-exe-fixture, architecture=x64,
installation_context=machine, recipe_version=1, exakte Version und Recipe-ID.
Vorgeschlagene kanonische Feldordnung:
ResolvedWindowsExe:recipe,recipe_sha256.WindowsExeRecipe:schema_version=1,recipe_id,recipe_version=1,platform=windows,architecture=x64,context=machine,command_profile=exe_fixture_quiet_no_reboot_v1,artifact,postcondition,no_reboot=true, optionalespredecessor.artifact:artifact_id,sha256,bytes, mit exakt einem obigen Paar.postcondition:registry_hive=hklm,registry_view=64als strikter String,registry_key=SOFTWARE\\RustDiscovery\\ExeFixture,product_id=RustDiscovery.ExeFixture,product_version,payload_path=C:\\Program Files\\RustDiscoveryFixtures\\exe-payload.txt,payload_sha256,payload_bytes=33.
Die Recipe-IDs sind rmm-windows-exe-fixture-install-1.0 und
rmm-windows-exe-fixture-upgrade-1.1. predecessor ist für1.0 abwesend und
für1.1 zwingend die vollständige feste1.0-Nachbedingung, ebenfalls strict
nonnull/None-omit. Keine frei wählbaren Registrywerte oder Zielpfade.
recipe_version ist der String "1", nicht die JSON-Zahl1; schema_version
ist die Zahl1. Der Recipehash ist SHA256 der exakten Domain-Serialisierung einschließlich
Artifact-ID; alle folgenden Bindungen verwenden dieselben Bytes.
2. Tenantkatalog, Genehmigung und ausdrückliche SYSTEM-Obergrenze
Eine eigene immutable windows_exe_recipes-Tabelle folgt dem MSI-Muster:
Tenant-/Rezept-/Versions- und Tenant-/Recipehash-Eindeutigkeit, zusammengesetzter
FK auf Tenant/Artifact-ID/SHA/Bytes, FORCE RLS, nur SELECT/INSERT, Verbot von
UPDATE/DELETE. Import/List sind vom MSI-/APT-Katalog getrennt. Kein zusätzlicher
generischer Downloadpfad: pro Job genau eine automatische Artifactreferenz,
vollständige Recipe- und Artifactmengen des Plans; zunächst homogene EXE-Pläne.
Plan, Submit, WebUI-Genehmigung, Delivery, Permit und mTLS-Artifactdownload
prüfen dieselbe Bindung und die aktuellen Rechte erneut.
Bestehende Rechte operations:plan, operations:submit, plans:approve und
system:execute bleiben ihre jeweiligen Voraussetzungen. Policies genehmigen
weiterhin nichts. Eine neue zentrale und lokale SYSTEM-Policy/Settings-
Schema3 ergänzt höchstens zwei eindeutige allowed_exe_recipe_sha256.
Schema1 bleibt SCM-only, Schema2 SCM/MSI-only; beide verweigern EXE. Schema3
behält die vorhandenen MSI-Hashes und ergänzt EXE nur ausdrücklich. Das neue
optionale Feld fehlt in alten Serialisierungen; null und fremde Hashes werden
abgewiesen. Tenant/Asset/Agent/Generationen/Principals und Helper-Policy-/Binary-
Pins bleiben vollständig gebunden, allow_reboot=false bleibt Pflicht;
maximal120Sekunden Originalbudget und65536Ausgabebytes wie beim MSI-Profil.
Zusätzlich nötig sind die vorhandenen Windows-/Sync-/Helper- und
ensure_package/system:ensure_package-Capabilities sowie die neue enge
package.exe.fixture/1; keine allgemeine SYSTEM-EXE- oder Skriptautorität.
Alle bleiben bis getrennter nativer Qualifikation deaktiviert. Die WebUI zeigt
SYSTEM, Recipe-/Artifacthash, feste Argumente, Budget, Vorgänger und vollständige
Nachbedingungen ausschließlich aus verifizierten gespeicherten Planbytes.
Jobs/Payload/ResolvedTargets/Preview-Aliases und spätere Mutationen werden wie
bei MSI gegengeprüft; echte Domain-Goldenbytes verhindern None-/Feldordnungsfehler.
3. Derselbe Delegationskern, ein enger EXE-Provider
Der vorhandene mTLS-Client lädt nur das genehmigte Job-/Attempt-Artifact mit
exakter Länge/SHA und höchstens256KiB. Ein fest vorprovisionierter Actor-
Stagingbereich exe-stage und SYS-Cache <sha>.exe erweitern die vorhandenen
Cachehelfer über einen geschlossenen MSI/EXE-Typ, nicht über Callerpfade,
URLs oder IPC-Bytearrays. SYSTEM prüft erneut Parent-/Reparse-/ACL-/File-ID-
Bindung sowie Bytes/SHA, kopiert unabhängig in den geschützten Cache und hält
die eigenen Archivhandles. Fehlende Konfiguration führt zu not_configured;
keine implizite Ordner-/ACL-Reparatur.
OriginalRequest-/Grant-/Boot-/Helper-Lineage, Intent-CAS, dauerhafter Cancel- Deny, Abandon, RawFullTupleMirror und SignedSync werden nicht dupliziert. Historische und aktuelle Auth-/Clock-/Scope-/Policyprüfungen bleiben erhalten. Atomarer Helper-Start erfolgt vor Cache-/Installerwirkung; Abandon führt keine Cache-/Providerarbeit aus. Das ursprüngliche monotone Gesamtbudget umfasst Cache, Metadaten, Noop, Start, Beobachtung und Nachprüfungen. Frische Peer-/ Clock-/Fence-/Cancelprüfung unmittelbar vor Noop oder Start, ohne langlebigen SQLite-Lesesnapshot. Der letzte Read→Spawn-Abstand ist keine Rollbackgarantie.
Ein neuer enger EXE-Provider startet ausschließlich das gehaltene Cacheartefakt
mit den festen Argumenten, ohne Shell/Netz/weitere Prozesse. Die bisherige
UnsettledMsi-Verwaltung wird am vorhandenen Dispatcher zu einem geschlossenen
OwnedPackageChild::{Msi,Exe} erweitert: ein gemeinsamer gesperrter Slot und
Paketressourcen-Lock, OriginalRequest-/Grantbindung, Child- und Archivhandles.
Nach unklarem Timeout bleiben diese erhalten; keine weiteren MSI-/EXE-Starts,
bis derselbe Prozess nachweislich zur Ruhe gekommen ist. Kein globales Kill,
PID-Adoption, automatischer Retry oder nachträgliches Umschreiben des Unknown.
Helpercrash hebt die ursprüngliche Ledgersperre nicht auf. Cancel nach Start
liefert keine globale Prozessbeendigung oder Zusage zurückgenommener Wirkung;
derselbe Versuch wird weiter beobachtet und sein Ausgang ehrlich festgehalten.
4. Unabhängige Zustands- und Ergebnisregeln
Der Provider liest nativ ausschließlich HKLM64 und die feste Nutzdatei:
genau7 korrekt typisierte Fixturewerte, keine Unterkeys/Registrylinks; gehaltene
geschützte Nonreparse-Datei mit File-ID, genau33Bytes und festem SHA. Payload1.0
hat SHA 7b8019c151f3953261b3afbbea1b59ca7112ab09c7a2911d24d17921d6fd6adf,
Payload1.1 e1da48d2a8b89d66db822c24dc2ef7a0cfc13bce11875f15157d03081979d3f0.
Die übrigen Registrywerte/-typen stehen unverändert im Fixture-README.
Kein Erfolg aus stdout oder EXE-Exit allein, kein Win32_Product-Aufruf.
| Beobachtung innerhalb des Originalbudgets | Dauerhaftes Ergebnis |
|---|---|
| Unabhängig exakt gewünschter Zustand, frischer Fence | erfolgreicher Provider-Noop, kein Child, Exit=None |
| 1.0: vollständig leer; 1.1: vollständig exakt1.0 | einziger jeweils zulässiger Startbestand |
| Widersprüchlicher/teilweiser Bestand vor Start | verweigert, keine automatische Reparatur |
| Child Exit0 und unabhängige vollständige Zielnachbedingungen | erfolgreich; Prozessstart ist kein Beweis tatsächlich veränderter Bytes |
| Exakter Fixture-Exit10 vor eigener Mutation | failed; ursprünglicher Grant bleibt konsumiert, kein erfundenes NoStart/Unlock |
| Exit20 nach möglicher Teilwirkung | unknown, auch wenn der aktuelle Bestand zufällig vollständig erscheint |
| Unerwarteter Exit, unklare Beobachtung, überschrittenes Budget | unknown bei möglicher Wirkung, kein Retry/Retro-Success |
MSI-Codes3010/1641/1618 bekommen keine EXE-Sonderbedeutung. Der feste Fixturecode enthält keinen Rebootaufruf; Exit0 beweist keine allgemeine Rebootfreiheit beliebiger EXEs oder Abwesenheit eines ambienten Pendingflags. Nur der normale signierte Sync darf verbrauchte Ressourcen freigeben.
5. Kleinste Dateigrenze und fehlende Nachweise
| Bereich | Geplanter Eingriff nach Root-Entscheidung |
|---|---|
| Norm | Root: Spezifikation1.20, project-decisions, development; die beschriebenen engen Ausnahmen ausdrücklich festhalten |
| Domain | neu windows_exe.rs; lib.rs/jobs.rs additive Typen/Validatoren/Codec-Goldens, keine alten Feldänderungen |
| Backend | neuer EXE-Katalog und Migration nach0014; vorhandene Jobs/Policy/Gateway/Artifact-Routen um genau den neuen Typ ergänzen |
| WebUI | bestehende API/Safety/Main und betroffene Tests; verifizierte Projektion und eigener Katalogimport/-list |
| Windows | neuer exe_package.rs; vorhandene Cachehelfer, SYSTEM-Dispatcher/Settings, helper_runtime/runtime/lib; Intent-/IPC-Operationsvertrag unverändert |
| Core/Protocol | keine neue Zustandsmaschine, kein Unlock-/Grantcodec; Domain-gesteuerte Scopeprüfung nur falls technisch erforderlich additiv |
Bereits vorhanden: Fixture-Source-Review und lokaler GNU-Build mit ausgeführtem reinem Linux-Guard; Windows-Guard und Installer nur gebaut. Offen sind echte Linux→Windows-Guardabnahme, Domain/Schema-/RLS-/Plan-/Policy-/UI-Belege, nativer sicherer Cache-/PERSIST-/HKLM64-/File-ID-Nachweis sowie separat per WebUI genehmigte1.0-Installation,1.1-Upgrade und Noops/Fehlerpfade. Source, Build, native Unitqualifikation und echte Installerwirkung bleiben getrennte Abnahmeschritte. Vor deren Nachweis keine Ready-/Capability-/Clock-Gateflips; keine EXE-Ausführung auf dem Notebook.