Files
rust-discovery/docs/cloud-offline-acceptance.md
2026-11-13 21:12:57 +01:00

232 lines
14 KiB
Markdown

# Cloud-Abnahme: Offlinefenster, Ablauf und Genehmigungsentzug
## Genehmigungsentzug nativ bestanden; alle drei Offlinefälle belegt
Fall`68148362-e21e-4bd0-9126-12e5a6e03945`: eigener fester tatsächlicher UI-Klick
nach pending0/0/0, dauerhafte Annahme ohne Grant, geprüfte aktive Netzsperre.
Die spätere echte WebUI-Widerrufshandlung war erfolgreich: gleicher Plan/
Operation, simuliertes Principal/Audit samt interaktiver Sitzung und genau eine
widerrufene Autorisierung. Der Browserrunner scheiterte **nach** diesem Klick
an seinem Warten auf das kurzlebige Ergebnis-`pre`; der Planreload kann den
AdminControl-Ergebnisbereich neu aufbauen. Kein erneuter Klick/Antrag.
Stattdessen derselbe Fall kontrolliert fortgesetzt: vorhandenes Audit nur
gelesen, Originalplan/Hashes erhalten, derselbe Agent-PID vor/nach frühestem
Start aktiv und Reconnectsequenz3465→3473, eingefrorener Kontakt vor Start,
weiter0Grants/0Verbrauch/Zählerabsent. Normale Netzregelwiederherstellung
**innerhalb** der ursprünglichen Startfrist, frischer Kanal96/Sync ready um
20:10:21UTC vor`start_before`20:11:24UTC. Ergebnis ausdrücklich`cancelled`,
1Job/1Outbox/**0Grants**/0offen, keine Wirkung/keine Rootledgeränderung.
Diese Abnahme benutzt Vorher-/Nachherbelege und echten Auditnachweis; keine
nachträglich erfundenen lückenlosen Zwischenmessungen.
Private Belege im Fallordner:`ui-revoke.json`,
`revoke-after-browser-error.json`, `observed-revocation-before-restore.json`,
`observed-revocation-native-accepted.json` mit verifiedtrue.
Der Browser prüft künftig die natürliche tatsächliche POST-Antwort derselben
UI-Handlung statt des transienten Ergebnisbereichs. Nur Syntaxprüfung dieses
Runnerfixes, kein zweiter Widerrufsjob als vermeintlicher Erstnachweis.
Alle drei Offlinevarianten sind nun nativ belegt; Crash/Reboot bleiben offen.
## Wiederholter Nichtstart-Sync nativ korrigiert
Gezielter Agentfix qualifiziert und auf der Cloud-VM ausgeführt.20 echte
SQLite-/Signatur-Reconciletests ohne Skips, Format und Agent-Alltargets-Clippy
bestanden. Grantfreie accepted/expired/cancelled-Zeilen behalten das Nichtstart-
Label; tatsächlich vorhandene Verbrauchszeilen überschreiben es weiterhin.
requesting/running/unknown und überlebende Grants bleiben gesperrt. Keine
Serverlockerung und keine Änderung von Helperbbd/Provider1dc/M4Runtime3bac.
Agent702bd7b5… auf vorhandener Identität und unveränderten Journalbytes vor
Neustart installiert. Normaler ausgehender Kanal Generation93 und signierter
Sync wieder bereit, restore_blockedfalse. Derselbe ursprüngliche Ablaufjob
40edcd4b… jetzt korrekt`expired/DEFINITIVE_NONSTART`, Grantnull, revision0,
unlockfalse;26Jobs/26Outbox/23Grants/0offen unverändert. Keine Repair-CLI,
manuelle DB-/Outcomeänderung oder erneute Ablaufwirkung.
Private Belege`devstate/cloud-apt-recovery/nonstart-agent-install.json`,
`agent-nonstart-sync.json` und`nonstart-sync-native.json`.
UI-Entzug, Crash und Reboot bleiben offen.
## Nach Ablauf gefundene Sync-Klassifikationslücke
Vor dem nächsten Fall stoppte der Bereitschaftsguard; Fall09fc228c-e339-409a-
af1c-afe1a9fa9aaa hat **keinen** Plan/Antrag/Job erzeugt. Gespeicherter signierter
Sync zeigt genau den vorherigen Ablaufjob40edcd4b-99c5-43e7-8562-ccdda86c4031
als`GRANT_OR_EFFECT_UNRESOLVED`. Tatsächlich zentral und lokal expired/revision0,
Grantleer, keine Resultbehauptung; zentral`start_reserved=false`,0Permits und
0Startaudits, beide Consumptionledgers ohne diesen Versuch. Alle15Rootwirkungen
geschlossen/faultfrei, Journalintegrität und Kerneluhr geprüft, kein Platzmangel.
Ursache: Nach der ersten signierten Nichtstart-Expiry bezeichnete der Agent
denselben grantlosen terminalen Nichtstart beim nächsten Snapshot als
`uncertain`; nur`accepted` bekam das Label`unconsumed`. Der Server verweigert
dieses widersprüchliche Bild korrekt. Eine reine Serverlockerung genügt zudem
nicht, weil auch der Agent terminale beweislose Ergebnisse bei`uncertain`
verweigert. Notwendige Korrektur bleibt auf die richtige Agentklassifikation
des belegten Nichtstarts begrenzt; vorhandene Verbrauchszeilen haben weiterhin
Vorrang, requesting/running/unknown bleiben gesperrt. Noch nicht als native
Korrektur abgenommen; keine Datenbank-/Freigabe-/Unlockabkürzung.
Private tatsächliche Readbacks`09fc.../sync-{server,vm}.json` und
`expired-attempt-{server,vm}.json`; zentrale Historie26/26/23/0 unverändert.
## Eigenständiger Ablauf bei aktivem Offlineagent bestanden
Fall`5869480b-d06c-450c-8163-838bf2dda6bc` tatsächlich bestanden: eigener fester
WebUI-Antrag0/0/0, angenommen und ohne Grant offline über`not_before` **und**
`start_before` gehalten. Derselbe Agentprozess blieb aktiv, Reconnectsequenz
stieg, Serverkontakt blieb eingefroren. Erst nach Ablauf wiederverbunden;
Ergebnis ausdrücklich`expired`,1Job/1Outbox/**0Grants**,0offen. Keine native
Consumption und kein Effektzähler. Eigene Transportregel wieder entfernt,
positive TCPkontrolle/normaler signierter Wiederkontakt belegt, Rootledger
unverändert. Verifizierter abschließender nummerierter Checkpoint im Fallordner.
Genehmigungsentzug und Prozessabbruch bleiben eigenständige nächste Abnahmen.
## Aktiver Offlinefall mit Start nach gültigem Wiederkontakt bestanden
Tatsächlicher Cloudfall`8d2d0d7c-f844-48b6-bb8d-b9d00c229c5b` bestanden.
Vollständiger positiver Vorher-/Nachher-TCP-Kontrollpfad derselben Cgroup/UID993/
GID984, positive Außenkontrolle und zwei echte innere Denials. Danach eigener
fester WebUI-Plan: vor Klick0Jobs/0Outbox/0Grants. Dauerhaft angenommen, vor
Start wieder aktiv offline; auch über`not_before` blieb derselbe Agentprozess
aktiv, dauerhafte Reconnectsequenz stieg, null Grants/Consumption/Wirkung,
kein neuer Serverkontakt. Vorfristiger normaler Wiederkontakt lieferte einen
frischen gesunden signierten Sync **vor** genau einer Startreservierung.
Ergebnis succeeded,1Job/1Outbox/1Grant/0offen, nativeConsumption1 und Zähler1.
Vorhandene Rootledger-/Outcomehashes unverändert, keine neue Rootwirkung.
Innerhalb der ursprünglichen Plan-/Startfrist derselbe MCP-Submit mit demselben
Plan und Idempotenzschlüssel tatsächlich wiederholt: dieselbe Operation,
unverändert1/1/1. Eigene private Receipt und vollständiger verifizierter
Checkpoint`029-native_dev_test_accepted.json` im Fallordner gespeichert.
**Noch offen:** eigene Ablauf-/UI-Entzugsfälle, Crash und übriger MVP-Abschluss.
## 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.