Files
rust-discovery/Rust_RMM_Implementierungsspezifikation.md
T
2026-11-18 21:35:28 +01:00

10 KiB

Produktvertrag des Rust-Discovery-MVP

Dieser Vertrag beschreibt den ausgelieferten Funktionsumfang. Die eingesetzten Versionen und die Ergebnisse auf den Zielgeräten stehen in der MVP-Abnahme.

Server, Geräte und Kunden

Der Server betreibt die WebUI, den MCP-Endpunkt, den Releasekatalog und das Gerätegateway. PostgreSQL speichert die kundengebundenen Verwaltungsdaten. Der Geräteverkehr geht vom Client aus. Ein aufgenommener Agent authentisiert sich mit seinem Gerätezertifikat, übermittelt Heartbeats und Inventar, holt eventuell vorliegende Aufträge ab und meldet deren Verlauf und Ergebnis. Auch im Leerlauf meldet sich das Gerät regelmäßig.

Jede Installation ist an Kunde, Gerät und Agentenidentität gebunden. Die Standardansicht zeigt bereits authentisierte aktuelle Geräte als online oder offline, mit Hostname, Type, Betriebssystem, freiem und gesamtem Speicherplatz, RAM, CPU und Kunde. Ausgemusterte, ersetzte und unbestätigte Kopplungen sind getrennt in der Historie abrufbar. Fehlende Inventarwerte bleiben als solche erkennbar. Der Zeitpunkt des letzten Kontakts und der Zeitpunkt der Inventarmessung haben unterschiedliche Bedeutung. Geräteauswahl

Der Agent meldet den Gerätetyp mit dem passiven Hardwareinventar. physical bezeichnet einen physischen Rechner, virtual ein virtualisiertes System und hypervisor eine erkannte Hostrolle. Proxmox VE erscheint als hypervisor mit Proxmox VE in der Spalte OS. Eine erkannte Hostrolle hat Vorrang, auch bei verschachtelter Virtualisierung. Bei fehlender Angabe zeigt die WebUI „Nicht gemeldet“. Die Geräteabfragen in WebUI und MCP verwenden denselben gespeicherten Typ. Inventarprojektion

Die RAM-Spalte zeigt den für Anwendungen verfügbaren und den gesamten physischen Arbeitsspeicher in GiB. Wie beim Speicherplatz zeigt ein Balken den belegten Anteil. Die CPU-Spalte ergänzt die zuletzt gemessene Systemauslastung als Prozentwert. Die Agenten gewinnen sie aus den CPU-Zeitdifferenzen zwischen zwei Heartbeats im Abstand von ungefähr 30 Sekunden. Linux liefert systemweite Werte. Windows liefert den Wert, wenn alle logischen CPUs zu einer einzigen Prozessorgruppe gehören. Vor dem ersten aussagekräftigen Intervall bleibt die Auslastung offen. Die WebUI und MCP lesen dieselbe letzte Messung. Für Agenten ohne Ressourcenmeldung stammen verfügbare RAM-Werte aus dem vorhandenen Inventar. Inventarprojektion

Kunden lassen sich in der WebUI anlegen und umbenennen. Unter Gerät verwalten → Kunden wechseln wählt eine berechtigte Person den Zielkunden. Der Server prüft die Rechte zur Geräteverwaltung im bisherigen Kunden und zur Geräteaufnahme im Zielkunden. Der bereits installierte Agent empfängt den Wechsel über seine authentisierte Verbindung und erhält ein neues Zertifikat für eine neue Kopplung. Nach der ersten Inventarmeldung beim Zielkunden bestätigt die Person den Abschluss in der WebUI. Der Server sperrt die bisherige Geräteidentität. Inventar und Auftragsergebnisse der bisherigen Kopplung bleiben beim bisherigen Kunden. Noch nicht abgeschlossene Aufträge, ungeklärte Versuche und gültige offene Genehmigungen müssen vor dem Wechsel abgeschlossen werden. Gerätegebundene erhöhte Rechte erfordern eine eigene Bindung für die neue Kopplung.

