Files
rust-discovery/docs/public-access.md
T
2026-11-18 22:57:05 +01:00

78 lines
10 KiB
Markdown

# 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](https://discovery.ease-technologies.de:8443/) · [MCP-Endpunkt](https://discovery.ease-technologies.de:8443/mcp)
## 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](https://discovery.ease-technologies.de:8443/install/linux.sh) · [Windows-Installer](https://discovery.ease-technologies.de:8443/install/windows.ps1)
### 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
1. 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.
2. Den Zielkunden auswählen und **Kundenwechsel starten**. 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.
3. Mit der ersten gültigen Inventarmeldung der neuen Kopplung wechselt der Eintrag automatisch in den Bestand des Zielkunden. 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
1. Unter **Skripte** Shell- oder PowerShell-Code mit einem Namen veröffentlichen. Eine Änderung ergibt eine neue Version. Name und Plattform lassen sich filtern.
2. 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.
3. 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.
4. 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.
```http
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](../crates/server/src/mcp.rs)
| 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](../deploy/server.managed-scripts.compose.yaml) · [Serverprüfung](../crates/server/src/managed_scripts.rs)
Der folgende Operator prüft eine vorhandene Geräteregel. Platzhalter durch die tatsächlichen Kennungen der Installation und ihrer bestehenden Regel ersetzen.
```sh
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](../tools/dev_mcp_script_scope.py) · [Abnahme auf beiden Plattformen](mvp-completion-plan.md)