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

67 lines
4.1 KiB
Markdown

# 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.
```sh
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.