Enforce customer boundaries on token administration and finalize fleet navigation

This commit is contained in:
2026-11-17 22:05:44 +01:00
parent 0afaca1d64
commit 312da6f39e
25 changed files with 1207 additions and 208 deletions
+5 -1
View File
@@ -1,6 +1,10 @@
# Verbindliche Projektentscheidungen
Stand: **2026-11-17**, Spezifikation **1.35** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung.
Stand: **2026-11-17**, Spezifikation **1.36** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung.
## Kunden und Gerätebestand (Version 1.36)
Die WebUI startet mit den authentisierten Geräten der berechtigten Kunden. Die Historie bewahrt ausgemusterte und unbestätigte Installationen getrennt auf. Jedes Gerät gehört über seine Aufnahme zu genau einem Kunden. MCP-Berechtigungen bestehen aus Aktionsrechten und einer festen Kundenauswahl oder einem ausdrücklich globalen Kundenkreis einschließlich künftiger Kunden. Die frühere Beschränkung auf genau einen Kunden je Token entfällt. [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md)
## Öffentliche WebUI und MCP ohne OAuth (Version 1.35)
+10 -2
View File
@@ -12,16 +12,24 @@ Die Kontokonfiguration liegt auf dem Server unter `/opt/rust-discovery/devstate/
## MCP-Tokens
Nach der WebUI-Anmeldung im Bereich **MCP-Tokens** einen Namen, die benötigten Rechte und ein Ablaufdatum wählen. Standard sind gespeichertes Inventar, Protokolle und Aufträge/Ergebnisse lesen. Der Tokenwert wird einmal angezeigt. Er kann anschließend im MCP-Client als HTTP-Header hinterlegt werden.
Nach der WebUI-Anmeldung unter **Verwaltung → MCP-Tokens** einen Namen, den Kundenkreis, die benötigten Rechte und ein Ablaufdatum wählen. Ein einzelner Kunde ist vorausgewählt. Weitere Kunden lassen sich einzeln ergänzen. „Alle aktuellen und zukünftigen Kunden“ ist eine eigene Option für Kundenadministratoren. Standard sind gespeichertes Inventar, Protokolle und Aufträge/Ergebnisse lesen. Der Tokenwert wird einmal angezeigt. Er kann anschließend im MCP-Client als HTTP-Header hinterlegt werden.
```http
Authorization: Bearer <MCP-Token>
```
Ein Token besteht aus einem Präfix und 32 zufälligen Bytes. Der Server speichert ausschließlich dessen SHA-256-Prüfwert. Jedes Token besitzt einen eigenen Principal, Mandanten, feste Scopes, Ablauf und Widerruf. Jede Anfrage wird erneut geprüft. Die wirksamen Rechte sind die Schnittmenge aus Scopes und aktiver Membership. Der Widerruf greift auch bei einer bereits geöffneten MCP-Sitzung. Tokens können mit entsprechenden Rechten Anträge planen und einreichen. Die Jobgenehmigung erfolgt durch die Person in der WebUI. Tokenverwaltung verlangt eine echte interaktive Sitzung mit `tokens:manage` und CSRF-Schutz.
Ein Token besteht aus einem Präfix und 32 zufälligen Bytes. Der Server speichert ausschließlich dessen SHA-256-Prüfwert. Jedes Token besitzt einen eigenen Principal, einen Ausgabekunden, einen Kundenkreis, feste Scopes, Ablauf und Widerruf. Jede Anfrage wird erneut geprüft. Die wirksamen Rechte sind die Schnittmenge aus Scopes und aktiver Membership. Der Widerruf greift auch bei einer bereits geöffneten MCP-Sitzung. Tokens können mit entsprechenden Rechten Anträge planen und einreichen. Die Jobgenehmigung erfolgt durch die Person in der WebUI. Tokenverwaltung verlangt eine echte interaktive Sitzung mit `tokens:manage` und CSRF-Schutz.
Der verwendete MCP-Client muss einen manuell konfigurierbaren Bearer-Header unterstützen. Die standardisierte automatische MCP-HTTP-Autorisierung beschreibt einen OAuth-Ablauf. Die hier eingerichtete statische Tokenanmeldung verwendet den vorhandenen HTTP-Transport mit selbst verwalteten Zugangsdaten. [MCP-Autorisierung](https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization)
## Geräte und Kunden bedienen
**Geräte → Bestand** zeigt die bestätigten Online- und Offline-Geräte. Über **Historie** sind frühere Installationen erreichbar. Der Hostname öffnet das Inventar mit Laufwerken, Erhebungszeit und den letzten Aufträgen. In der Detailansicht erlaubt **Gerät verwalten** das Archivieren und Zurückholen. Archivieren steuert die Sichtbarkeit, ein Widerruf sperrt die Identität.
**Kunden** erlaubt berechtigten Personen das Anlegen und Umbenennen. Bei **Gerät aufnehmen** zuerst den Kunden im Kopfbereich wählen und anschließend den Einmalcode ausstellen. Für einen Kundenwechsel die bisherige Identität widerrufen und das Gerät beim Zielkunden neu aufnehmen. Frühere Ergebnisse bleiben beim ursprünglichen Kunden.
Der Entwicklungsoperator kann dem bereits eingerichteten lokalen Betreiberkonto über `python3 tools/dev_public_access.py grant-customer-admin` die Kundenadministration zuweisen. Ein signierter Release lässt sich mit `python3 tools/dev_customer_starters.py --tenant UUID --platform PLATTFORM --release RELEASE_UUID` als Installationspaket für leere Kundenkataloge bereitstellen. Das Werkzeug prüft die Objektprüfsummen. Bei der ersten Codeausgabe übernimmt der Server das Paket in den Katalog des Zielkunden. Bereits befüllte Kataloge pflegt der Betreiber je Kunde über den regulären Releaseweg.
## Entwicklung und Deployment
Der öffentliche API-Dienst `public-api` läuft unprivilegiert auf `127.0.0.1:18445`, im Produktionsprofil mit lokalem Passwort/TOTP und ohne Entwicklungszugänge. Der private Entwicklungsdienst bleibt auf `127.0.0.1:18443`. PostgreSQL hat keinen veröffentlichten Port. Der Reverseproxy verifiziert das TLS-Zertifikat des jeweiligen internen Dienstes. Öffentliche Anmeldung und MCP gehen an `public-api`, die vorhandenen Bootstrapdownloads an das Gerätegateway.