Files
rust-discovery/docs/development.md
T
BuTzZ 6c3203d725
Rust development slice / linux (push) Failing after 1m10s
feat: snapshot Linux-first RMM MVP and pause handover
2026-11-12 22:06:25 +01:00

19 KiB
Raw Blame History

Linux-first-Entwicklung und reale VM-Abnahme

Stand: 2026-11-12 · Spezifikation 1.5. Dieses Dokument beschreibt verbindliche Entwicklungsregeln und einen grundsätzlich geplanten Ablauf. Tatsächlich ausgeführte Prüfungen stehen ausdrücklich im Nachweisabschnitt am Ende; die übrigen Beispiele sind keine Testergebnisse. Tatsächlicher Implementierungsstand wird separat geführt.

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

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.

# 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):

    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)

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:

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.