Files
rust-discovery/docs/cloud-offline-acceptance.md
T
2026-11-13 19:47:22 +01:00

4.1 KiB

Cloud-Abnahme: Offlinefenster, Ablauf und Genehmigungsentzug

Stand: Adapter implementiert und lokal auf Python-/Node-Syntax sowie identische Skriptbytes zwischen Orchestrator und Browser geprüft. Noch kein nativer VM-Nachweis aus diesem Adapter. Die folgenden Befehle sind geplant, nicht ausgeführt. Alle Ergebnisse entstehen als private, fortlaufende JSON-Belege in devstate/cloud-offline/<UUID>/.

Der Adapter verwendet ausschließlich die bestehende Cloud-Linux-VM und den festgelegten Cloudserver. Das Notebook betreibt keinen Agenten oder Server. Er setzt einen gesunden signierten Reconnect, keine offenen Wirkungen und den geprüften aktuellen Agentenhash aus devstate/remote-vm.json voraus.

python3 deploy/cloud_offline_acceptance.py --execute-dev-test-ui --case offline_wait
python3 deploy/cloud_offline_acceptance.py --execute-dev-test-ui --case expired_offline
python3 deploy/cloud_offline_acceptance.py --execute-dev-test-ui --case revoked_before_start

Jeder Aufruf erzeugt einen eigenen unveränderlichen Plan mit genau einem zukünftigen agent_service-Skriptjob. MCP erstellt Plan und persistenten Antrag; vor der Genehmigung müssen Jobs, Outbox und Startgrants jeweils null sein. deploy/browser/cloud_offline_acceptance.cjs prüft alle Planbytes und betätigt den echten WebUI-Genehmigungsknopf mit dem sichtbar simulierten Testprincipal. Der dritte Fall verwendet zusätzlich das vorhandene WebUI-Control „Planberechtigung widerrufen“ mit Bestätigungskennung. Keine Freigabe oder Widerruf wird über einen direkten API-/DB-Aufruf ersetzt.

Ein Agentstopp allein gilt nicht als Offline-Nachweis. Der Adapter prüft vor dem ersten Job die tatsächliche systemd-BPF-Funktion: Nur für rmm-agent-remote.service wird die feste Serveradresse 88.99.80.202/32 gesperrt. Ein separater Bootstrap-Prozess verschiebt ausschließlich seine eigene PID in die tatsächliche Cgroup dieses Dienstes, wechselt zu UID/GID 993 und versucht nur einen TCP-Verbindungsaufbau zu Port 443. Ausschließlich EACCES oder EPERM bestätigt die Sperre; ein Timeout genügt nicht. Der Probe liest keine Agentenidentität oder Zugangsdaten und sendet keine Anwendungsdaten. Die TLS-Prüfungen des echten Agenten bleiben erhalten.

Nach der dauerhaften Jobannahme werden vor der Sperre erneut null Grants, Consumption-Einträge und Wirkungen geprüft. Während des Offlinefensters muss der Agent aktiv bleiben, seine Reconnect-Versuche dauerhaft zählen und auch über not_before hinaus ohne Grant oder Effekt bleiben. SSH und Helper sind von der Netzsperre unabhängig. Die bereits vorhandenen Root-Consumption- und Start-/Outcome-Belege müssen dieselben Hashes behalten. Der kurze operative Stopp zum Einrichten der Regel zählt nicht zum Nachweis; der Agent muss bereits vor not_before wieder aktiv und tatsächlich gesperrt sein.

  • offline_wait: Netz vor Ablauf wiederherstellen; ein neuer gesunder signierter Sync muss vor genau einer Startreservierung liegen. Erwartet sind ein Grant, ein Consumption-Eintrag und der gespeicherte Effektzähler 1. Danach denselben ursprünglichen Submit mit demselben Plan und Schlüssel noch innerhalb der ursprünglichen Frist beobachten: dieselbe Operation, unverändert1Job/1Outbox/1Grant. Die eigene private Idempotenzreceipt bindet diese Beobachtung an den späteren rein lesenden MCP-Referenzbericht.
  • expired_offline: Sperre bis hinter die feste Startfrist halten; anschließend expired, null Grants und keine Wirkung nachweisen.
  • revoked_before_start: Genehmigung während der Sperre tatsächlich in der WebUI entziehen; nach dem Reconnect cancelled, null Grants und keine Wirkung einschließlich interaktivem Widerrufsaudit nachweisen.

Ein vorab eingerichteter Timer entfernt nach 420 Sekunden ausschließlich die eigenen unveränderten Drop-in-Bytes und stellt den normalen Agententransport wieder her. Diese Frist liegt hinter der festen Jobfrist. Ein fehlgeschlagener Aufruf wird nicht automatisch wiederholt; seine Belege und Jobs bleiben zur Auswertung erhalten. Das Skript besitzt keinen Journal-, Identitäts- oder Consumption-Reset.