12 KiB
Öffentlicher Zugang ohne OAuth
Die WebUI ist unter https://discovery.ease-technologies.de:8443/ erreichbar. Der MCP-Endpunkt lautet https://discovery.ease-technologies.de:8443/mcp. Beide verwenden die öffentliche TLS-Zertifikatskette des bestehenden HTTPS-Ingresses. Der Gerätekanal auf Port 443 verwendet weiterhin seine eigene Geräte-PKI.
Neustart und Administratorausführung
Unter Aufträge → Neuer Auftrag das Gerät wählen und Neustartskript auswählen verwenden. Bei gemischten Plattformen pro Betriebssystem einen Auftrag anlegen. Die Vorschau zeigt den vollständigen Inhalt und den Ausführungskontext. Nach der Entscheidung unter Genehmigungen steht die Ausgabe im Auftrag. „Neustart in einer Minute eingeplant“ bestätigt die Annahme durch das Betriebssystem. Der Wiederanlauf ist nach einem neuen Bootbezug, frischem Agentkontakt und erfolgreichem Folgeauftrag belegt.
Die letzte Meldung im Gerätedetail zeigt, ob der Client Skripte mit dem Dienstkonto und mit Administratorrechten unterstützt. Die tatsächliche Freigabe für einen Nutzer hängt zusätzlich von Kunde, Gerät und den zentralen Ausführungsrechten ab.
WebUI
Die Anmeldung benötigt den lokalen Benutzernamen, das Passwort und einen sechsstelligen TOTP-Code aus einer Authenticator-App. TOTP verwendet SHA-1, 30 Sekunden und sechs Stellen. Für die Ersteinrichtung liegt auf dem Entwicklungs-PC die private Datei credentials/public-webui-login.json mit Benutzername, Passwort, Base32-Schlüssel und otpauth_uri. Die Datei hat Modus 0600 und ist gitignoriert. Sie dient der Übernahme des Passworts in den Passwortmanager und der Einrichtung der Authenticator-App.
Der Server speichert den Passwortprüfwert als Scrypt mit zufälligem Salt und 128 MiB Arbeitsspeicher. Bereits benutzte TOTP-Zeitschritte werden atomar in PostgreSQL gesperrt. Passwortprüfungen sind parallel begrenzt. Anmeldung und Sitzung nutzen HTTPS, Loginbegrenzung, Secure-/HttpOnly-/SameSite=Strict-Cookies sowie Origin- und CSRF-Prüfungen für Änderungen. Eine Sitzung gilt eine Stunde. Das öffentliche Produktionsprofil bietet den lokalen Login. Die simulierte Entwicklungsanmeldung ist nur am internen API-Dienst verfügbar.
Die Kontokonfiguration liegt auf dem Server unter /opt/rust-discovery/devstate/public-auth/users.json, Besitzer 10001, Modus 0600, im Container schreibgeschützt. Änderung von Passwort, TOTP oder disabled erfordert den Neustart von öffentlicher API und Gateway. Ein Membership-Widerruf wirkt auch auf bestehende Sitzungen beim nächsten Zugriff. Der vorhandene SSH-Zugang ermöglicht die administrative Wiederherstellung eines verlorenen Authenticator-Zugangs.
MCP-Tokens
Administrator-Skripte anfordern
Für einen vollständigen Skriptauftrag braucht ein Token im Zielkunden operations:plan, operations:submit, operations:read und scripts:execute. Hinzu kommt für Administratoraufträge je Plattform root:execute oder system:execute. Zum Veröffentlichen einer Skriptversion benötigt das Token operations:plan und scripts:execute.
Auf einem Gerät mit installiertem, signiertem Administrator-Helper kann der Betreiber die vorhandene Geräteregel einmal für diese Tokenrechte öffnen. Der folgende Befehl zeigt den Zustand für genau die gewählte Regel. Die Werte in Großbuchstaben sind durch die Kennungen der Installation und der bestehenden Regel zu 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 wird der Eintrag mcp:scoped dieser Regel hinzugefügt, mit disable wieder entfernt. Für Windows lautet die Plattform windows. Der Server wertet die Regel bei der nächsten Rechteprüfung aus. Bereits separat an einzelne Tokens vergebene Rechte lassen sich durch Widerruf des Tokens entziehen. Ein freies Skript über operations.plan oder eine Bibliotheksversion über scripts.plan planen und über operations.submit einreichen. Die persönliche Entscheidung erfolgt in der WebUI. jobs.get liefert über die Auftragskennung den Stand und über die Jobkennung das Ausführungsergebnis.
Token ausstellen
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.
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, 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
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.
Skriptauftrag bearbeiten
- Unter Skripte → Neues Skript ein Skript veröffentlichen. Spätere Änderungen als neue Version speichern.
- Unter Aufträge → Neuer Auftrag die Geräte eines Kunden wählen. Eine Auswahl aus dem Gerätebestand lässt sich mit Auftrag erstellen übernehmen. Bibliotheksskript samt Version auswählen oder Einmaliges Skript eingeben.
- Die Zusammenfassung prüfen und Zur Genehmigung einreichen wählen. Nach einer unterbrochenen Einreichung im selben Browsertab den Auftragsdialog erneut öffnen. Er liest den gespeicherten Plan und, falls bereits vorhanden, den zugehörigen Antrag.
- Unter Genehmigungen → Offen den Antrag öffnen, Skript, Zielgeräte, Rechte und Zeitfenster prüfen und genehmigen oder ablehnen. Der Verlauf zeigt die entschiedenen und abgelaufenen Anträge.
- Unter Aufträge den Eintrag öffnen. Der Bereich Skriptinhalt zeigt den beim Einreichen gespeicherten Code samt Version oder Kennzeichnung als einmaliges Skript. Bei einem einzelnen Gerät erscheint die Ausgabe sofort. Bei mehreren Geräten öffnet Ergebnis anzeigen die Ausgabe direkt beim gewählten Gerät.
Die Standarddiagnosen stehen unter Skripte mit getrennten Versionen für Linux und Windows bereit. Die Windows-Updatesuche verwendet SYSTEM und benötigt die lokale und zentrale Freigabe für dieses Administratorskript. Auf Linux hängt die Logabfrage von den Journalrechten des Agent-Dienstkontos ab.
Unter Aufträge können Name oder Anlass, Hostname oder Geräte-ID, Status und Erstellungsdatum kombiniert werden. Das Enddatum zählt in der Ortszeit des Browsers vollständig mit. Unter Geräte → Letzte Aufträge öffnet Ergebnis öffnen die zu diesem Gerät gehörende Ausführung. Im Genehmigungsverlauf stehen Person und Zeitpunkt bei der belegten Entscheidung.
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.
Die erstmalig ausgeführten Befehle sind wiederverwendbar.
python3 tools/dev_public_access.py prepare
python3 tools/dev_public_access.py activate
python3 tools/dev_public_access.py publish
prepare erzeugt das private Bootstrapkonto und seine echte Human-Membership. activate startet die zusätzliche API intern und prüft die angebotenen Anmeldemodi. publish validiert die Nginx-Konfiguration und stellt den TLS-Ingress um. Bei einem Aktivierungsfehler wird die vorherige Ingresskonfiguration wiederhergestellt. Wiederholtes prepare verwendet die vorhandene private Kontokonfiguration. Abweichende bestehende Daten verlangen einen bewussten administrativen Abgleich.
Weitere Serverupdates verwenden tools/build.py server-arm64 --ssh --ref REVISION und tools/dev_deploy_server.py --ref REVISION. Der Deploymentrunner übernimmt die aktive Compose-Dateikette des öffentlichen Dienstes und aktiviert auch public-api. Reine WebUI-Änderungen verwenden --web-only.
Abnahme am 17. November 2026
76 WebUI-Tests, drei Browser-Bedientests der Tokenverwaltung sowie fünf Backendtests gegen isoliertes PostgreSQL bestanden. Alle 27 Migrationen wurden mit einem eingeschränkten Migrationsbenutzer geprüft. Die öffentliche HTTPS-Abnahme bestätigte 25 Fälle einschließlich Passwort/TOTP, Replay, CSRF, Tenantgrenze, beschränktem Lesetoken und Widerruf in derselben MCP-Sitzung. Alle während der Abnahme erstellten Testtokens sind widerrufen; die Abschlusskontrolle fand null aktive Tokens. Öffentlicher Nachweis
Die verwendeten Schutzmaßnahmen orientieren sich an den OWASP-Hinweisen zu Anmeldung, Passwortspeicherung und Sitzungen. Authentifizierung · Passwortspeicherung · Sitzungen
Alte Gerätekopplung endgültig löschen
Unter Geräte → Historie die betreffende Installation öffnen. Unter Gerät verwalten zuerst die Identität widerrufen und anschließend Kopplung löschen wählen. Die Bestätigung nennt Hostname, Kunde und Kopplungs-ID. Offene Genehmigungen oder laufende beziehungsweise ungeklärte Aufträge sperren das Löschen. Nach der Bestätigung entfallen die Geräteidentität, ihr Inventar und ihre eigenen Auftragsergebnisse. Eine weitere Installation desselben Geräts und deren Historie bleiben erhalten. Gemeinsame signierte Mehrgerätepläne und der Auditnachweis bleiben nachvollziehbar.