Files
rust-discovery/README.md
T
2026-11-13 15:50:34 +01:00

9.0 KiB
Raw Blame History

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. 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, Windows-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-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

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.