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

172 lines
9.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.