Files
rust-discovery/docs/script-console-policy-scope.md
2026-11-14 18:48:48 +01:00

257 lines
15 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Begrenzter Policy- und MCP-Root-Bootstrap für die Linux-Skriptkonsole
`deploy/script_console_policy_scope.py` ist eine getrennte Opsquelle. Sie verändert
keine158Frozen-Produktdateien, Migrationen, Agenten, Units, Serverflags, Images,
Tokens oder Sitzungen. **Aktueller korrigierter Quellstand lokal geprüft, noch
nicht auf dem Server ausgeführt; früherer Vorwirkungsabbruch unten dokumentiert.**
Kein tatsächlicher Scope oder Actor wurde durch den Subagenten
geändert; Native-Attestation und Zielbelege werden nicht erfunden.
## Konkrete Autorisierungsentscheidung
Der User hat AI/MCP-Skriptplanung mit ausdrücklich erlaubten Rootrechten und
separater menschlicher WebUI-Genehmigung beauftragt. Der Hauptagent stellte
öffentlich und rein lesend fest: Der bestehende Actor
`automation:11111111-1111-4111-8111-111111111111` besitzt sieben Standardrechte,
jedoch kein `root:execute`. Der simulierte UI-Actor besitzt Root- und
Genehmigungsrechte. `jobs::plan` verlangt Rootberechtigung und passenden Rootscope
bereits vom Planersteller; spätere Prüfungen beziehen sowohl ursprünglichen
Planersteller als auch UI-Genehmiger ein. Ein ausschließlich auf den simulierten
Principal begrenzter Scope kann deshalb den beauftragten MCP-Rootablauf nicht
tragen.
Der Hauptagent hat auf Grundlage dieses Userauftrags den separaten, konkreten
Bootstrap zur Ergänzung ausschließlich `root:execute` für genau diesen bestehenden
Dev/Test-Automation-Actor angeordnet. Dies ist MVP-Konfiguration und keine
Jobgenehmigung. Kein allgemeines Rollenupdate und kein Defaultwechsel anderer
Tenants wird implementiert. Der Token bleibt derselbe; `plans:approve`,
`plans:revoke`, `system:execute`, Sessions und Tokens werden nicht hinzugefügt.
Die interaktive Genehmigungsgrenze bleibt auch bei vorhandener Root-Planungs-
berechtigung bestehen.
## Zwei bewusst getrennte Vorgänge
1. `prepare-mcp-root-local` und `provision-mcp-root`: einmalige Ergänzung genau
eines Rechts, ausschließlich bei geschlossenem bekannten Rootpolicybestand.
Kein automatisches Öffnen eines Scopes.
2. `prepare-local`, `open`, `read`, `close`: separat geprüftes15-Minuten-Fenster
für genau ein tatsächlich qualifiziertes Cloud-Linuxziel, beide bestehenden
Actor-IDs und exakt den Fullpolicy-/Helpercodepin. `open` verändert keine
Memberships. `close` restauriert ausschließlich die eigenen gesicherten alten
Policybytes.
Jeder Vorgang hat eigenen unveränderlichen lokalen/entfernten Intent, UUID,
Source-/Supporthashes, lokalen Aufrufmarker vor SSH und entfernte Einmalmarker
vor Wirkung. Antwortverlust oder Fehler nach einem Aufruf erlaubt ausschließlich
`read` desselben Cases, keine Wiederholung, keine neue Frist und keinen neuen
Case als automatische Reparatur.
## Separates MCP-Recht: genaue Transaktion
Die feste Vorbedingung ist exakt der vorhandene Actor mit Kind `automation`,
`revoked_at:null` und dieser unveränderten geordneten Rechtefolge:
```text
inventory:read, logs:read, operations:read, operations:plan,
operations:submit, jobs:cancel, scripts:execute
```
Der Bootstrap verlangt das explizit von Root überprüfte tatsächliche Runtimeimage
auf beiden Rollen, Development-/Devlogin-Konfiguration, unveränderte Rootflags
und das bekannte Read-only-Policymount. `/auth/config` wird privat über korrekt
verifiziertes API-TLS mit `api-pki/ca.pem` und Name `localhost` gelesen. Die
Rootpolicy muss exakt Hash
`cf15cbb68b590475df6def28e7dcffb7d88e0ca2d2555a06174fb654eeff05f4`,
Schema1/Development und bereits abgelaufen sein. Der Tenant hat genau30Jobs,
30Outboxzeilen,26Permits und keinen offenen/unklaren Job.
Ein neues rootprivates Historyverzeichnis erhält Intent und vollständigen
öffentlichen Vorherbeleg. Der entfernte `provision-entered`-Marker wird vor SQL
fsync-gesichert. Danach läuft genau eine feste Transaktion:
- `BEGIN ISOLATION LEVEL SERIALIZABLE`, expliziter Tenantkontext.
- `UPDATE memberships SET permissions=array_append(permissions,'root:execute')`
ausschließlich mit festem Tenant/Actor, Kind, Revocation-NULL und exaktem
Array-CAS sowie erneutem30/30/26-/Closed-Prädikat im Statement.
- `RETURNING` liefert nur öffentliche Actorfelder. Ein Count0 führt über den
tatsächlichen Countassert zu einem Transaktionsfehler vor `COMMIT`;
`ON_ERROR_STOP` beendet psql, die Verbindung rollt zurück. Genau eine Zeile ist
aufgrund des vorhandenen Tenant-/Principal-Primärschlüssels möglich.
- Nach Commit müssen ausschließlich die fest erwarteten acht Actorrechte
vorliegen. Alle anderen Membershipzeilen werden über einen konsistenten
SHA256-Fingerprint verglichen; Job-/Outbox-/Permitzähler und geschlossene
Policybytes/Inode sowie Rollen/Flags bleiben erhalten.
SQL-/Vorher-/Nachher-/Ergebnisbelege sind privat und create-once. Eine verlorene
Commitantwort wird niemals als fehlender Commit interpretiert; `read` zeigt
tatsächlichen Actorzustand und erhaltene Marker. Es gibt keinen Schreibpfad zu
Authorizations, Jobs, Outbox, Grants oder Auditgenehmigungen.
## Temporärer Fullscope und seine Belege
`prepare-local` verlangt den Pfad zu einer tatsächlichen `attested.json` und den
vom Hauptagenten ausdrücklich akzeptierten vollständigen SHA256. Der Loader
verlangt die bestehende Post-Attestation-Form mit drei Originalsamples samt
Hashbindung, bestätigter Erhaltung, normalem signiertem Sync, zwei gespeicherten
Heartbeatfortschritten, Queuekonvergenz und Tenant-RLS-Verweigerung. Tatsächliche
Rootprozesse, Fullpin und Codehash in den Samples müssen zusammenpassen. Ohne
diesen fertigen akzeptierten Beleg entsteht kein lokaler Scopeintent.
Die Policy hat genau einen Schema2-Scope: konkreter Tenant/Asset/Agent und
Generationen aus dem nativen Fullpin, die zwei festen Principal-IDs, tatsächlicher
Fullpolicyhash und laufender Helpercodehash, `allow_root_scripts:true`,
`allowed_script_profiles:[full_maintenance_v1]`, leere Servicesliste,
`allow_reboot:false`, keine APT-/Rootlogfelder. Die Frist wird bei lokaler
Vorbereitung unveränderlich auf900Sekunden festgelegt und beim Öffnen nochmals
gegen die Serverzeit geprüft. Vergangene, künftig beginnende oder längere
Freigaben sowie Scope0 werden verweigert.
`open` verlangt zusätzlich frisch gespeicherte authentifizierte Online-/Sync-
Zustände, den gleichen Boot und passende Generationen, beide Fullcap-Pins,
Migrationen1–14 und keine ungeschlossenen Jobs. Beide tatsächlichen Memberships
werden erneut geprüft. Automation muss exakt die separat bereitgestellten acht
Rechte haben; der simulierte Genehmiger braucht seine bestehenden Plan-, Skript-,
Root- und UI-Genehmigungsrechte. Es werden keine Rechte erzeugt, wenn sie fehlen.
Vor dem Öffnen wird der alte geschützte Policybestand erneut auf genauen
`cf15…`-Hash und abgelaufenes Schema1 verglichen. Rootprivate Originalbytes und
vollständige Dateimetadaten werden erhalten, anschließend der Einmalmarker
geschrieben. Die unveränderlichen Kandidatbytes werden mit Eigentümer10001 und
Modus0600 auf demselben Dateisystem vorbereitet; unmittelbar vor einer einzigen
atomaren Ersetzung werden alte Bytes und Inode nochmals verglichen. Danach
werden tatsächliche neue Bytes und unveränderte Rollen/Flags belegt. Keine
Dienstaktion und keine Datenbankschreiboperation ist Teil von `open`.
`close` benötigt keinen noch online erreichbaren Client und keine frischen Caps:
eine Schließung darf auch nach Ablauf oder bei Offlinezustand erfolgen. Es
akzeptiert nur den eigenen unveränderten Remoteintent, den erhaltenen `open`-
Marker, exakte eigene aktuelle Kandidatbytes und den eigenen originalen
`cf15…`-Backupbestand. Fremde oder nachträglich geänderte Policies werden niemals
pauschal ersetzt. Der Close-Marker wird vor Wirkung gesichert; ein weiterer
Bytes-/Inode-CAS erfolgt vor der atomaren Restaurierung. Alte Policybytes,
Eigentümer, Gruppe, Modus und mtime werden wiederhergestellt und ihre abgelaufene
Grenze geprüft. Die atomare Ersatzdatei hat nachvollziehbar einen neuen Inode;
historische Inode-/ctimewerte bleiben im unveränderten Beleg, nicht als behauptete
Wiederherstellung. Alle Historydateien und Runtime-Tags bleiben erhalten.
`read` erstellt weder Casepfad noch Lock und führt keine Reparatur aus. Auch ein
fehlender Case oder Policy-Lesefehler erlaubt Readback anderer erhaltener Felder.
Ein gleichnamiger fremder Intent wird verweigert. Die Worker dieser Quelle
serialisieren Policy-/Membership-Änderungen über einen geschützten Lock; parallele
ältere Root-Policyschreiber müssen durch den Hauptagenten ausgeschlossen werden.
Der Lock behauptet keine Kontrolle über andere Rootprogramme.
## Geplante Bedienung, nicht ausgeführt
Erst nach Rootreview der eingefrorenen Quelle und des konkreten Intents:
```text
python3 deploy/script_console_policy_scope.py prepare-mcp-root-local --expected-server-image sha256:ROOT_REVIEWED_ACTUAL_IMAGE
python3 deploy/script_console_policy_scope.py provision-mcp-root --id ACTOR_CASE --execute-mcp-root-provision
python3 deploy/script_console_policy_scope.py read --id ACTOR_CASE
python3 deploy/script_console_policy_scope.py prepare-local --attestation /path/to/actual/attested.json --accepted-attestation-sha ROOT_ACCEPTED_SHA256 --expected-server-image sha256:ROOT_REVIEWED_ACTUAL_IMAGE
python3 deploy/script_console_policy_scope.py open --id SCOPE_CASE --execute-policy-open
python3 deploy/script_console_policy_scope.py read --id SCOPE_CASE
# Danach separat: MCP-Antrag → pending0 → tatsächlicher UI-SIM-Klick → Ergebnis.
python3 deploy/script_console_policy_scope.py close --id SCOPE_CASE --execute-policy-close
python3 deploy/script_console_policy_scope.py read --id SCOPE_CASE
```
Platzhalter sind absichtlich nicht ausführbar. Der bestehende Hauptcheckout mit
geschützter `credentials/server.conf` ist der Standard-SSH-Zugangsroot; es gibt
keinen Linux-VM-Aufrufpfad. Ausschließlich der bereits unabhängig vertraute
Cloudserver88.99.80.202 bzw. dessen fester Name ist zulässig. SSH ist
Bootstraptransport, keine Job- oder Approvalautorität.
## Semantikgrenzen
Ein Scope begrenzt/verweigert, genehmigt aber niemals einen Job. Die zentrale
Profilzulassung bleibt additiv und wird nicht als allgemeiner Ausschluss aller
Legacy-Rootskripte dargestellt; dies ist nach dem MVP vorgemerkt. General/APT
bleiben lokal unverändert gebunden/gesperrt. Leere typisierte Service-/Reboot-/
APT-Rechte sind keine Sandbox eines ausdrücklich genehmigten Fullskripts. Der
konkrete später genehmigte Plan bindet vollständige Skriptbytes, Fullprofil,
Identität, Ziel/Versuch, Budgets und Fristen. Root-/Helperpins, Uhr, Peer,
Consumption, Startgrant und WebUI-Genehmigung werden weiterhin unabhängig geprüft.
## Tatsächliche lokale Prüfungen
- Python-Syntax und beide getrennten Intentformen geprüft, nur temporäre
synthetische Attestationsfixtures. Unbekannter akzeptierter Hash und geänderte
Originalsamplebytes werden verweigert. Kein tatsächlicher Nativebeleg wurde
dadurch erzeugt oder als akzeptiert markiert.
- Acht Kandidatenabweichungen, vergangene/künftige/zu lange Öffnungsfenster,
fremde Close-Policy, Wiederholungsmarker und rein lesendes Verhalten bei
fehlendem Case geprüft. Frozen158 und Deployment-v2 bleiben byteidentisch.
- Die **tatsächliche aus der Quelle extrahierte** SQL-Transaktion wurde auf einer
frischen isolierten PostgreSQL-Fixture mit `--network none`, ohne Ports oder
reale Zugangsdaten ausgeführt: exakt ein7→8-Rechte-Commit erfolgreich; zweiter
Aufruf, abweichende Ausgangsrechte und offener Job abortieren vor Commit ohne
Überschreiben. Anderer Tenantactor unverändert. Die Fixture bildet nur das
benötigte Schemasubset ab und ist kein RLS-/Produktionsnachweis; der eigene
Testcontainer samt Testvolume wurde anschließend entfernt.
Belege stehen unter `devstate/script-console-policy-scope-local-review/`.
Reale Native-Attestation, Serverrollen, Membership-CAS, Policyöffnung/-schließung,
UI-Genehmigung und Jobwirkung sind erst durch den Hauptagenten auszuführen und
getrennt nachzuweisen. Die lokalen Tests geben keine Serverfreigabe vorweg.
### Tatsächlicher erster Provisionierungsversuch und Parserkorrektur
Der Hauptagent führte den ersten expliziten Provisionierungsversuch
`6ba73b0b-b42f-42d6-966a-62d523315ee8` mit Source
`cb7f0984a0f98065018e8f190bedba1454bf53347c3280751e4d0ccf39a21624`
aus. Er brach vor entferntem Case und vor SQL ab. Der unabhängige Rootreadback
meldete Casefehlend, Actor weiterhin exakt sieben Rechte, Policy unverändert
`cf15…` mit Inode649002 und Zähler30/30/26/0; Rollenprobe meldete ValueError.
Allenfalls der eigene Serialisierungslock wurde angelegt. Keine Scopeöffnung,
Membership-, Policy-, Job- oder Kernelwirkung wird daraus behauptet.
Die Ursache wurde anschließend lokal am unveränderten alten Parser reproduziert:
Docker fügt nach dem ausgewählten Go-Template eine zusätzliche Leerzeile hinzu.
Dies wurde tatsächlich mit demselben Template gegen ein öffentliches lokales
Toolimage ohne ausgewählte RMM-Werte beobachtet; keine Zielumgebung oder Secrets
wurden dafür gelesen. Der bisherige dict-Generator verweigerte diese Zeile mit
ValueError.
Die enge Korrektur ignoriert ausschließlich leere Zeilen. Jede nichtleere Zeile
muss weiterhin ein Gleichheitszeichen, einen ausdrücklich erlaubten Schlüssel
und einen noch nicht vorhandenen Schlüssel enthalten; unbekannte, doppelte,
fehlformatierte und bloß aus Leerzeichen bestehende Zeilen werden verweigert.
Werte werden nicht getrimmt oder normalisiert. Alle Flags, Valuechecks,
Zählergates, Rechte-CAS und Mutationspfade bleiben unverändert.
Vor der Änderung wurden alte Sourcebytes und sämtliche fünf vorhandenen lokalen
Case-Dateien create-only unter
`devstate/script-console-policy-scope-source-history/` erhalten. Der alte Case
wird nicht wiederholt oder mit dem neuen Sourcehash umgedeutet. Ein neuer Case
ist erst nach Rootreview zulässig. Bei Bedarf kann Root den unveränderten alten
Reader anhand des archivierten Hashes unter deploy rekonstruieren; ein
Readbackfehler wird nicht als fehlende oder erfolgreiche Mutation ausgelegt.
## Tatsächlich provisioniertes MCP-Planungsrecht
Nach Rootreview der Quelle11b4450a wurde der separate neue Fall
`0daffbc0-64df-486c-8df1-8ae5e0a0215c` genau einmal ausgeführt und zusätzlich
lesend geprüft: der bestehende Automation-Testprincipal von DevelopmentA hat
nun genau seine bisherigen sieben Rechte plus `root:execute`. Andere
Mitgliedschaften blieben bytegleich; der Ausdruck erlaubt keine Genehmigung.
Keine Approval-/SYSTEM-/Token-/Sessionrechte wurden ergänzt, kein Job oder
Startgrant erzeugt. Zentrale Rootpolicy bleibt exaktcf15 und abgelaufen,
gleicher Inode; alle drei Zähler30/30/26 und ungeklärt0 blieben erhalten.
Der frühere Fall6ba73b0b bleibt ein unveränderter Vorwirkungsfehler: tatsächliche
Docker-Ausgabe enthält nach den sieben ausgewählten öffentlichen Envzeilen eine
Leerzeile. Der alte dict-Parser verweigerte davor mitValueError; Remote-Case
fehlte, Actor hatte nachweislich weiterhin sieben Rechte. Die neue Quelle
überspringt ausschließlich leere Zeilen und verweigert unzulässige, doppelte oder
unbekannte nichtleere Felder. Kein Wiederholen des alten Mutationsfalls.
Ein temporärer Full-Ausführungsscope wurde damit noch nicht geöffnet. Der erste
Root-MCP-Auftrag benötigt weiterhin den akzeptierten aktuellen Nativebeleg,
separate begrenzte Policyöffnung und die tatsächliche interaktive WebUI-Freigabe
seines unveränderlichen Plans. Der gesonderte Provisionierungsschritt folgt dem
expliziten Userauftrag für AI/MCP-Rootwartung und ist keine Jobgenehmigung.