Prepare fixed EXE fixtures and qualify pure preconditions on cloud Linux
Rust development slice / linux (push) Failing after 6s
Rust development slice / linux (push) Failing after 6s
This commit is contained in:
@@ -0,0 +1,165 @@
|
||||
# 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`, optionales `predecessor`.
|
||||
* `artifact`: `artifact_id`, `sha256`, `bytes`, mit exakt einem obigen Paar.
|
||||
* `postcondition`: `registry_hive=hklm`, `registry_view=64` als 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.
|
||||
Reference in New Issue
Block a user