Rust Discovery / RMM — Linux-MVP und Windows-Client
Entwicklung wiederaufgenommen (2026-11-13). Der endgültige Server läuft auf
discovery.ease-technologies.de; der Entwickler-PC dient ausschließlich als Entwicklungsrechner, ohne installierten RMM-Client. Die Cloud-Linux-VM und eigenständiger Windows-11-Gast sind die Testclients. Topologie und Deploymentstand: docs/server-deployment.md. Die lokalen Serverbefehle und Slice-Beschreibungen unten sind historisch.
Aktuell (Spezifikation 1.13): Windows darf auf ausdrücklichen Userwunsch bereits parallel entwickelt werden. Erster nativer Windows-Client als LocalService mit mTLS/WSS, gespeichertem Inventar, zwei frischen Heartbeats und Mandantentrennung auf der Windows-11-VM nachgewiesen. Sieben native Tests bestanden. Keine Windows-Jobcapability, erster Build unsigniert. Linux-Cloud-Agent, getrennte API/Gateway-Rollen, echte WebUI-Genehmigung und native Basis-/Rootdienstjobs, begrenzte Rootlogs und übereinstimmende gespeicherte UI-/HTTP-/MCP-Ergebnisse sind nachgewiesen. TLS-Lebenszyklus, tatsächliche Doppelzustellung/ACK-Verlust und automatischer WSS→HTTPS-Fallback bestanden. Ursprüngliche APT-Teilwirkung ehrlich als fehlgeschlagen abgeglichen; danach eigener genehmigter Configureversuch mit APT0/installed1.0, aber verweigerter Abnahme wegen Host-Neustartmarker. Dieser Versuch bleibt unknown, keine rückwirkende Acceptance oder Wiederholung. Readonly-Abgleich, Upgrade1.1/Noops, Offline-/Abbruch-/Rebootabnahme und MVP-Endaudit weiter offen. Aktueller Stand: Implementierungsstand, Windows-Client, Plattformmatrix, Entwicklungszugang.
Historischer erster passiver Slice
Kein fertiges MVP, keine Produktionsfreigabe. Implementiert sind ein Rust-Workspace, PostgreSQL mit mandantenlokalen Transaktionen/RLS und eine passive Linux-Agentstrecke: Enrollment → lokaler P-256-Schlüssel → Gerätezertifikat → mTLS-WSS → Heartbeat/Basisinventar. Es gibt keine Jobtypen, Ausführungsqueue, Startgrants, Shell oder Executor. Jobs bleiben bis zu M2 einschließlich interaktiver menschlicher WebUI-Genehmigung ausgeschlossen.
Lokal nachgewiesen: PKI-Bootstrap unter OpenSSL 1.1.1w sowie Ende-zu-Ende-Tests mit Docker-Server/PostgreSQL und nativem lokalem Linux-Agenten bestehen. Auf der tatsächlichen Linux-Test-VM sind außerdem Enrollment/mTLS-WSS, passives Basisinventar und zwei frische Heartbeats über den PC-initiierten Loopback-Reversetunnel nachgewiesen. Der begrenzte Testprozess wurde danach gestoppt. Systemd und M1 insgesamt sind nicht abgenommen. Details im Implementierungsstand.
Verbindliche Produkt- und Arbeitsregeln: Spec, AGENTS.md, Entwicklungsweg. Den tatsächlichen Prüfstand und offene Abnahmen nennt implementation-status.
Voraussetzungen
- Linux x86-64, Docker Engine und Compose v2, Python 3, OpenSSL.
- Für native Entwicklung: exakt Rust 1.99.1,
rustfmt,clippy, C-Compiler,pkg-configund OpenSSL-Entwicklungsbibliotheken. Toolchain überrust-toolchain.toml; vollständige Dependency-Auflösung überCargo.lock. - Docker baut Server und Agent mit
rust:1.99.1-bookworm; Laufzeit Debian Bookworm. PostgreSQL ist intern, hat keinen veröffentlichten Port. Ausschließlich der TLS-Port127.0.0.1:18443wird am PC veröffentlicht.
Lokaler Server
python3 deploy/dev.py init
python3 deploy/dev.py up
python3 deploy/dev.py status
init erzeugt zufällige Datenbankpasswörter, getrennte Dev-Leseidentitäten und eine
Dev-CA mit Server-SAN rmm-dev.internal ausschließlich unter gitignored devstate/
(Verzeichnis 0700, Secrets 0600). Es überschreibt keinen vorhandenen Zustand.
Die isolierte deploy/openssl.cnf definiert CA-, Server- und Clientrollen ohne
Host-Konfigurationsübernahme oder doppelte Erweiterungen. Vorhandene fehlerhafte
PKI nicht durch erneutes init oder Löschen von Schlüsseln/Agentidentitäten ersetzen;
sie benötigt eine separat geprüfte lokale Reparatur.
up baut das Image, startet das eigene Compose-Projekt rust-discovery-dev, führt
SQLx-Migrationen als rmm_migrator aus und startet den unprivilegierten Server.
Ein frischer Zustand muss initialisiert werden; alte Datenvolumes werden nicht automatisch gelöscht.
Nur der Server ist zusätzlich im Ingress-Bridge-Netz, damit Docker den Loopback-Port
veröffentlicht; PostgreSQL und Migrator bleiben ausschließlich im internen Backend-Netz.
Zwei feste Entwicklungsmandanten:
| Mandant | ID | geschützte lokale Leseidentität |
|---|---|---|
| A | 11111111-1111-4111-8111-111111111111 |
devstate/viewer-a.token |
| B | 22222222-2222-4222-8222-222222222222 |
devstate/viewer-b.token |
Dev-Bearer sind reine Leser genau eines Mandanten, keine Freigeber. RMM_PROFILE=development
und RMM_DEV_AUTH=true sind beide zwingend. Alle Produktionsprofile verweigern den Start,
auch mit deaktiviertem Dev-Auth: ein OIDC-Produktionsadapter existiert noch nicht.
RMM_SERVER_ROLE=api|gateway|all wählt die tatsächlich vorhandenen Rollen; lokal
ist all explizit konfiguriert. api lädt keinen CA-Signierschlüssel und bietet
keine Agentendpunkte an; gateway bietet keine Verwaltungs-Leseendpunkte an.
Produktive Dienstidentitäten/Signer-Isolation sind damit noch nicht abgenommen.
TLS-Healthprüfung ohne DNS-/Hosts-Änderung:
curl --noproxy '*' --cacert devstate/pki/ca.pem \
--resolve rmm-dev.internal:18443:127.0.0.1 \
https://rmm-dev.internal:18443/healthz
API: GET /api/v1/tenants und GET /api/v1/tenants/{tenant_id}/devices, mit
Authorization: Bearer <Inhalt der passenden geschützten Token-Datei>.
Secrets nicht in Shell-History, Terminalausgabe oder Diagnoseprotokolle kopieren.
Gerätelisten sind vorerst auf 100 begrenzt; weitere Datensätze werden als truncated
ausgewiesen, Cursor/Pagination und Einzelgerät-API fehlen noch.
Linux-Agent lokal entwickeln
cargo build --locked -p rmm-agent -p rmm-server
python3 deploy/dev.py token a
RMM_AGENT_STATE=devstate/agent \
RMM_CA_FILE=devstate/pki/ca.pem \
RMM_ENROLLMENT_TOKEN_FILE=devstate/enroll-a.token \
RMM_CONNECT_ADDR=127.0.0.1:18443 \
target/debug/rmm-agent
Enrollment-Token sind einmalig und 15 Minuten gültig. Der Agent erzeugt den privaten Geräteschlüssel lokal (0600), schreibt seine Identität in sein privates Zustandsverzeichnis und verwendet sie nach Neustart erneut. Nach erfolgreichem Enrollment die lokale Tokenkopie entfernen. Ein zweiter Prozess auf demselben Agentzustand wird per Lock abgewiesen. Nicht denselben Agentzustand in VM-Templates klonen.
RMM_CONNECT_ADDR überschreibt ausschließlich das TCP-Ziel, nicht TLS-SNI oder
Namensprüfung: geprüft wird immer rmm-dev.internal gegen die explizite Dev-CA.
Keine Proxy-/System-CA-Abkürzung, kein Abschalten von TLS-Prüfungen.
Heartbeat 27–33 Sekunden, Vollinventar bei Verbindung und täglich; Root-Dateisystem
mit verfügbaren Bytes/Inodes, /etc/os-release, Hostname und Architektur. Das Inventar
ist ausdrücklich partial — kein vollständiges Hardware-/Softwareinventar.
Echte Linux-VM / SSH-Reversepfad
Der verbindliche Pfad und Hostkey-Vertrauensklärung stehen in docs/development.md.
Benutzerlokaler passiver VM-Test ausgeführt; keine dauerhafte systemd-Installation/-Abnahme.
Die Vorlage deploy/rmm-agent.service ist daher nicht als nativ abgenommen zu verstehen.
Ausgeführte Befehle, Grenzen und private Evidenzpfade stehen in docs/development.md.
python3 deploy/vm_access_check.py ist der minimale lesende Zugangscheck.
python3 deploy/vm_passive_test.py führt dagegen einen echten begrenzten Bootstrap/
Enrollment-Test aus und erzeugt eine neue Dev-Geräteidentität samt Historie; nicht
unbesehen wiederholen. Er stoppt nur seine eigenen Agent-/Tunnelprozesse und erhält
das private VM-Testverzeichnis. Keine Root-/Paket-/Hosts-/Firewalländerungen oder Jobs.
Geplanter Transport, erst nach bestätigtem SSH-Hostkey und freigegebenem Bootstrap:
PC ssh -N -T -o BatchMode=yes -o StrictHostKeyChecking=yes
-o ExitOnForwardFailure=yes -o ServerAliveInterval=30
-o ServerAliveCountMax=3
-R 127.0.0.1:18443:127.0.0.1:18443 <bestätigtes-VM-Ziel>
VM-Agent RMM_CONNECT_ADDR=127.0.0.1:18443
Der VM-Agent benötigt nur Binary, öffentliche CA und einmaliges Token. Keine CA-Privat- oder Server-/Viewer-Schlüssel auf die VM kopieren. Kompatible glibc/OpenSSL-Laufzeit vor Bootstrap lesen und prüfen. Keine Remote-Paketinstallation, Updates oder Reboots als stillschweigende Voraussetzung. Für eine manuell gestartete Abnahme Logs und PID im privaten Agentverzeichnis halten und beim Beenden nur diesen Prozess stoppen.
Prüfungen
cargo fmt --all --check
cargo clippy --locked -p rmm-domain -p rmm-protocol -p rmm-persistence \
-p rmm-server -p rmm-agent-linux -p rmm-agent --all-targets -- -D warnings
cargo test --locked -p rmm-domain -p rmm-protocol -p rmm-agent-linux -p rmm-agent
python3 tests/bootstrap.py
python3 tests/local_integration.py
Integration benötigt laufenden lokalen Compose-Server und gebaute Debug-Binaries. Sie erstellt echte temporäre Geräte/Token, startet den nativen lokalen Linux-Agenten, prüft Enrollment-Rennen, TLS-Fehler, RLS, Mandantentrennung, Heartbeat, Neustart und Widerruf. Testgeräte werden anschließend widerrufen; Historie bleibt im Entwicklungsbestand. Tests lesen keine VM-Credentials und ersetzen keine VM-/Dienstabnahme.
Stoppen ohne Daten-/Schlüsselverlust: python3 deploy/dev.py down.
Keine ungezielte Docker-Bereinigung verwenden; fremde Container bleiben unangetastet.