172 lines
9.0 KiB
Markdown
172 lines
9.0 KiB
Markdown
# 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 <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
|
||
|
||
```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 <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
|
||
|
||
```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.
|