Eine ausgeschiedene Installation kann nach Widerruf und persönlicher Bestätigung endgültig gelöscht werden. Ein noch gültiger offener Genehmigungsantrag oder ein nicht abgeschlossener Job einschließlich unknown sperrt die Löschung. Daten weiterhin beteiligter Zielgeräte bleiben erhalten. Regeln zur Löschung

In den Gerätedetails erscheinen OS-Installationszeit, letzter Systemstart, Hersteller, BIOS-Seriennummer, Netzwerkkarten samt IPv4- und IPv6-Adressen, installierte Software und die bei der letzten Inventur angemeldeten Benutzer. Windows meldet den vom Betriebssystem erfassten Installationszeitpunkt. Linux kennzeichnet den Zeitstempel aus dem Installer-Verzeichnis oder dem Root-Dateisystem als Schätzung. Das Softwareinventar erfasst Linux-Pakete aus dpkg und Windows-Systeminstallationen aus der Uninstall-Registrierung. Begrenzte Meldungen werden ausgewiesen. Herstellergarantie und Firmwaredaten erscheinen bei verfügbarem Befund. Die Daten gehören zum kundengebundenen Inventar des Geräts. Geräteansicht

Vom Skript zum Ergebnis

Schritt Verhalten
Skript veröffentlichen In der Bibliothek eines Kunden erhält ein Skript einen Namen, einen Interpreter, einen Standard-Ausführungskontext und eine unveränderliche Version. Eine Bearbeitung veröffentlicht eine weitere Version.
Auftrag planen Zielgeräte eines Kunden auswählen und entweder die genaue Bibliotheksversion oder ein eigenes Skript angeben. Der Plan bindet Skriptbytes, Geräteinstallation, Ausführungsrechte, Zeitfenster, Laufzeit, Ausgabegrenze und Versuch. Eine spätere Bibliotheksänderung ändert den Plan nicht.
Einreichen und genehmigen Die Einreichung erzeugt einen Antrag mit Status pending_approval. Erst die interaktive WebUI-Genehmigung erzeugt ausführbare Jobs. Im Verlauf stehen Entscheidung, Person und Zeitpunkt. Ein abgelehnter Antrag erzeugt keine Ausführung.
Ausführen Der Client holt den Auftrag ab. Er prüft die signierte, versuchsgebundene Starterlaubnis und führt das Skript im vorgesehenen Konto aus. Vor Ort ist keine Benutzerbestätigung nötig. Doppelte Zustellung darf den Versuch nur einmal starten.
Ergebnis lesen Der Server speichert Zustand, Exitcode und verfügbare Standard- und Fehlerausgabe pro Ziel und Versuch. Die WebUI zeigt Skriptinhalt und Ergebnis im Auftrag. MCP liefert über die Auftrags-ID den Gesamtstand und über die Job-ID das einzelne Ergebnis.

Linux führt Shellskripte unter dem Dienstkonto oder über den eingerichteten Helper als root aus. Windows führt PowerShell unter LocalService oder über den Helper als SYSTEM aus. Neustart und Installation von Windows-Updates sind Skriptaufträge. Bei einem Neustart kann das Skript bereits vor dem Herunterfahren erfolgreich enden. Der Betriebsnachweis verbindet den neuen Bootbezug mit dem nächsten authentisierten Kontakt und einem Folgeauftrag. Skriptbibliothek · Auftragsverarbeitung

