Files
rust-discovery/docs/public-access.md
T

11 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

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

  1. Unter Skripte → Neues Skript ein Skript veröffentlichen. Spätere Änderungen als neue Version speichern.
  2. 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.
  3. 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.
  4. 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.
  5. 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 passende Wartungsrichtlinie im internen Entwicklungsprofil. Auf Linux hängt die Logabfrage von den Journalrechten des Agent-Dienstkontos ab.

Für einen Neustart unter Aufträge → Neuer Auftrag ein Gerät wählen und Gerät neu starten auswählen. Der feste Plan verwendet auf Linux root und auf Windows SYSTEM. Der Neustart benötigt den passenden Helper, die Wartungsrichtlinie und das interne Entwicklungsprofil. Einreichung und Genehmigung erfolgen über denselben Auftragsablauf. Der Erfolg wird anhand eines authentisierten Wiederkontakts mit neuer Boot-ID geprüft.

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.