10 KiB
WebUI und MCP bedienen
Die öffentliche WebUI verwendet ein lokales Benutzerkonto mit Passwort und einem sechsstelligen TOTP-Code. Ein MCP-Client verbindet sich per HTTPS mit seinem eigenen Bearer-Token. Die Anmeldung und die Genehmigung eines konkreten Auftrags sind getrennte Schritte. WebUI · MCP-Endpunkt
Geräte und Kunden
Geräte zeigt bestätigte Online- und Offline-Geräte der berechtigten Kunden mit Hostname, Betriebssystem, Status, freiem und gesamtem Speicherplatz, RAM, CPU und Kunde. Die Historie enthält unter anderem archivierte und widerrufene Installationen. Ein Klick auf den Hostnamen öffnet das Inventar und die letzten Aufträge. Der Kundenname in der Kopfzeile zeigt, in welchem Kunden die nächste Änderung erfolgt.
Berechtigte Benutzer können Kunden anlegen und umbenennen. Zur Aufnahme den Zielkunden wählen und unter Verwaltung → Geräteaufnahme einen Einmalcode erzeugen. Der Code gilt für diesen Kunden und verfällt bei erfolgreicher Aufnahme oder nach 15 Minuten. Die WebUI zeigt für die veröffentlichten Plattformen Download und Installationsbefehl. Auf dem neuen Gerät das HTTPS-Skript mit Administratorrechten aufrufen und den Code am Prompt eingeben. Für lokale Administrator-Skripte die dafür angebotene Installationsoption wählen. Der Windows-Kanal ist x86_64-pc-windows-gnu. Linux-Installer · Windows-Installer
Hypervisor einer VM zuordnen
Eine VM unter Geräte öffnen und unter Gerät verwalten → Hypervisor zuordnen einen Host aus demselben Kundenbestand auswählen. Die Zuordnung speichern. Der Hostname erscheint unter dem VM-Namen in der Übersicht und öffnet die Details des Hypervisors. Kein konkreter Hypervisor entfernt die gespeicherte Zuordnung.
Bei einer VM mit dem gemeldeten Hersteller Hetzner erscheint ohne verfügbaren konkreten Host Hetzner Cloud · Platzhalter. Die Anzeige steht für den Anbieter. Die Auswahl eines echten Hypervisors hat Vorrang.
Kunden eines bestehenden Geräts wechseln
- In Geräte den Hostnamen öffnen und Gerät verwalten → Kunden wechseln wählen. Der Agent benötigt eine Version mit Unterstützung für den Kundenwechsel.
- Den Zielkunden auswählen und Kundenwechsel vormerken. Hierfür braucht die angemeldete Person Geräteverwaltungsrechte beim bisherigen Kunden sowie Inventar- und Aufnahmerechte beim Zielkunden. Offene Aufträge und Genehmigungen vor dem Wechsel abschließen.
- Sobald der Agent über seine bestehende Verbindung die neue Kopplung übernommen und Inventar gemeldet hat, zeigt die WebUI den Hostnamen beim Zielkunden. Den Wechsel bestätigen und Kundenwechsel abschließen wählen. Bei einem Offline-Gerät bleibt der Wechsel bis zum nächsten verfügbaren Kontakt vorgemerkt. Die Vormerkung kann vor der Zertifikatsausstellung abgebrochen werden.
Der gesamte Ablauf findet in der WebUI statt. Bisheriges Inventar und gespeicherte Aufträge stehen beim bisherigen Kunden in der Historie. Beim Zielkunden beginnen die Meldungen mit der neuen Kopplung. Gerätegebundene Administratorrechte sind an die jeweilige Kopplung gebunden und erfordern eine eigene Freigabe und Bindung.
Alte Gerätekopplung endgültig löschen
Archivieren und Zurückholen steuern die Sichtbarkeit. Ein Widerruf sperrt die registrierte Identität.
Das Verwalten und Löschen einer Kopplung erfordert devices:revoke im betreffenden Kunden. Das Gerät öffnen und unter Gerät verwalten widerrufen. Die widerrufene Installation steht unter Geräte → Historie. Dort Kopplung löschen wählen, Hostname, Kunde und Kopplungs-ID vergleichen und Endgültig löschen bestätigen. Noch gültige offene Genehmigungsanträge und nicht abgeschlossene Jobs dieser Installation sperren das Löschen. Das gilt auch für Jobs mit ungeklärter Wirkung (unknown). Gelöscht werden diese Installation, ihr Inventar und ihre eigenen Auftragsergebnisse. Gemeinsame signierte Mehrgerätepläne und Auditdaten bleiben nachvollziehbar.
Skript bis zum Ergebnis
- Unter Skripte Shell- oder PowerShell-Code mit einem Namen veröffentlichen. Eine Änderung ergibt eine neue Version. Name und Plattform lassen sich filtern.
- Unter Aufträge → Neuer Auftrag Geräte eines Kunden auswählen. Die Geräteauswahl lässt sich auch aus dem Bestand übernehmen. Eine feste Bibliotheksversion oder Einmaliges Skript wählen. Ausführungskonto, Startfrist, Laufzeit und Ausgabelimit prüfen.
- In der Zusammenfassung Zur Genehmigung einreichen wählen. Unter Genehmigungen prüft eine berechtigte Person die gebundenen Geräte, Skriptbytes, Rechte und Fristen und entscheidet ausdrücklich. Die Ansicht zeigt offene Anträge und frühere Entscheidungen samt Person und Zeitpunkt.
- Unter Aufträge nach Anlass, Gerät, Status oder Datum filtern. Im Auftrag stehen der gebundene Skriptinhalt und je Ausführung Status, Exitcode und Ausgabe. Bei mehreren Geräten führt Ergebnis anzeigen zur betreffenden Ausführung. Vom Gerätedetail führt Ergebnis öffnen zum selben Job.
Ein Neustart verwendet die passende Bibliotheksversion mit Administratorrechten. Der Exitcode des Skripts belegt die Annahme des Neustartbefehls durch das Betriebssystem. Einen tatsächlich erfolgten Neustart anhand des geänderten Bootbezugs, eines frischen authentisierten Kontakts derselben Installation und eines erfolgreichen Folgeauftrags prüfen.
Unter Verwaltung → Erweitert können Berechtigte Paketrezepte, Windows-MSI-Rezepte und öffentliche Artefakte für den gewählten Kunden pflegen. Ein Import mit catalog:write hinterlegt die Katalogdaten. Neue Geräteaufträge werden unter Aufträge als Skript eingereicht.
MCP-Tokens
Unter Verwaltung → MCP-Tokens Namen, Kundenkreis, Rechte und Ablaufdatum festlegen. Ein Token kann auf ausgewählte Kunden oder ausdrücklich auf alle aktuellen und künftigen Kunden berechtigt werden. Den einmal angezeigten Tokenwert im privaten Zugangsspeicher des MCP-Clients als HTTP-Header hinterlegen.
Authorization: Bearer <MCP-Token>
Wirksam sind die erteilten Scopes innerhalb der aktuellen Kundenrechte. Der Widerruf greift bei der nächsten Prüfung auch in einer bestehenden MCP-Sitzung. Die Tokenverwaltung erfordert eine persönliche WebUI-Sitzung mit tokens:manage. Folgende Werkzeuge veröffentlicht der Server. Werkzeugdefinitionen
| Werkzeug | Funktion und Rechte im Zielkunden |
|---|---|
tenants.list |
Kunden auflisten, in denen der Token wirksames inventory:read besitzt. |
inventory.list_devices, inventory.get_device, monitoring.get_health |
Bestand, Gerätedetail und gespeicherte Statusmeldungen mit inventory:read. Die Bestandsliste unterstützt view=history. |
scripts.list, updates.list_releases |
Skriptversionen samt Inhalt bzw. veröffentlichte Agent-Releases mit operations:read lesen. |
scripts.publish |
Mit operations:plan und scripts:execute eine unveränderliche Version veröffentlichen. Für einen neuen Namen expected_version auf 0 setzen, für eine weitere Version die bisherige Versionsnummer übergeben. |
scripts.plan, operations.plan |
Eine Bibliotheksrevision bzw. ein einmaliges Skript mit operations:plan und scripts:execute an konkrete Geräte binden. Für Administratoren gilt zusätzlich das Plattformrecht. |
operations.submit |
Den Plan über plan_id und einen stabilen idempotency_key einreichen. Erfordert operations:submit, operations:read und die Ausführungsrechte. Der Zustand lautet zunächst pending_approval. |
jobs.get |
Mit operations:read über operation_id den Antrag und seine Jobs abfragen. Eine anschließende Abfrage mit genau einer job_id liefert das einzelne Ergebnis. |
jobs.cancel |
Mit jobs:cancel und Begründung einen Abbruch anfordern. Mit operations:read die Antwort und den tatsächlichen Endzustand lesen. |
logs.query |
Bereits gespeicherte Protokolle mit logs:read abfragen. Sensible Protokolle benötigen zusätzlich logs:read_sensitive. |
Administrator-Skripte anfordern
Ein Administratorauftrag braucht auf Linux root:execute, auf Windows system:execute, zusätzlich zu den Skript- und Auftragsrechten. Für ein einmaliges Administrator-Skript das Profil full_maintenance_v1 angeben. Bei Auswahl aus der Bibliothek setzt der Server das Profil passend zur gewählten Identität. Für Windows kann die PowerShell-Variante powershell_51_remote_signed an den Prozess binden. Die vollständigen MCP-Eingaben liefert tools/list.
Der installierte signierte Helper muss auf die Geräteidentität gebunden sein. Die zentrale Richtlinie liegt auf dem Server in /opt/rust-discovery/devstate/managed-scripts/policy.json. API und Gateway lesen sie über RMM_MANAGED_SCRIPT_POLICY_FILE. Für verifizierte Agent-/Helper-Paarwechsel kann release_anchors die ursprüngliche Release-ID, Geräteinstallation, Binärhashes und die kanonischen lokalen Richtlinienbytes binden. Der Server vergleicht die daraus für das signierte Folgepaket berechneten Prüfdaten mit den Geräteangaben. Mounts · Serverprüfung
Der folgende Operator prüft eine vorhandene Geräteregel. Platzhalter durch die tatsächlichen Kennungen der Installation und ihrer bestehenden Regel ersetzen.
python3 tools/dev_mcp_script_scope.py check --platform linux \
--tenant TENANT_ID --asset ASSET_ID --agent AGENT_ID --evidence ACCEPTANCE_EVIDENCE_ID
Mit enable lässt der Betreiber für diese Regel entsprechend berechtigte Tokens über den Selektor mcp:scoped zu. disable entfernt diesen Eintrag. Für Windows lautet die Plattform windows. Bereits einzeln vergebene Principal-Berechtigungen und vorhandene Skriptbeschränkungen gelten weiterhin. Der Server prüft die Rechte bei Planung, Freigabe und Start. Ein persönlicher Freigabeklick erfolgt unter Genehmigungen. Für einen direkten Freigabelink wird die plan_id verwendet, für den Ergebnislink die operation_id. Geräteregel · Abnahme auf beiden Plattformen