Files
rust-discovery/docs/cloud-offline-acceptance.md
T
2026-11-13 20:33:14 +01:00

132 lines
8.2 KiB
Markdown

# Cloud-Abnahme: Offlinefenster, Ablauf und Genehmigungsentzug
## Erster tatsächlicher Preflight, noch kein Job
Fall`d9663783-9c8c-441a-808e-768bd72bd69a` brach bereits vor Planung/Antrag ab.
Die private Phase000 enthält nur den gesunden Ausgangszustand; kein Job wurde
zur Offlineabnahme angelegt. Tatsächliche operative Metadaten zeigten später
Agent-Autorestarts unter der Netzregel, unveränderte Agent-DB-Eigentümer993:984
und keine WAL/SHM-Dateien. Ein SQLite-Eigentümerproblem ist damit **nicht als
Ursache nachgewiesen**. Der normale Startpfad mit aktivem einmaligem
Online-Signierschlüsselbootstrap wird vor Fortsetzung geprüft/finalisiert.
Eigener420s-Rollback entfernte die Testregel; anschließend tatsächlicher
WSS-Kanal Generation86, signierter Sync bereit, `restore_blocked=false`,
Heartbeat19:22:22UTC. Zentrale weiterhin24Jobs/24Outbox/22Grants/0offen.
Private tatsächliche Belege im oben genannten Fallordner:
`preflight-complete-diagnostic.json`, `preflight-exit-metadata.json` und
`restored-central-state.json`. Fehlgeschlagene Probe ist kein bestandener
aktiver Offlinejob; die drei Abnahmefälle bleiben offen.
Der Probeadapter wurde zusätzlich so korrigiert, dass auch inaktive Dienste
und fehlgeschlagene Unterprozesse ausschließlich begrenzte Zustands-/Owner-/
Phasen-/Errnometadaten zurückliefern. Keine Rohstderr-/Credentialausgabe.
Feste numerische Probe-GID wird durch die geprüfte tatsächliche Agentgruppe
ersetzt; eigene neue SQLite-Sidecars werden defensiv korrekt zugeordnet und
Verbindungen ausdrücklich geschlossen. Diese Sourcekorrekturen sind noch
kein erfolgreicher vollständiger Offline-Nachweis.
## Einmaligen Onlinebootstrap tatsächlich abgeschlossen
Vorprüfung bestätigte tatsächlich`RMM_JOB_SIGNING_KEY_BOOTSTRAP=1` in der
ursprünglichen EnvironmentFile. `main.rs` führte dadurch den Netzwerkabruf
vor der Reconnect-Schleife erneut aus; unter der Sperre konnte der Agent nicht
dauerhaft offline starten. Bereits vorhandene nichtleere öffentliche
Agentbinding-, Agentcache- und Roothelper-Schlüssel sowie Generalidentity/-Pin
stimmten exakt überein, KeyID4338aabe… unverändert.
Nur Bootstrapkonfiguration finalisiert: eigener80-Dropin mit abschließendem
`UnsetEnvironment=RMM_JOB_SIGNING_KEY_BOOTSTRAP`. Ein bloßes`Environment=0`
würde gegen die ursprüngliche EnvironmentFile verlieren. Ursprüngliche Datei,
Bindings/Caches, Identität, drei Journale, Artefakte und Generalpins bis zum
normalen Neustart in Bytes/Inodes erhalten. Keine Schlüsselrotation, kein
Enrollment, keine Paketwirkung/Jobfreigabe oder neues Releaseartefakt.
Private tatsächliche Reports`devstate/cloud-offline/bootstrap-trust-{preflight,finalized,reconnected}.json`;
versionierter VM-Report unter`cloud-provisioned-trust-bb67cdda-7920-468b-a560-a4d81eb5894c`.
Der native Offlinejobnachweis folgt weiterhin gesondert.
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 zur festen
Agent-UID993 und primären GID der benannten Gruppe `rmm-agent`
und versucht nur einen TCP-Verbindungsaufbau zu Port443. Vor jedem neuen Plan
muss dieselbe Unit mit tatsächlicher Agent-UID/GID zunächst erfolgreich
verbinden, unter exakt wirksamer Sperre zweimal begrenzt scheitern und nach
Entfernen der Regel wieder erfolgreich verbinden. Während der Sperre muss
eine Kontrolle außerhalb der Agent-Cgroup erfolgreich sein; der Agent bleibt
aktiv, mit unveränderter PID/Restartzahl und unverändertem Rootledger.
`EACCES`/`EPERM` oder zwei Timeouts zählen nur zusammen mit diesen Kontrollen.
Ein isolierter Timeout genügt nicht. Das spätere Jobfenster prüft dieselbe
Regel erneut mit Außenkontrolle und zwei inneren Proben; Wiederherstellung
verlangt erneut eine erfolgreiche innere Verbindung. Die Proben
lesen keine Agentenidentität oder Zugangsdaten und senden keine Anwendungsdaten.
Die TLS-Prüfungen des echten Agenten bleiben erhalten.
Tatsächlich beobachtet wurde bei aktivem Agent ohne Neustarts unter der
Paketregel ein TCP-Timeout ohne Errno. Die frühere Forderung ausschließlich
nach`EACCES`/`EPERM` war für diesen nativen Pfad falsch; daraus wird keine
erfolgreiche Offlineabnahme abgeleitet. Systemd255 beschreibt
`IPAddressDeny` als Ein-/Ausgangs-Paketfilter und verspricht keinen bestimmten
Connect-Errno. Quelle: [systemd255 resource-control](https://www.freedesktop.org/software/systemd/man/255/systemd.resource-control.html).
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.
Lesende Zustandsabfragen und das Entfernen exakt dieser eigenen Netzregel
bleiben auch bei einem späteren `unknown` oder Fault möglich. Nur eine neue
Sperrinstallation verlangt einen vollständig geklärten Ausgangszustand;
Transportcleanup verändert keine Job-, Journal- oder Genehmigungsgrenze.