Files
rust-discovery/docs/server-deployment.md
T
2026-11-13 16:04:20 +01:00

436 lines
27 KiB
Markdown
Raw 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.
# Dedizierter RMM-Server
Stand: 2026-11-13 · Spezifikation 1.9 · Linux-MVP weiterhin nicht abgenommen.
## Neuester APT-/Bootstrapstand
**Neuester Versuch:** Hook armed/APT 0, aber Fixture 1.0 laut gespeicherten Logs
nur unpacked, Nachprüfung `DPKG_INCONSISTENT`, Ergebnis **unknown**. Ledger9/1
unresolved, zentrale13/13/12; Rootpolicy geschlossen, kein weiterer Paketversuch.
Windowsprobe bestanden, LocalService/mTLS/Heartbeat online, Inventar-SQL-Migration
offen. Aktuelle Details in `implementation-status.md`; folgende Zwischenstände
nicht als heutigen finalen Erfolg lesen.
**Fortsetzung:** Signierter einzelner Retryvertrag implementiert, neue
Helper-Sandboxreadiness auf Cloud-VM bestanden. Cloudserver und Linux-Agent
identitäts-/journalbewahrend aktualisiert, Linux online/sync-ready. APT-Endpunkt
wieder aktiv, befristete ausschließlich begrenzende APT-Testpolicy; noch kein
neuer Paketjob. Zähler unverändert 12/12/11. Windows-Inventarserverpfad bereit,
nativer Windows-Clientnachweis noch offen. Neueste Details:
[implementation-status.md](implementation-status.md). Die folgenden Angaben
sind der vorige abgeschlossene Snapshot.
APT-Ursache und Sourcekorrektur nativ eingegrenzt/geprüft: `--no-download`
verhinderte die lokale Archivpfadauflösung, echter Hook meldete `**ERROR**`.
Lokale Acquisition erlaubt, echte IP-Socketsperre in Worker/Hook/Probe geprüft;
neuer Readiness-Probe auf Cloud-VM bestanden. Rootledger acht bekannte geschlossene
Versuche, ursprünglicher Fehlversuch/Marker erhalten; kein Paketretry/Acceptance.
Gesamt **12 Jobs / 12 Outbox / 11 Grants**, keine ungeklärten Jobs.
Root-Diagnosepolicy geschlossen, APT-Daemon gestoppt, Linux-Agent online/sync-ready.
Ausführliche Befehle/Tests/Hashes: [implementation-status.md](implementation-status.md).
User erlaubt nun Windows parallel vor Linux-MVP-Abnahme. Eigenständiger Windows-
Gast auf Notebook per ausgehendem SSH-Bootstrap-Reversetunnel erreichbar;
Notebook-Host bleibt ohne Agent. Windows-SSH `127.0.0.1:22222`, Cloud-Reverseport
`127.0.0.1:22240`, extern nicht erreichbar; eigenes forwarding-only Konto mit
befristetem VM-generiertem Schlüssel. Windows-Adminzugang nativ bestätigt,
noch kein RMM-Windows-Agent/Enrollment. Details: [Windowszugang](../deploy/windows/README.md).
Zusätzlich auf ausdrücklichen Userwunsch befristeter Public-only Bootstrap-
Download über **8443/TLS mit öffentlicher Let's-Encrypt-Kette**. Keine Änderung
an Projekt-TLS/mTLS auf 443, keine öffentliche Verwaltung. HTTP80 nur für ACME
benutzt und danach wieder geschlossen. Downloadfreigabe und Firewall8443 enden
per aktivem Ablauf-Timer am **2026-11-14 12:55:31 UTC**. Die untenstehenden
Port-/Hash-/Zählersnapshots sind ältere Zwischenstände.
## Verbindlicher Auftrag
Der User ersetzt die bisherige lokale Servertopologie durch den dedizierten
Internetserver **88.99.80.202**, Domain **discovery.ease-technologies.de**.
`root` ist ausschließlich SSH-Bootstrapzugang;
der RMM-Anwendungsdienst soll unprivilegiert laufen. **Endgültiger Entwicklungs-
und Testaufbau laut neuester Userkorrektur:** Cloud-Test-VM als Client, dieser
Cloudserver als Server, dieses Notebook ausschließlich zur Entwicklung.
Hier keinen RMM-Client installieren, enrollen oder betreiben. Die frühere Aussage
zum lokalen Notebook-Client ist überstimmt. Cloud-VM und später beauftragte
weitere Agenten verwenden diesen Server direkt ausgehend. Ein
PC→Linux-Test-VM-Reversetunnel gehört nicht mehr zum vorgesehenen RMM-Verbindungsweg.
Der oben genannte Windows→Cloud-Reversetunnel ist ausschließlich der neu
beauftragte SSH-Bootstraptransport.
Die Maschine ist aus dem Internet erreichbar. Öffentlich nur ausdrücklich
eingerichtete Endpunkte anbieten: Agent-TLS mit geprüfter Serverkette und nach
Enrollment mTLS; keine öffentliche Dev-Anmeldung oder Datenbank. Dockerports
auch dort nur Loopback, PostgreSQL ohne Portveröffentlichung. Ein separater
öffentlicher TLS-Ingress darf nur die dafür vorgesehenen Agentfunktionen
erreichbar machen. Die Verwaltungsoberfläche bleibt zunächst über SSH-Tunnel
zugänglich, bis Domain und sichere öffentliche Anmeldung feststehen.
TLS-Verifikation niemals abschalten. TCP-Connect-Overrides dürfen weder SNI noch
Zertifikatsnamensprüfung ändern. Root-SSH ersetzt keine Geräteidentität oder
Anwendungsauthentisierung. Jeder RMM-Job bleibt bis zur interaktiven WebUI-
Genehmigung seines unveränderlichen Plans `pending_approval`; die bekannte
dev/test-Browsersimulation ist keine öffentliche Produktionsanmeldung.
## Konfiguration und Datenbestand
- Server-SSH-Daten lokal in `credentials/server.conf`, Modus 0600 im
gitignorierten Verzeichnis `credentials/` mit Modus 0700. Keine Schlüssel oder
Tokens in Git, Chat, Kommandoargumenten oder Logs.
- Der alte Serverstand befindet sich auf einem nicht erreichbaren anderen PC.
Der User hat die Neuerzeugung ausdrücklich erlaubt. Neue CA, Zugangsdaten und
Datenbank bilden einen neuen Testbestand; dies stellt die alte Historie und
Vertrauenskette nicht wieder her. Bestehende VM-Identitäten/Journale erhalten.
- Domain vom User festgelegt: `discovery.ease-technologies.de`; DNS zeigte bei
der Prüfung auf den zugewiesenen Server. TLS mit eigener Projekt-CA ist
eingerichtet. Öffentliche WebUI/OIDC bleiben **not_configured**; die
dev/test-WebUI ist ausschließlich über SSH erreichbar.
- Lokale Entwicklungsartefakte können auf dem Notebook gebaut werden; dort
läuft nach dem Umzugsauftrag kein RMM-Server mehr. Neue private Schlüssel und
Daten dürfen ausschließlich geschützt zum vorgesehenen Server übertragen
werden. Agenten erhalten nur öffentliche CA, eigenes Enrollmentmaterial und
ihre eigene Geräteidentität, keine privaten zentralen Schlüssel.
## Tatsächlich ausgeführt
- Neuer lokaler Testbestand vor dem Umzugsauftrag erzeugt; Docker-Releasebuild,
Migrationen und CA-verifizierter Healthcheck erfolgreich. Kurzzeitig Server
ausschließlich auf `127.0.0.1:18443`, PostgreSQL ohne veröffentlichten Port.
- Nach dem Umzugsauftrag `python3 deploy/dev.py down` tatsächlich ausgeführt:
eigene lokalen Server-/Datenbankcontainer gestoppt und entfernt; Datenvolume,
CA und Schlüssel erhalten. Keine fremden Container verändert.
- SSH-Hostschlüssel vom User bestätigt und strikt gepinnt. Vorhandener
Notebook-Schlüssel war bereits freigeschaltet; separater Schlüssel-Login
erfolgreich. Keine Notwendigkeit, das bereitgestellte Einmalpasswort zu
hinterlegen oder eine weitere Root-Schlüsseldatei zu verteilen.
- Inventur: Ubuntu **26.04**, **aarch64**, anfänglich nur SSH öffentlich.
Docker und Compose installiert, keine Distribution aktualisiert, kein Reboot.
Backend nativ auf dem ARM64-Server aus gepinnter Rust-Toolchain/Lockfile gebaut.
Das ist Backendbetrieb auf ARM64, keine ARM64-Agentfreigabe.
- Eigene Dienstidentität `rmm-server` mit UID 10001, Container unprivilegiert,
Root-Dateisystem readonly, Capabilities entfernt, NoNewPrivileges aktiv.
PostgreSQL gesund, Migrationen 1–12 auf frischem Bestand angewendet.
- SSH-Passwort-/Keyboard-Interactive-Anmeldung deaktiviert; Key-Login danach
erneut erfolgreich. Hostfirewall aktiv, eingehend nur TCP **22/443** erlaubt.
Keine fremden Dienste oder bestehenden Firewallregeln zurückgesetzt.
- `deploy/server.compose.yaml`: privater API-Dienst auf **127.0.0.1:18443**,
separater Gateway auf **127.0.0.1:18444**, PostgreSQL ohne publizierten Port.
Kein privater CA-Signierschlüssel im API-Container; Gateway hält die für
Enrollment erforderliche CA. Beide nutzen denselben dauerhaften DB-/Jobbestand.
- Host-Units `rmm-server-ingress.socket/service` nehmen öffentlich TLS auf 443
an und leiten TCP zum Gateway weiter. Keine TLS-Terminierung im Proxy;
Clientzertifikate gelangen unverändert zum Rust-Gateway.
- Extern tatsächlich geprüft: `/healthz` **200**; `/`, `/auth/config`,
`/auth/dev/login`, `/mcp`, `/api/v1/tenants` jeweils **404**; öffentlicher
Signierschlüssel ohne Gerätezertifikat **401**. Fremde CA und falscher TLS-Name
werden verweigert. Ports **18443/18444/5432** extern nicht erreichbar.
- Eigene CA mit Server-SANs `discovery.ease-technologies.de`, `localhost` und
historischem Testalias `rmm-dev.internal`. Kein globaler Truststore verändert.
Neue Clients erhalten die öffentliche CA gezielt. Leaf-Zertifikat 30 Tage;
`rmm-server-tls-renew.timer` prüft täglich, erneuert bei weniger als sieben
Tagen Restlaufzeit und startet nur die eigenen API-/Gatewaycontainer neu.
Native Prüfung des aktuellen Nicht-Erneuerungsfalls bestanden. Erzwungene
Erneuerung und CA-Rotation wurden **nicht** abgenommen; vor CA-Ablauf ist
gesonderte kontrollierte Rotation nötig.
- Private WebUI über SSH-Tunnel unter **https://localhost:18443** erreichbar;
Originbindung und Anmeldung mit Secure-/HttpOnly-Cookie tatsächlich geprüft.
Simulierter dev/test-Principal, keine Produktions-/OIDC-Abnahme.
## Tatsächliche Clientumstellung
Die tatsächliche Linux-x86-64-Test-VM ist mit einer neuen getrennten Testidentität
direkt gegen den Server verbunden. Vor der Userkorrektur wurde zusätzlich ein
Notebook-Client angelegt und getestet; dieser ist inzwischen **gestoppt,
deinstalliert und seine Identität über die WebUI widerrufen**. Historisch wurden
für beide serverseitig frische Heartbeats, passives Inventar, mTLS-WSS,
Signierschlüsselbezug über den mTLS-Gateway und erfolgreicher signierter
Journalabgleich (`sync_ready=true`, `restore_blocked=false`) nachgewiesen.
Im Bestand bleibt der widerrufene Notebook-Datensatz als Historie; ausschließlich
die Cloud-VM darf als aktiver Client verbleiben. Tenant B sieht keines. **0 Jobs, 0 Outbox,
0 Startgrants** im neuen Serverbestand; keine UI-Freigabe oder Paketwirkung.
- VM: neue Unit `rmm-agent-remote.service` aktiviert und aktiv, Netzwerkprozess
weiterhin unprivilegiert als `rmm-agent`. Neuer Zustand
`/var/lib/rmm-agent-remote`, Konfiguration `/etc/rmm-remote`, separates Binary.
Die alten Units bleiben inactive, alte Geräteidentität/Journale bleiben unter
ihren bisherigen Pfaden erhalten: historisch ein Hello-World-Erfolg,
Rootledger weiterhin 0 Verbräuche. Kein Reverse-Listener auf der VM.
- Notebook: Userdienst `rmm-agent-remote.service` gestoppt und deaktiviert,
Unit und installiertes Binary entfernt, Usermanager neu geladen. Livezustand
`~/.local/share/rust-discovery/remote-agent` entfernt. Private Journalhistorie
ohne installiertes Binary unter `devstate/uninstalled-local-client/` archiviert;
keine erneute Inbetriebnahme. Widerruf mit tatsächlichen UI-Interaktionen im
gekennzeichneten dev/test-Profil, Bestätigungskennung und explizitem Klick
erfolgt. Kein API-/DB-Widerruf als Umgehung der interaktiven Verwaltungsgrenze.
- Beim ersten VM-Bootstrap verhinderte die restriktive Umask die Ausführung
des neuen Binaries (systemd Exit 203). Nur die eigenen, per SHA geprüften
neuen Dateimodi korrigiert; denselben erhaltenen Bootstrap fortgesetzt.
Keine Identität gelöscht, kein Journalreset oder erneutes Enrollment.
Regression für Dateimodi, Verweigerung vorhandener Identitäten und Ablehnung
der entfernten Notebook-Installationsoption: 3 Tests grün.
Clientvertrag für weitere Installationen:
```ini
RMM_SERVER_NAME=discovery.ease-technologies.de
RMM_CONNECT_ADDR=88.99.80.202:443
RMM_CA_FILE=/geschuetzter/pfad/server-ca.pem
```
`RMM_SERVER_NAME` wird für URL, SNI und Zertifikatsprüfung verwendet;
`RMM_CONNECT_ADDR` bleibt ausschließlich TCP-Ziel. Gleiches Namensprofil für
Enrollment, WSS, HTTPS, Signierschlüssel und Zertifikatserneuerung. Falscher Name,
fremde CA, URL-/Port-/Benutzerinjektion im Servernamen werden verweigert.
Rezept für Systemdienste: `deploy/linux/rmm-agent-remote.service`.
Bestehende lokale Entwicklungsdefaults sind keine neue Serverempfehlung.
Weitere Clients erhalten nur öffentliche CA, eigenes kurzlebiges Einmaltoken
und ihre fest provisionierte öffentliche Geräte-/Tenant-/Signierbindung.
Private Geräteschlüssel erzeugt der Client selbst. **Kein Server-SSH-Key,
zentrales CA-Geheimnis oder globaler Bearer gehört auf zusätzliche Clients.**
`deploy/remote_client_bootstrap.py` ist ein administratives Werkzeug des
Entwicklernotebooks, kein an Kunden zu verteilender Installer.
Es bietet ausschließlich den create-only-Modus `--provision-vm`; `--resume-vm` setzt nur
den passenden eigenen, erhaltenen Bootstrap mit gleicher CA/Binärbindung fort.
Die lokale Installationsfunktion und `--provision-local` wurden entfernt.
## Verwaltung und private Nachweise
Ein Loopback-Tunnel vom Notebook läuft bereits. Manuelle Wiederherstellung
des Verwaltungszugangs, **nur bei freiem lokalem Port und ohne zweiten Tunnel**:
```sh
ssh -N -T -o StrictHostKeyChecking=yes -o ExitOnForwardFailure=yes \
-o ServerAliveInterval=30 -o ServerAliveCountMax=3 \
-i ~/.ssh/ease_key.pem \
-L 127.0.0.1:18443:127.0.0.1:18443 root@discovery.ease-technologies.de
```
Danach `https://localhost:18443`, mit explizitem Vertrauen in die Projekt-CA.
Nicht die Zertifikatsprüfung wegklicken/abschalten. Öffentliche CA lokal:
`credentials/server-ca.pem`; privater dev/test-Login:
`credentials/server-browser-login.json` (0600). Keine Inhalte veröffentlichen.
Tunnelreferenz `devstate/server-admin-tunnel.json`; Clientnachweise
`devstate/remote-vm.json`; Notebook-Deinstallations-/Widerrufsnachweis in
`devstate/remote-local.json` und `devstate/notebook-removal-ui.json`.
Der Verwaltungs-SSH-Tunnel ist ein Entwicklungswerkzeug, kein RMM-Agent.
Serverinstallation `/opt/rust-discovery`; private Konfiguration, PKI und
Browserzugang dort unter `devstate/` (0700/0600). Datenbank in eigenem
Docker-Volume. Rohe Source-/Artefaktlogs unter `/var/log/rmm-server-*.log`,
sanitisiertes Prüfergebnis `/opt/rust-discovery/deployment-verification.json`.
Buildgebundene Quellen mit Notebook-Checkout abgeglichen:
`d50c5e82746f9675d50a24c385a0ad74cb666ed546d8dc7c732153cf7a862c9e`.
## Offene MVP-Gates
### Neuer tatsächlicher Cloud-Abnahmelauf (2026-11-13)
Server weiterhin ausschließlich `discovery.ease-technologies.de`, Client
ausschließlich die bestehende Cloud-VM; kein Notebook-Client gestartet/enrolled.
`deploy/cloud_mvp_acceptance.py` verwendet einen echten Streamable-HTTP-MCP-Client
mit initialisierter Sitzung. Der öffentliche Agentzugang bleibt unverändert;
MCP und WebUI laufen privat auf dem Server bzw. durch den Verwaltungs-SSH-Tunnel.
MCP-Bearer bleiben auf dem Server. Genehmigung ausschließlich über sichtbare
WebUI-Interaktionen mit dem gekennzeichneten simulierten Testprincipal.
Tatsächlich nachgewiesen, jeweils ein neuer fester, separat UI-genehmigter Plan:
| Fall | Ergebnis | Job / Outbox / Startgrant |
| --- | --- | --- |
| Hello World über WSS | Exit 0, exakte Ausgabe und Nachbedingung bestätigt | 1 / 1 / 1 |
| Hello World über HTTPS-Long-Polling | Exit 0, exakte Ausgabe und Nachbedingung bestätigt | 1 / 1 / 1 |
| Angeforderte Live-Inventur über HTTPS | Neuer Erhebungszeitpunkt nach gebundenem Planbeginn, Nachbedingung bestätigt | 1 / 1 / 1 |
| Genehmigter Hello-Auftrag mit künftigem Start, danach MCP-Abbruch | `cancelled`, kein Startgrant | 1 / 1 / 0 |
Vor jeder Genehmigung `pending_approval`, keine Ausführung, für den festen Job
**0/0/0** gemessen. Alle vier Audits binden Principal, Planhash,
`approval_origin=dev_test_browser_simulation` und `testsimulation=true`.
Snapshot nach der Basisstrecke: **3 succeeded, 1 cancelled; 4 Jobs / 4 Outbox / 3 Grants**,
keine ungeklärten oder laufenden Jobs. Die weiter oben genannten 0/0/0-Werte
sind der historische Umzugssnapshot, kein aktueller Gesamtzähler.
- MCP von Mandant B auf Gerät und Job von A verweigert. Wiederholtes Submit
derselben Pläne/Idempotenzschlüssel liefert dieselben Operationen, keine neue
Ausführung. Kein MCP-Genehmigungswerkzeug oder API-/DB-Genehmigungsaufruf.
- Gateway tatsächlich neu gestartet. HTTPS-Sitzung blieb mit erneuter Prüfung
pro HTTP-Anfrage gültig. Ein anfänglicher Test verlangte dafür fälschlich eine
höhere Verbindungsgeneration und lief in sein 100-Sekunden-Limit; daraus wird
kein Reconnect-Erfolg behauptet. Danach echter WSS-Reconnect separat geprüft:
höhere Generation, frischer Heartbeat, signierter Sync, unveränderte 4/4/3.
Cloud-VM wieder auf WSS; Identität und Journale unverändert erhalten.
- Die neue Auswertung musste leere SSE-Initialframes und Rust-RFC3339-Zeiten mit
Nanosekunden auf Python 3.10 berücksichtigen. Live-Inventur war schon erfolgreich;
ihr vorhandenes Ergebnis wurde nach Parserkorrektur rein lesend verifiziert.
Kein Wiederholen des Jobs, um die Auswertung grün zu machen.
- Lokale Prüfungen: **5 Cloud-Guards**, **28 bestehende MVP-Guards**,
**3 Bootstrap-Guards** bestanden; neue Browserdatei per Node-Syntaxprüfung.
Browservertrauen separat im privaten NSS-Profil unter
`web/node_modules/.cache/cloud-acceptance/home`, keine globale CA-Änderung.
Tatsächlich ausgeführte Abnahmebefehle:
```sh
python3 deploy/cloud_mvp_acceptance.py --execute-dev-test-ui --case hello
python3 deploy/cloud_mvp_acceptance.py --execute-dev-test-ui --case hello --transport https
python3 deploy/cloud_mvp_acceptance.py --execute-dev-test-ui --case refresh_inventory
python3 deploy/cloud_mvp_acceptance.py --execute-dev-test-ui --case cancel_queued
```
Nicht blind erneut ausführen: diese Befehle erstellen neue genehmigungspflichtige
Pläne. Geschützte Einzelbelege und Checkpoints unter
`devstate/cloud-acceptance/<Lauf-ID>/checkpoint.json`, Wiederanlaufbeleg unter
`devstate/cloud-acceptance/reconnect.json`. Unklarer Ausgang bleibt ungeklärt;
keine automatische neue Wirkung oder neue Genehmigung als vermeintliche Redelivery.
Der Serverumzug ist ausgeführt; das Linux-MVP ist weiterhin **nicht vollständig
abgenommen**. Die oben nachgewiesenen UI-genehmigten Basisfälle sind keine Root-/
Paketabnahme. Produktions-OIDC und öffentliche Verwaltung sind nicht eingerichtet.
Native Rotations-/Recovery-/Replay-/Offline-Ablauf-Abnahmen bleiben gesonderte
Arbeitspakete. Der nachfolgende Root-/APT-Abschnitt aktualisiert deren Stand.
## Root-/APT-Abnahmelauf 2026-11-13
Die Cloud-VM behält ihre bestehende Gerätebindung. Versionierte Bootstrap-
Werkzeuge `deploy/cloud_root_bootstrap.py` und `cloud_root_clock_upgrade.py`
erhalten beide Agentzustände/Journale, den bisherigen Rootledger-Inode sowie
Archive, Baselines, Vorprüfungen und sämtliche Fehlernachweise. Kein erneutes
Enrollment oder Ledgerreset. Rootdateien unter `/var/lib/rmm-bootstrap-history/`
werden exklusiv mit 0700/0600 aufbewahrt; Teilinstallationen werden nicht blind
erneut ausgeführt.
Erster Readonly-APT-Probe auf der echten VM erfolgreich; anschließende Daemons
jedoch nicht stabil: glibc-Zeitabfrage über Syscall `clock_adjtime` wurde vom
Unitfilter blockiert (allgemeiner Helper SIGSYS, APT `CLOCK_UNTRUSTED`). Der alte
Bootstrap meldete nach Type=simple-Spawn verfrüht Erfolg; dieser Eintrag gilt
ausdrücklich nicht als stabile Bereitschaft. Enger Filterfix erlaubt zusätzlich
`clock_adjtime`, ohne CAP_SYS_TIME und ohne Änderung der vertrauenswürdigen
Zeitprüfung. Nach versioniertem Artefakt-/Profilwechsel tatsächlichen Probe
erneuert, beide Daemons zehnmal laufend/ohne Restart geprüft, gemeinsames Ledger
einmal an die bestehende Cloudidentität gebunden. Ein anfängliches `reset-failed`
auf nach Reload ungeladenen, inaktiven Units schlug fehl; Fortsetzung ausschließlich
des installierten Startschritts, ohne Paketjob oder Zustandslöschung. Bootstrap
wartet inzwischen auf stabilen Betrieb statt nur den Spawn zu bestätigen.
Installiertes Clock-Fix-Helperartefakt:
`dba16402af1e8b8655ec69495cf370d019bc32b9f05e61be4147df29cd7bf176`.
Gemessene Runtime:
`0547c9886aae77775c373c81758166ad41aced236d428fdf299d8e7784751d10`.
Allgemeiner Policypin:
`e177ab083ba0c239103942eb67ea9e28e9dafc294f828592cf859535a8569fd8`;
APT-Stackpin:
`0b71b79a2f59c5019472e7366ede9f155850749afec7ec29ccff91f3226be56b`.
Pins über Rootinstallation und tatsächliche nonce-/Root-Peer-gebundene
Controlantworten als `rmm-agent` geprüft. Beide Helper teilen die exakt gleichen
Ledger-/Lock-Inodes. Vor erstem Rootjob 0 Verbrauchseinträge, 0 Syncfehler.
Dies ist Readiness, keine vorweggenommene Paket-Acceptance.
`deploy/cloud_root_policy.py` installierte eine zweistündig befristete Policy
für genau diese Gerätegeneration/-zuordnung, beide gemessenen Helperpins und
ausschließlich `simulated-testprincipal-a`. Allgemein nur Rootskript und
`rmm-mvp-test.service`; APT nur die eingebauten Fixturemanifeste und exakten
Provider-/Hook-/Config-/Runtimehashes. Kein Reboot, keine MCP-Rechteerweiterung.
Compose bindet das private Policyverzeichnis readonly; Dateimodus 0600,
Eigentümer 10001, Verzeichnis 0700. Default ohne ausdrückliche Konfiguration:
`RMM_DEV_ROOT_ENABLED=false`. Policies begrenzen nur, sie genehmigen keine Jobs.
`deploy/cloud_root_acceptance.py` verwendet zwei getrennte tatsächliche
WebUI-Sitzungen: Rootplan erstellen/beantragen, dann unveränderliche Bytes/
Hashes/Ziele/Versuche prüfen und genehmigen. Dazwischen MCP-lesender Abgleich
und SQL-Nachweis 0 Jobs/Outbox/Startgrants. Bestehende Browserverträge werden mit
`deploy/browser/cloud-root.config.ts` über den privaten Cloud-SSH-Tunnel genutzt;
kein lokaler Server oder Client. Ein fehlerhafter exakter Interpreter-Labelselector
stoppte zuerst vor der Planung; auf die tatsächliche Combobox umgestellt. Nur
die Formularvorbereitung fortgesetzt, kein ausgeführter Job wiederholt.
| Fall | Reales Ergebnis | Vorher → nach Genehmigung |
| --- | --- | --- |
| `service_setup` | Rootskript, exakte Ausgabe, `succeeded` | 0/0/0 → 1/1/1 |
| `service_start` | Dienst läuft, `succeeded` | 0/0/0 → 1/1/1 |
| `service_stop` | Dienst gestoppt, `succeeded` | 0/0/0 → 1/1/1 |
| `apt_native_install` | `failed / HOOK_NOT_HANDED_OFF`, keine Acceptance | 0/0/0 → 1/1/1 |
Alle vier Authorizations rein lesend mit festem Planhash, sichtbarem Testprincipal,
`approval_origin=dev_test_browser_simulation`, `testsimulation=true` verifiziert.
Keine direkte API-/DB-Genehmigung. Kein Produktions-Freigabenachweis.
Beim APT-Versuch sind `native-prechecks.json`, `sandbox-ready.json` und
`sandbox-result.json` tatsächlich vorhanden: private Namespaces, genaue
Cap-/NNP-/Seccomp-Sätze, readonly Controlmounts, ungültige Kontrollsyscalls EPERM
und echter Frontend-Lockkonflikt bestanden. Anschließend **APT Exit 100**,
kein `hook-armed.json`, keine native Acceptance. Elternprozess prüfte gesamten
Paketbaselinezustand unverändert; frisches passives gespeichertes Inventar
bestätigte unveränderte Baseline/Statusfingerprint, Fixture nicht installiert.
APT-stdout/stderr wurden bisher verworfen; konkrete Ursache von Exit 100 ist
offen. `--no-download`, Archive oder Hook dürfen nicht auf Verdacht gelockert
werden. Kein manuelles apt/dpkg auf dem Ziel, kein neuer Versuch/Rezeptalias.
Der Rootledger enthält danach **4 abgeschlossene Verbrauchseinträge**, keine
unbekannte/offene Wirkung und keinen sticky Syncfehler; Integrität ok. Der
Create-once-Marker und `active/` bleiben unverändert. Install 1.0, Upgrade 1.1,
EnsurePackage und ApplyUpdates sind **nicht abgenommen**. Vor einer Fortsetzung
braucht es eine auditierbare, sichere Behandlung dieses erhaltenen Fehlversuchs;
Marker löschen, Ledgerreset, neue Identität oder eine alternative Rezeptkennung
als Wiederholungsabkürzung sind ausgeschlossen. Ein neuer ausführbarer Versuch
benötigt einen neuen festen, tatsächlich WebUI-genehmigten Plan.
Codeprüfung nach dem Fehlversuch fand zusätzlich einen Cloudlayout-Fehler: die
bisherige Worker-Maskierung umfasste `/etc/rmm` und `/var/lib/rmm-agent`, aber noch
nicht `/etc/rmm-remote` und `/var/lib/rmm-agent-remote`. Quellcode korrigiert:
beide Layouts maskieren, sichtbare Inhalte oder Symlinks unabhängig vom konkreten
Schlüsseldateinamen verweigern. **58 Python-APT-Tests bestanden; dieser Fix ist
noch nicht auf der VM installiert oder nativ abgenommen.** Er verändert
Provider-/Helper-/Runtimehashes. Bisherige Readiness ist keine Abnahme dieses
neuen Codes; keine erneute create-only Installation über verbrauchten Zustand.
Abschließend Rootpolicy explizit geschlossen (serverseitig abgelaufen), bisherige
Policy gesichert. APT-Helper gestoppt/deaktiviert und ausschließlich seine
eigenen Socket-/Proof-Variablen aus dem gesicherten Agentdrop-in entfernt
(`deploy/cloud_root_pause_apt.py`). Ledger-Inode und Versuchsmarkerhash dabei
unverändert. Cloud-Agent/allgemeiner Helper bleiben aktiv. Testdienst inactive.
Abschlussmessung: Agent `online`, signierter Sync `ready`, kein Restoreblock,
keine APT-Capabilities; APT-Daemon inactive/disabled; Policy tatsächlich abgelaufen,
weiterhin UID10001/0600. Beleg `devstate/cloud-root/closed-state-*.json`.
Notebook-Clientunit weiterhin `not-found/inactive`, keine laufenden RMM-Container
auf dem Notebook. Andere lokale Projekte wurden nicht verändert. Öffentliche
Routen `/`, `/auth/config`, `/mcp` nach Serverkonfigurationsänderung weiterhin 404
über verifiziertes TLS.
Gesamtsnapshot: **6 succeeded / 1 failed / 1 cancelled; 8 Jobs / 8 Outbox /
7 Startgrants; 0 ungeklärte/laufende Jobs**. Private Evidenz:
`devstate/cloud-root/{install-*,clock-*,health-*,peer-readiness-before-apt.json,
cases/*/checkpoint.json,apt-failure-*,final-*,policy-*,apt-paused-*}` und
Root-Backups auf der VM/im Server. Nichts davon committen oder veröffentlichen.
Tatsächlich ausgeführt (keine Anleitung zum blinden Wiederholen):
```sh
python3 deploy/cloud_root_bootstrap.py --install-reviewed-helper
python3 deploy/cloud_root_acceptance.py --case service_setup
python3 deploy/cloud_root_acceptance.py --case service_setup --resume-prepared
python3 deploy/cloud_root_acceptance.py --case service_start
python3 deploy/cloud_root_acceptance.py --case service_stop
python3 deploy/cloud_root_acceptance.py --case apt_native_install
python3 deploy/cloud_root_policy.py --close-reviewed-test-scope
python3 deploy/cloud_root_pause_apt.py
```
Clockupgrade und ausschließlich dessen installierter Startschritt wurden ebenfalls
ausgeführt; Zwischenfehler bleiben in geschützten Reports erhalten. Lokale Suites:
58 Python-APT / 8 Cloud-Guards / 28 MVP-Guards / 3 Bootstrap-Guards bestanden.
Helper nach Clockprofil und separat nach Cloud-Controlpfad-Fix: jeweils
25 Library / 3 Binary / 20 Sync bestanden. Keine
vollständige Frontend-/MVP-/APT-Abnahme aus lokalen Tests ableiten.
## Nächste Schritte (geplant, nicht ausgeführt)
1. Die weiteren Fehler-/Offline-/Replayfälle der WebUI/MCP-/Jobstrecke auf dem
neuen Server abnehmen; ausschließlich feste UI-genehmigte Pläne.
2. APT-100-Ursache durch begrenzte sichere Diagnose bestimmen; Cloudlayout-
Maskierungsfix kontrolliert mit erhaltenem Ledger/Marker installieren und
native Readiness erneuern. Sichere Behandlung des gespeicherten Fehlversuchs
vor weiterem Paketjob klären/implementieren; keine Guard- oder Genehmigungsabkürzung.
3. Gesonderte Daten-/Schlüsselbackup- und Restoreabnahme sowie CA-Rotation
vorbereiten. Zertifikatswartung ersetzt kein Backup oder Produktionsnachweis.