# Rust Discovery / RMM — Linux-MVP und Windows-Vorbereitung > **Entwicklung wiederaufgenommen (2026-11-13).** Der Server zieht auf ausdrücklichen > Userwunsch auf einen dedizierten Internetserver um; der Entwickler-PC dient > ausschließlich als Entwicklungsrechner, ohne installierten RMM-Client. Die > Cloud-Test-VM ist der aktuelle Client. Aktuelle Topologie und tatsächlicher > Deploymentstand: [docs/server-deployment.md](docs/server-deployment.md). > Die lokalen Serverbefehle und Slice-Beschreibungen unten sind historisch. **Aktuell (Spezifikation 1.9):** Windows darf auf ausdrücklichen Userwunsch bereits parallel entwickelt werden. Windows-11-VM per abgesichertem Reverse-SSH mit Administratortoken erreichbar; noch kein RMM-Windows-Client installiert. Linux-Cloud-Agent, getrennte API/Gateway-Rollen, echte WebUI-Genehmigung und native Basis-/Rootdienstjobs sind nachgewiesen. APT-100-Ursache gefunden und Provider-/Sandboxkorrektur nativ als Readiness geprüft; Paketabnahme selbst bleibt offen. Aktueller Stand: [Implementierungsstand](docs/implementation-status.md), [Windows-Entwicklungszugang](deploy/windows/README.md). ## 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](Rust_RMM_Implementierungsspezifikation.md), [AGENTS.md](AGENTS.md), [Entwicklungsweg](docs/development.md). Den tatsächlichen Prüfstand und offene Abnahmen nennt [implementation-status](docs/implementation-status.md). ## 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-config` und OpenSSL-Entwicklungsbibliotheken. Toolchain über `rust-toolchain.toml`; vollständige Dependency-Auflösung über `Cargo.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-Port `127.0.0.1:18443` wird am PC veröffentlicht. ## Lokaler Server ```sh 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: ```sh 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 `. 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 ```sh 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: ```text 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 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 ```sh 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.