Ein Abbruchwunsch wird am Auftrag gespeichert. Bei unterbrochener Rückmeldung gleichen Server, Agent und gegebenenfalls Helper den gespeicherten Versuch ab. Bei unknown bleibt die Wirkung ungeklärt. Die WebUI kann einen solchen Fall dokumentiert abschließen. Agent und Helper übernehmen den Abschluss im signierten Abgleich auch dann, wenn der Agent den Abbruch seiner eigenen Ausführung protokolliert hat und im unabhängig gebundenen Verbrauchsjournal des Helpers ein Ergebnis fehlt. Beide bewahren die ursprünglichen Belege. Der Abschluss erteilt keine Freigabe für einen weiteren Versuch.

Öffentliche Verwaltung und Berechtigungen

Die WebUI verwendet HTTPS mit lokalem Passwort und TOTP. MCP verwendet HTTPS mit individuell ausgestellten, befristeten und widerrufbaren Bearer-Tokens. Ein Token gilt für ausgewählte Kunden oder ausdrücklich für alle aktuellen und künftigen Kunden. Der Server prüft die Aktion im Zielkunden und kontrolliert die Rechte der Beteiligten erneut vor Ausführung.

MCP unterstützt Kunden- und Geräteabfragen, Skriptbibliothek, Planung, Einreichung, Auftrags- und Ergebnisabfrage, Abbruchanforderung sowie gespeicherte Status-, Log- und Releaseabfragen. Kundenpflege, Tokenverwaltung und persönliche Entscheidungen erfolgen in der WebUI. Die vom Server angebotenen MCP-Werkzeuge und deren Parameter sind im Toolkatalog definiert. MCP-Werkzeuge · Bedienung und Rechte

Für administrative Skripte gilt zusätzlich das Plattformrecht root:execute oder system:execute. Bei einem installierten signierten Helper kann der Betreiber die vorhandene zentrale Geräteregel mit mcp:scoped für berechtigte Token öffnen. Der Server prüft Kunde, aktuelle Tokenrechte, Installation, Helper und gegebenenfalls die in der Regel festgelegten Skriptbeschränkungen. Eine Tokenrotation erfordert keine Anpassung auf dem Gerät. Geräteregel

Geräteaufnahme und Agentupdates

Die WebUI erzeugt einen kundengebundenen Einmalcode und zeigt die HTTPS-Installationsanleitung für die verfügbare Plattform. Zum Erstbezug braucht das Gerät eine vertrauenswürdige TLS-Verbindung. Der Installer prüft Vertrauensmaterial und Release, richtet die lokalen Dienste ein und nimmt das Gerät auf. Anschließend verwendet die Installation ihre eigene Identität. Der lokale Administrator richtet den privilegierten Skript-Helper ein, wenn das Gerät auch Administratoraufträge erhalten soll. Serverseitiger Bootstrap

Der Server stellt je Kunde und Plattform Agent und Helper mit einem gemeinsam signierten Manifest bereit. Das Manifest bindet die Hashes und Größen der Binärdateien. Für die Erstaufnahme liefert der Server auch den passenden Bootstrap-Updater. Das gemeinsame Linux-Installationsskript erkennt x86-64 und ARM64 auf dem Zielgerät. Beide GNU/Linux-Architekturen haben einen eigenen Releasekanal, Signierschlüssel und Bootstrap-Pin. Windows x64 verwendet offiziell x86_64-pc-windows-gnu. Der lokale Updater fragt regelmäßig nach einer neueren veröffentlichten Generation, prüft die Bindung an Plattform, Schlüsselring, Releasefolge und Binärhashes und aktiviert das geprüfte Paar unter derselben Geräteidentität. Auf Linux steuert ein systemd-Timer den Abruf, auf Windows ein eigener Updatedienst.

Für Erstinstallation und Update muss das Manifest zum Prüfzeitpunkt gültig sein. Beim bereits installierten Administrator-Helper prüft der Server die Gültigkeit zum gespeicherten Registrierungszeitpunkt des Releases und die Signatur gegen den aktuellen Schlüsselring. Der Ablauf des Manifests allein blockiert daher keinen Adminauftrag auf diesem Client. Releaseprüfung · Build und Veröffentlichung