Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s

This commit is contained in:
2026-11-18 17:21:12 +01:00
parent f37b6dc4f7
commit 6963ad332c
188 changed files with 370 additions and 34933 deletions
+24 -484
View File
@@ -1,500 +1,40 @@
# Dedizierter RMM-Server: aktuelle Verweise und historische Bereitstellung
# Aufbau des dedizierten Servers
## Öffentliche Verwaltung und Erstaufnahme, 17. November 2026
Der ARM64-Server `discovery.ease-technologies.de` betreibt die WebUI, den MCP-Endpunkt, die Geräte-API und PostgreSQL. Unter `/opt/rust-discovery` liegen Deploymentkonfiguration, WebUI und der private Betriebszustand. Der externe Zugriff verteilt sich auf zwei TLS-Eingänge.
WebUI und MCP sind inzwischen ebenfalls auf dem öffentlichen TLS-Ingress erreichbar. Passwort/TOTP und eigenständige MCP-Tokens sind im [aktuellen Aufbau](public-access.md) beschrieben. Die folgenden Angaben zum engeren Installer-Ingress dokumentieren dessen frühere Freischaltung.
Die Geräte verwenden `discovery.ease-technologies.de:443` mit der Geräte-PKI. Auf Port 8443 liefert `rmm-install-ingress.service` den [Linux-Installer](https://discovery.ease-technologies.de:8443/install/linux.sh) und den [Windows-Installer](https://discovery.ease-technologies.de:8443/install/windows.ps1) über die öffentliche Zertifikatskette. Im Test antworteten beide Skripte mit HTTP 200, der Releaseabruf ohne Einmalcode mit 401 und die privaten Routen `/mcp` und `/auth/dev/login` mit 404. Die Konfiguration prüft das Gateway-Zertifikat auch intern. [Ingress-Konfiguration](../deploy/server-bootstrap-ingress.conf)
Das gegenwärtige öffentliche Zertifikat läuft bis 11. Februar 2027. Der täglich aktivierte Timer `rmm-install-tls-renew.timer` prüft den Ablauf und beantragt unter 30 Tagen Restlaufzeit eine neue Kette über den vorhandenen ACME-Zugang. Der erste Lauf bestätigte die Restlaufzeit. Eine tatsächliche Neuausstellung mit diesem Runner steht aus. [Erneuerung](../deploy/renew_bootstrap_tls.py)
Die aktuelle Topologie besteht aus dem dedizierten ARM64-Server, seiner getrennten API- und Gatewayrolle und internem PostgreSQL. Verwaltung über den SSH-Tunnel, Geräte verbinden sich direkt ausgehend. Den geprüften Betriebsstand und die aktuelle Migration enthält die [Live-Nachlese vom 17. November](evidence/product-audit-20261117.json). Die laufenden Containerlabels bestimmen bei einer Entwicklungsausrollung die vollständige Compose-Dateikette. [Entwicklungsweg](development.md) · [Zugänge](operations-access.md)
Nachfolgend **historische Bereitstellungschronik ab 13. November 2026**
(damals Spezifikation 1.13, Linux-MVP noch nicht abgenommen). Alte Zähler,
Images, Fristen, Windowszustände und Bootstrapdownloadlinks sind keine
heutigen Freigaben oder Startanweisungen.
## Aktueller erhaltender Serverwechsel
**Spätere notwendige VM-Bootstrapfinalisierung:** Der vorhandene geprüfte
General-Helper war aktiv, aber disabled. Nach geschlossenem Offline-Ablauffall
und0offenen Agent-/Rootwirkungen ausschließlich`systemctl enable` dieser festen
Unit ausgeführt; kein`--now`, Dienststart/-restart oder Reboot. Tatsächlicher
vorheriger Readonly-Preflight und nachheriger Check bestätigten identische
öffentliche Schlüssel-/Gerätepins, Unit-/Helperbytes, Boot/PIDs, drei DBinodes
und Root-Verbrauchszeilen. Genau der root-owned Multiuser-Wants-Link zur
bekannten Unit wurde hinzugefügt. Agent bereits enabled; APTinactive/Endpunkt
weiter geschlossen. Private Reports`devstate/general-autostart-{preflight,enabled}.json`.
Dies ist ein Setup-/Autostartnachweis, kein ausgeführter Reboot.
Kandidat73aab983-fd45-4294-b812-03cb9823148b nativ auf ARM64 gebaut und explizit
deployed. Build bewegte den Runtimetag nicht; bewusstes Deployment verwendete
denselben qualifizierten Imagedigest. UI-Indexa3513f92 unverändert/CAS-geprüft,
Migrationen1–13 und bestehende Datenbank/PKI weiterverwendet. Enthält die lokal
mit drei isolierten PostgreSQL-Tests qualifizierte konservative Rebootfrist
und getrennte Inventar-Eingangsprüfung; **noch kein tatsächlicher Reboot**.
Nach tatsächlichem Wechsel gespeicherten fehlgeschlagenen Noop unverändert
gelesen: gleicher Versuch/Grant/errorSTATUS_FINGERPRINT. Zentral22Jobs/22Outbox/
20Grants/0offen, Root13/0offen/0Faults, Agentjournal integritätsgeprüft/faultfrei;
Agent und beide Helper aktiv. Kein neuer Auftrag/Grant durch Deployment.
Private Readbackdatei unter`devstate/server-upgrades/73aab983-fd45-4294-b812-03cb9823148b.native-readback.json`.
Native1.1-APT-Acceptance bestanden; beide Noops und übrigeMVP-Gates offen.
Ältere Meldungen unten beschreiben ihre jeweiligen historischen Zwischenstände.
## Neuester APT-/Bootstrapstand
**Abgeschlossene Windows-Passivstrecke:** Migration 13 auf Cloudserver angewendet,
Windows-11-Gast als LocalService mit mTLS/WSS, gespeichertem Inventar, zwei
Heartbeats, Tenant-B-Verweigerung und sieben nativen Tests bestätigt. Null
Windows-Jobs/Outbox/Grants. Exakte APT-Unknown-Evidenz und 13/13/12/1 beim
Serverwechsel erhalten. Rootpolicy geschlossen; Configure-Korrektur nur lokal,
kein neuer Paket-/Recoverylauf. Aktuelle Plattformmatrix: `platform-support.md`.
Die folgenden Meldungen sind vorherige Zwischenstände.
**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 |
| Öffentlicher Zugang | Weiterleitung auf dem Server | Zweck |
| --- | --- | --- |
| 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 |
| TCP 443 | Socket-Proxy an `127.0.0.1:18444` | Gerätegateway. Registrierte Geräte authentisieren sich mit ihrem Clientzertifikat. |
| HTTPS 8443 | Nginx an `127.0.0.1:18445` | Öffentliche WebUI, lokale Anmeldung und MCP. |
| HTTPS 8443, Installer- und Bootstraprouten | Nginx an `127.0.0.1:18444` | Download der Installer und der freigegebenen Bootstrapdateien mit öffentlich vertrauenswürdiger TLS-Kette. |
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.
Die private Entwicklungs-API lauscht auf `127.0.0.1:18443`. PostgreSQL ist nur im internen Netz erreichbar. Der HTTPS-Proxy prüft den Namen und die Zertifikatskette des jeweiligen Upstreams. Die öffentliche API verwendet das Produktionsprofil. [Gerätesocket](../deploy/server-ingress.socket) · [HTTPS-Ingress](../deploy/server-bootstrap-ingress.conf) · [Öffentliche API](../deploy/server.public-access.compose.yaml)
- 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.
## Laufenden Stand aktualisieren
Tatsächlich ausgeführte Abnahmebefehle:
Der Deploymentrunner liest die tatsächlichen Compose-Dateien aus den Labels der laufenden Container. Er übernimmt Volumes und Richtlinien, wendet die Migrationen an, vergleicht deren Prüfsummen mit der gewählten Git-Revision und aktiviert API, Gateway und die vorhandene öffentliche API. Abschließend prüft er die Binärhashes, die TLS-Healthchecks und die ausgelieferte Startseite. Für einen reinen Frontendwechsel genügt der WebUI-Modus. [Build- und Deploymentbefehle](development.md)
## Signierte Zeitbelege
Der Hostdienst `rmm-time-broker.service` stellt dem Gateway signierte Zeitbelege aus. Die Zeitquelle prüft die konfigurierte Chrony-Prozessgeneration. Ein Wechsel des Prozesses kann eine erneute Prüfung dieser Bindung erfordern. Das Gateway erreicht den Broker über den Unix-Socket `/run/rmm-time-source/broker.sock`. Das Compose-Overlay bindet sein Verzeichnis schreibgeschützt ein. [Gateway-Mount](../deploy/server.time-broker.compose.yaml) · [Zeitbroker](../crates/time-broker-linux/src/native.rs)
Bei fehlendem Zeitbeleg auf dem Server zuerst Zustand und Startzeit beider Dienste sowie den Sockettyp lesen. Diese Abfrage benötigt keinen Zugriff auf private Schlüssel.
```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
systemctl show rmm-time-broker.service chrony.service -p ActiveState -p MainPID -p ExecMainStartTimestamp
stat -c '%F %a %U:%G %n' /run/rmm-time-source/broker.sock
```
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.
Auf dem Windows-Testgerät ist die automatische Wiederherstellung der Bereitschaft nach einem Gatewaywechsel dokumentiert. [Gerätebeobachtung](evidence/windows-gateway-clock-recovery-20261117.json)
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.
## Öffentlichen Zugang einrichten
## 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):
Auf einem bereits mit interner API, Gateway und öffentlicher TLS-Kette eingerichteten Entwicklungsserver richtet `tools/dev_public_access.py` die öffentliche Verwaltung ein. `prepare` provisioniert das lokale Bootstrapkonto, `activate` startet die zusätzliche API und kontrolliert deren Anmeldemodi. `publish` prüft die Nginx-Konfiguration und aktiviert den Ingress. `prepare` im Checkout mit dem bestehenden privaten `credentials/` ausführen. Die Zugangsdaten verbleiben beim Betreiber.
```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
python3 tools/dev_public_access.py prepare
python3 tools/dev_public_access.py activate
python3 tools/dev_public_access.py publish
```
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.
### MVP-Verwaltung ausschließlich über SSH-Tunnel, 15. November 2026
Der Betreiber verlangt für den MVP keinen OIDC-Anbieter. WebUI und MCP
verwenden den bestehenden Entwicklungslogin auf dem Server-Loopback.
Die aktuelle Nachprüfung las für API `127.0.0.1:18443`, Gateway
`127.0.0.1:18444` und keine veröffentlichten PostgreSQL-Ports.
Eine externe HTTPS-Prüfung mit der vorhandenen vertrauenswürdigen
Projekt-CA ergab für `/`, `/mcp`, `/auth/config` und `/api/v1/tenants`
jeweils 404. Der öffentliche Ingress bietet diese Verwaltungspfade
nicht an. Der Zugriff auf WebUI und MCP erfolgt über einen SSH-Tunnel
auf den API-Port 18443. Öffentlich erforderliche Agentenverbindungen
bleiben getrennt von diesem Verwaltungszugang.
Der Server liest Benutzerkonten aus der geschützt eingebundenen `devstate/public-auth/users.json`. Änderungen dieser Kontokonfiguration werden beim Neustart von öffentlicher API und Gateway geladen. Das öffentliche Installerzertifikat und die internen Zertifikate haben getrennte Erneuerungsdienste. Ihre Zeitsteuerung ist in den Unit-Dateien hinterlegt. [Öffentliche TLS-Erneuerung](../deploy/server-bootstrap-tls-renew.timer) · [Interne TLS-Erneuerung](../deploy/server-tls-renew.timer) · [Zugänge](operations-access.md)