# Linux-first-Entwicklung und reale VM-Abnahme Stand: 2026-11-13 · Spezifikation 1.8. **Windows-Override:** Entwicklung und native Tests auf der neuen Windows-11-VM sind ausdrücklich parallel erlaubt, unabhängig von der noch offenen Linux-MVP-Abnahme. Die nachstehenden älteren Wartevorgaben sind hierfür überstimmt; keine Windows-Pflicht zur Linux-Abnahme. **Topologieoverride:** Dieses Notebook ist ausschließlich Entwicklungsrechner, weder RMM-Server noch RMM-Client. Aktueller Client ist die Cloud-Test-VM, endgültiger Server der festgelegte Cloudserver. Clients verbinden sich ausgehend direkt dorthin. Aktueller Vertrag und Deploymentnachweise: [server-deployment.md](server-deployment.md). Die folgenden PC-Server-/Reverse-Tunnel-Abläufe und Nachweise sind historisch. TLS/mTLS, Credentialschutz, Linux-first und WebUI-Plangenehmigung gelten weiter. ## Ergänzende Userfreigabe und lokale Browserprüfung (2026-11-12) Der User hat temporären Testdienst, harmloses Testpaket, systemd-Agent, einen VM-Reboot und ausgewählte kleine Updates ausdrücklich erlaubt; kein Kernel-/Distributionsupdate und kein ungeplanter Reboot. Jeder entsprechende RMM-Job benötigt weiterhin seinen festen Plan und explizite WebUI-Genehmigung, bei dev/test sichtbar als Simulation. Diese Freigabe ist kein Ausführungsnachweis. Im lokalen Browser-Integrationslauf wurden keine VM-Änderungen, Tunnel, Paket-/Update-/Rebootjobs oder Genehmigungen ausgeführt: nur echtes TLS, Login, Zielpreview, Antrag `pending_approval`, Reload und CSRF-Prüfung mit authentisiertem synthetischem lokalem mTLS-Testgerät. Details und reproduzierbarer isolierter Browser-Truststore: `deploy/browser/README.md`; keine globale Truständerung. ## Phasen und Gates 1. **Linux-MVP:** M0–M5 auf Linux x86-64 mit zwei Testmandanten, WebUI, MCP und dauerhaftem, menschlich autorisiertem Jobpfad. **Jedes Feature zuerst auf der tatsächlichen Linux-Test-VM ausführen und nachweisen.** Der PC-/Containerlauf, ein Simulator oder erfolgreicher Build allein genügt nicht. Nicht auf der VM geprüfte Features bleiben unbestätigt. 2. **Windows nach Linux-MVP:** Erst nach dokumentierter Linux-MVP-Abnahme Windows-x86-64-Adapter, Dienste, Installer und dieselben Fähigkeiten nativ auf Windows abnehmen. Gemeinsame Schnittstellen berücksichtigen Windows, ohne vorgezogene Windows-Featureimplementierung. 3. **Spätere Erweiterungen:** Monitoringausbau/ARM64, danach gesondert PVE/PBS, Cluster und Backupabnahmen gemäß Spezifikation; Terminal/Betriebsreife folgen ebenfalls nach MVP. PVE ist weder Testinfrastrukturpflicht noch Voraussetzung für eigenständige Gastagenten. Linux-MVP-Gate: Enrollment, verifiziertes TLS/mTLS, ausgehender Kanal, passives Inventar mit Quelle/Zeit, UI/MCP-Tenant-Grenzen, Antrag `pending_approval`, WebUI-Klick (tatsächlich menschlich oder ausschließlich die unten beschriebene dev/test-Browsersimulation, getrennt nachzuweisen), dauerhafte Jobs/Journal/Startgrants und nachgewiesene Ergebnisse auf der VM. Die M0–M5-Abnahmen gelten zunächst für Linux; Windows-/Mischplattformfälle folgen erst in der Windows-Phase. Long Polling, Reconnect, fehlende Genehmigung und Redelivery ohne Doppelwirkung ebenfalls nachweisen. **Useroverride 2026-11-12: RustDesk auslassen.** Keine RustDesk-Installation, Profile/Provisionierung oder externe Desktopabnahme in dieser Umsetzung. M4 bleibt allgemeine Linux-Paketverwaltung; M5 prüft nur die drei übrigen Referenzabläufe. RustDesk ist weder MVP-Pflicht noch offenes MVP-Gate; bestehende Architekturtexte gelten ausschließlich für eine spätere optionale Integration. Keine eigene Desktop-Engine als Ersatz. ## Geplante Topologie ```text Entwickler-PC Linux-Test-VM Docker: TLS-Endpunkt 127.0.0.1:18443 Agent ^ | | SSH-Weiterleitung (TCP, keine TLS-Terminierung) | ausgehend TLS +--------------------------------------- 127.0.0.1:18443 PC -- initiiert SSH zur VM --> sshd DNS: rmm-dev.internal ``` Der Server läuft **lokal in Docker auf dem PC**, nicht auf der Ziel-VM. Nur benötigte Ports veröffentlichen und alle Veröffentlichungen explizit an Loopback binden; der geplante TLS-Port lautet `127.0.0.1:18443`. Interne Datenbanken möglichst gar nicht veröffentlichen; andernfalls ebenfalls nur Loopback. Keine Bindings an alle Interfaces, kein `GatewayPorts yes`. Die VM benötigt keinen eingehenden RMM-Port. SSH zum Bootstrap ist eine davon getrennte Entwicklungsverbindung, keine Änderung des ausgehenden RMM-Vertrags. ### Geplanter SSH-Reverse-Tunnel (nicht ausgeführt) Zuerst den SSH-Hostschlüssel über einen vertrauenswürdigen Weg prüfen und in `known_hosts` hinterlegen. `VM_USER`/`VM_HOST` im folgenden Beispiel sind bewusst **nicht geheime Platzhalter**, keine automatisch geladenen Konfigurationsvariablen. Reale Zugangswerte nicht in geteilte Logs oder Shell-Traces ausgeben. ```sh # GEPLANT, NICHT GETESTET: auf dem Entwickler-PC, Zielwerte lokal einsetzen. ssh -N -T \ -o ExitOnForwardFailure=yes \ -o ServerAliveInterval=30 \ -o ServerAliveCountMax=3 \ -o StrictHostKeyChecking=yes \ -R 127.0.0.1:18443:127.0.0.1:18443 \ VM_USER@VM_HOST ``` Der linke Loopback ist der Listener **auf der VM**, das rechte Ziel wird **auf dem PC** erreicht. Der Agent baut seine Verbindung zu diesem VM-Loopback auf; SSH transportiert nur die TCP-Bytes zum lokalen TLS-Endpunkt. `ExitOnForwardFailure` prüft die Einrichtung der Weiterleitung, **nicht** Erreichbarkeit/Gesundheit des lokalen Servers oder erfolgreiche Agentauthentisierung. Keepalive erkennt Verbindungsverlust; ein Tunnelneustart erteilt keine Jobgenehmigung. Bei Portkonflikt oder verweigertem Forwarding sicher abbrechen, nicht auf einen öffentlichen Listener ausweichen. ## TLS bleibt Ende-zu-Ende - Serverzertifikat mit **DNS SAN `rmm-dev.internal`**, korrekter Gültigkeit und passender Serververwendung bereitstellen; private CA-/Serverschlüssel geschützt lokal halten, nicht committen. Dev-CA gezielt im Agenten-Truststore hinterlegen. - **Auf der VM** in `/etc/hosts` explizit die folgende Zuordnung pflegen (geplante Bootstrapänderung, nicht hier ausgeführt): ```text 127.0.0.1 rmm-dev.internal ``` - Geplanter Agent-Endpunkt: `https://rmm-dev.internal:18443`, WSS entsprechend `wss://rmm-dev.internal:18443/agent/v1/connect`, sofern die Implementierung diesen Protokollstand tatsächlich bereitstellt. Enrollment verwendet serverauthentifiziertes HTTPS; danach mTLS mit eigener Geräteidentität. - Alternativ ausschließlich einen ausdrücklich unterstützten und getesteten Client-Connect-Override verwenden: TCP-Ziel `127.0.0.1:18443`, **TLS-SNI und Zertifikatsnamensprüfung weiter `rmm-dev.internal`**. Kein erfundenes CLI-Flag als vorhandenes Feature dokumentieren. - Ein Aufruf über `https://127.0.0.1:18443` passt nicht zum DNS-SAN. Nicht mit `accept_invalid_certs`, `danger_accept_invalid_certs`, deaktivierter Hostnamenprüfung oder `curl -k` umgehen. SSH ersetzt weder TLS noch Enrollment, mTLS oder Anwendungsautorisierung. ## Lokale Zugangsdaten und Bootstrapgrenzen - VM-Daten liegen ausschließlich in **`credentials/linux-vm.conf`**. Das Verzeichnis muss in `.gitignore` ausgeschlossen sein; vor Nutzung prüfen. `credentials/` erhält Modus **700**, die Datei **600**; nur der vorgesehene lokale Benutzer hat Zugriff. Auch private Schlüssel/Secretdateien restriktiv schützen. Diese Dokumentationsänderung liest oder verändert keine Zugangsdaten. - Die Datei ist **Daten, kein Shellskript**. Nur bekannte Felder mit striktem Parser/Validierung einlesen; unbekannte/ungültige Werte zurückweisen. Niemals `source`, `. credentials/linux-vm.conf`, `eval` oder Shell-Expansion des Inhalts verwenden. Kein bestimmtes vorhandenes Dateischema behaupten oder Secrets für Beispiele öffnen. - Keine Secrets in Commits, Logs, Screenshots, stdout/stderr, Shell-Traces (`set -x`), MCP-/LLM-Kontexten oder Jobausgaben. Keine Passwörter in dokumentierten Kommandozeilen. Zugangsdaten weder zur Dokumentationsprüfung noch zum bloßen Auffinden der VM auslesen. - Entwicklungs-/Testtools dürfen installiert werden. Zieländerungen auf den vereinbarten Bootstrap (z. B. Agent, Truststore, Hosts-Eintrag) begrenzen. **Keine impliziten Ziel-Reboots, Betriebssystemupdates oder destruktiven Tests**; sie benötigen einen gesonderten ausdrücklichen Auftrag und bei RMM-Ausführung zusätzlich den festen menschlich in der WebUI genehmigten Jobplan. Toolinstallation ist keine allgemeine Zieladministrationsfreigabe. ## WebUI-Genehmigung auch in Linux-Dev Jeder Ausführungsjob wird zuerst als Antrag **`pending_approval`** gespeichert. Ein berechtigter Mensch sieht in der WebUI feste Ziele, Einzeljobs/Versuche, Inhalte/Hashes, Fristen und Wirkung und genehmigt genau diesen Plan. Vorher **keine** ausführbaren Jobs/Outbox/JobOffers/Startgrants. Keine Dev-Autofreigabe, Testpolicy, direkte API-/DB-Freigabe oder SSH-Ausführung als vermeintlicher RMM-Erfolgsnachweis. Einzige Ausnahme zur tatsächlichen menschlichen Bedienung ist die folgende ausdrücklich erlaubte dev/test-Browsersimulation, keine Code-Abkürzung. **Userentscheidung 2026-11-12:** „Setz Linux MVP vollständig um und simuliere die menschlichen Aktionen. Du kannst Server auch neustarten“. Ausschließlich für diese Entwicklungsabnahme darf Browserautomatisierung im **expliziten dev/test-Profil** tatsächliche UI-Interaktionen einschließlich Plangenehmigung durchführen. Ein deutlich sichtbar als **simulierter Testprincipal** gekennzeichneter Principal bedient dabei dieselbe UI-Grenze; kein Vortäuschen einer tatsächlichen menschlichen Identität. Planbindung, Rechte-, Tenant- und Policyprüfungen bleiben erhalten. Audit muss `approval_origin` als browsergesteuerte dev/test-Simulation und `testsimulation` als wahr samt Testprincipal, Profil, Zeitpunkt und Planbezug nachvollziehbar kennzeichnen. Das sind Anforderungen, kein Nachweis bereits implementierter Auditfelder. Simulation getrennt von tatsächlicher menschlicher Genehmigung ausweisen, niemals als Produktions-Freigabenachweis. KI/MCP dürfen weiterhin keine direkten API-/DB-Freigaben vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft. Normale UI-Browserrequests bleiben an deren interaktiven Kontext gebunden. Produktionsverhalten bleibt unverändert; dort keine Simulation. Details und Useroverride zum ausgelassenen RustDesk: `docs/project-decisions.md`, normativer Vorrang: Spezifikation 1.5 Kapitel 0.1. Lokale Serverneustarts sind ausdrücklich erlaubt. Dies erlaubt keine impliziten VM-Reboots, Updates oder destruktiven Zieltests und ersetzt keine WebUI-Plangenehmigung; der Zieltestumfang bleibt gesondert ausdrücklich abzustimmen. Diese Dokumentationsänderung führt weder Neustarts noch Simulationen oder Tests aus. Dies gilt für Hello World, Diagnose, `refresh_inventory` als angeforderten Job, Updates, Reboots, Folgejobs und neue Versuche. Passive Standardinventarisierung/Heartbeats und Lesen bereits gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Diese Ausnahme nicht zur Tarnung angeforderter Live-Diagnose nutzen. Solange die UI-Freigabe durch einen berechtigten Menschen oder die eng begrenzte dev/test-Browsersimulation fehlt, bleibt die aktive Teststrecke blockiert; nur unabhängige passive Prüfungen fortführen. ## Nachweisprotokoll (Vorlage, kein Testergebnis) Pro Feature festhalten: Spezifikations-/Codeversion, reale VM-OS-/Architektur, tatsächlich ausgeführte Befehle (redigiert), Zeit, Erwartung, beobachtetes Ergebnis, relevante Fehler und verbleibende Gates. Für Jobs zusätzlich Antrag/Planhash, WebUI-Genehmigung mit `approval_origin`/`testsimulation` und tatsächlichem oder simuliertem Principal, Versuch, Journal-/Startnachweis und fachliche Nachbedingungen referenzieren, ohne Secrets zu veröffentlichen. Simulationsnachweise sind keine Produktionsfreigaben. Getrennte Prüfpunkte: Docker-Bindings nur Loopback; SSH-Forward auf VM nur Loopback; DNS-Auflösung auf VM; TLS-Kette und SAN gültig; ungültiges Zertifikat wird verweigert; Enrollment/mTLS; passives Inventar; `pending_approval` ohne ausführbare Artefakte; Ausführung erst nach WebUI-Klick mit eindeutigem tatsächlichem oder simuliertem Ursprung; korrekte Ergebnisse/Redelivery/Tenant-Isolation; Simulation außerhalb dev/test verweigert. **Diese Prüfungen sind hier geplant, nicht ausgeführt.** Destruktive Fehler-/Reboottests nur nach gesonderter Abstimmung durchführen. Fehlender Realnachweis bleibt offen statt grün. Bekannt bleiben Repository `https://gitea.incoso.eu/kevin_janssen/rust-discovery` (SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`) und RustDesk-Server `rust.ease-technologies.de`. Edition, Ports, öffentlicher RustDesk-Serverschlüssel und Version sind noch unbekannt; fehlende Werte führen zu `not_configured`, nicht zu geratenen Defaults. ## Tatsächlich ausgeführt: minimaler VM-Zugangscheck (2026-11-12) ```sh python3 -m py_compile deploy/vm_access_check.py python3 deploy/vm_access_check.py python3 tests/vm_access_check.py python3 -m py_compile deploy/vm_access_check.py tests/vm_access_check.py ``` - Lokale Credential-Modi 0700/0600 und `.gitignore`-Ausschluss geprüft. Inhalte wurden ausschließlich im ausführenden Python-Prozess als Daten geparst, nicht ausgegeben. - Tatsächlicher SSH-Zugang zur VM mit vorhandenem Benutzer-`known_hosts`-Eintrag und `StrictHostKeyChecking=yes` erfolgreich. Keine Hostkeys hinzugefügt oder verändert. Das Hilfsskript ignoriert SSH-Konfiguration und nutzt keinen Agent-Forward. Passwort-Fallback verwendet bei Bedarf eine temporäre private Datei und Askpass, nicht Passwortargumente; private SSH-Fehlerausgaben werden nicht veröffentlicht. - Read-only auf der tatsächlichen VM beobachtet: Linux, Ubuntu 24.04, x86-64, glibc 2.39; Hostname lesbar und Benutzerhome vorhanden, ohne diese Werte offenzulegen. Port 18443 war laut `ss` zum Prüfzeitpunkt frei. Das ist keine spätere Portreservierung. - Fünf lokale Parser-Tests bestanden: literale Passwortdaten, unbekannte/doppelte Felder, unsichere Dateirechte, ungültiger Port und fehlende Ignore-Regel. Syntaxprüfung bestanden. - **In diesem ersten Zugangscheck nicht ausgeführt:** Binärkompatibilitätsprüfung gegen das konkrete Agentartefakt, SSH-Reverse-Tunnel, VM-Deployment, Enrollment, VM-Agent/Heartbeat/Inventar und systemd. Keine Pakete, Hosts-/Firewall-/sshd-Konfiguration, Updates oder Reboots verändert; keine RMM-Jobs oder Genehmigungsumgehungen. - Vorbereitung zunächst an Kontextgrenze angehalten: gebündelte Pflichtdokumentausgabe wurde abgeschnitten. Vor weiterem Agentbootstrap vollständige Spezifikation und die konkreten Deployment-/Agent-Schnittstellen mit zusätzlichem Lesebudget prüfen. Der erfolgreiche Zugangscheck ist ausdrücklich kein Linux-M1-/Feature-Abnahmenachweis. ## Tatsächlich ausgeführt: passiver VM-Agent über Reverse-Tunnel (2026-11-12) Nach ergänzter vollständiger Pflichtlektüre wurde folgende Strecke tatsächlich ausgeführt: ```sh python3 -m py_compile deploy/vm_passive_test.py python3 deploy/vm_passive_test.py python3 tests/vm_access_check.py python3 tests/vm_passive_test.py python3 -m py_compile deploy/vm_access_check.py deploy/vm_passive_test.py tests/vm_access_check.py tests/vm_passive_test.py python3 deploy/vm_access_check.py ``` `deploy/vm_passive_test.py` ist ein bewusst ausführender, begrenzter VM-Test und kein reiner Zugangscheck. Er liest Credentials nur intern, prüft vorhandene Langläufer und Portbelegung, erzeugt genau ein Enrollment-Token für Dev-Mandant A und hinterlässt eine neue Geräteidentität samt Historie. Kein DB-/PKI-Reset und kein Token-/Key-Echo. **Beobachtete Ergebnisse:** - Kein vorhandener PC-Reverse-Tunnel, kein VM-Agentprozess, kein VM-Listener auf 18443 und kein früheres benutzerlokales Testverzeichnis vorgefunden. Nichts Fremdes gestoppt. - Tatsächlich laufender Docker-Server ausschließlich `127.0.0.1:18443`; PostgreSQL ohne veröffentlichten Port. Lokaler Healthcheck mit vertrauenswürdiger CA bestanden. - Agentartefakt aus dem bereits laufenden Docker-Server kopiert, kein neuer Imagebuild: Linux-x86-64-ELF, höchste referenzierte glibc-Version 2.34; VM hat glibc 2.39. Alle ELF-`NEEDED`-Bibliotheken im VM-Laufzeitcache gefunden. Vor nativem Agentstart VM-Loader `/lib64/ld-linux-x86-64.so.2 --list` gegen das konkrete Artefakt erfolgreich. SHA-256: `667065dded71cc499b171bc799ad09f3ac7f049a72a9d54f4c943331a565eefe`. - PC initiierte SSH mit `-N -T`, `StrictHostKeyChecking=yes`, `ExitOnForwardFailure=yes`, Keepalive 30/3 und `-R 127.0.0.1:18443:127.0.0.1:18443`. VM-seitig per `ss` genau dieser IPv4-Loopbacklistener bestätigt. Keine Hostkey-/sshd-/Firewalländerung. - Nur Binary, öffentliche CA und einmaliges Token per SSH-stdin in ein neues privates Benutzer-Testverzeichnis übertragen. Geräteschlüssel auf der VM erzeugt; kein CA-/Server- Privatschlüssel oder Viewer-Bearer übertragen. Kein Root-/systemd-/Paketbootstrap. - Native VM-Agentstrecke mit `RMM_CONNECT_ADDR=127.0.0.1:18443`, eigenem privaten Zustand und CA gestartet. Der vorhandene Override verändert nur TCP; Enrollment und WSS prüfen weiterhin TLS-SNI/DNS-Namen `rmm-dev.internal`. Kein Hosts-Eintrag nötig, keine Zertifikatsprüfung deaktiviert; keine Rust-/Protokolländerung erforderlich. - Über echte tenantgebundene Lese-API exakt diese neue Agent-ID zugeordnet: Inventar-Erhebungszeit **16:40:12.632 UTC**, Empfang **16:40:12.796518 UTC**; Hostname intern mit SSH-Baseline verglichen, ohne ihn zu veröffentlichen. OS Ubuntu 24.04, x86-64, tatsächlich verfügbare Root-Bytes und Inodes positiv, Scope `linux.base`, Vollständigkeit `partial`, fachliche Gesundheit `unknown`. - Zwei verschiedene frische Heartbeats serverseitig beobachtet: **16:40:44.849118 UTC** und **16:41:12.779675 UTC**; Präsenz `online`. Der Gateway-Code aktualisiert `last_contact_at` ausschließlich im Heartbeat-Zweig. Leser von Dev-Mandant B sah diese Agent-ID nicht. - Enrollment-Tokenkopie auf der VM entfernt. Test-Agent-PID **4141792** per SIGTERM gestoppt, vorher exakten `/proc/PID/exe`-Pfad geprüft; anschließend Prozessende geprüft. Nur den eigenen SSH-Tunnel-PID **1869118** beendet und auf Prozessende gewartet. Geschütztes lokales Nachweisprotokoll mit PIDs, Zeitpunkten und privatem Remotepfad: `devstate/vm-passive/result.json`. Kein aktiver verwalteter Testrecord zurückgeblieben. Privates VM-Testverzeichnis mit Geräteidentität und Log bleibt für kontrollierte Fortsetzung erhalten, keine laufende Installation. Secrets/Logs daraus nicht veröffentlichen. - Fünf Parser-Tests erneut bestanden; drei lokale Orchestrierungs-Guardtests bestanden (Fail-closed, private Fehlerausgaben unterdrücken, Remote-Code nur über stdin). Python-Syntaxprüfung bestanden. Abschließender tatsächlicher lesender VM-SSH-Check nach dem Test erfolgreich; VM-Port 18443 wieder frei. Keine Rust-Änderungen, daher Rust-Build/Clippy und übrige Integrationstests hier nicht erneut ausgeführt. **Verbleibend:** Kein systemd-/Dienst-/Installer-Nachweis, keine Rotation, Ablauf-Recovery, Long Polling, Reconnect-/Widerrufsabnahme auf VM, Proxy-/Klon-/Restore-/Lastabnahme. Keine Jobs, WebUI-Freigaben, Updates oder Reboots ausgeführt. Der passive VM-Erstnachweis ist erfolgreich, **M1 insgesamt und Linux-MVP bleiben unabgenommen**.