Verwaltung (Admin-UI)
Zuletzt geändert: 18.07.2026 15:19

Admin-Oberfläche #

Für die Verwaltung der API-Clients gibt es ein lokales WebView2-Fenster im Look and Feel der übrigen EULANDA-Plugins (EulandaXtrack/EulandaXcel): linke Sidebar, mehrsprachig (de/en), Toast-Meldungen, Hell/Dunkel-Theme.

Show-XrestAdmin -Udl 'C:\Eulanda\Mandant.udl'

Das Fenster braucht Windows PowerShell 5.1 (powershell.exe) - die WebView2-Wrapper von EulandaXtools sind .NET-Framework. Unter pwsh 7 bricht der Aufruf mit einem klaren Hinweis ab; dort die Clients per CLI verwalten (siehe unten). Das Fenster läuft lokal mit den DB-Rechten des Benutzers und braucht keinen API-Key - die Aktionen gehen direkt auf die Datenbank.

Seiten #

  • Übersicht - Health-Kacheln: Schema- und Modul-Version, aktive/gesamte Clients, Anfragen und Fehler der letzten 24 Stunden, Zeitpunkt der letzten Anfrage.
  • API-Clients - Liste mit Status und Scopes; Neu/Bearbeiten öffnet einen Editor mit Name, Notiz, Scope-Auswahl (aus dem Katalog) und den Registry-Präfixen (Lesen/Schreiben). Bei der Neuanlage wird der API-Key einmalig angezeigt.
  • Zugriffs-Log - die letzten 200 Anfragen aus xrest.RequestLog (Zeit, Client, Methode, Pfad, Status, Dauer, Fehlercode, IP).

Theme und Sprache wechseln über die Knöpfe unten in der Sidebar; beides wirkt sofort im Fenster (kein Neustart).

Verwaltung per CLI (pwsh 7 und Automatisierung) #

Dieselben Aktionen ohne Fenster:

# Anlegen (Key wird einmalig zurückgegeben)
New-XrestApiClient -Udl $udl -ClientId 'shop' -Name 'Shop' `
    -Scope 'addresses:read', 'articles:read'

# Ändern: Scopes und Registry-Präfixe ersetzen, aktivieren/deaktivieren
Set-XrestApiClient -Udl $udl -ClientId 'shop' -Enabled:$false
Set-XrestApiClient -Udl $udl -ClientId 'shop' `
    -Scope 'addresses:read', 'articles:read', 'registry:read' `
    -RegistryReadPrefix '\VENDOR\esol\MODULES\DMS'

# Anzeigen und löschen
Get-XrestApiClient -Udl $udl | Format-Table ClientId, Enabled, Scopes
Remove-XrestApiClient -Udl $udl -ClientId 'shop'

Der API-Key ist nie auslesbar (nur als Hash gespeichert). Bei Kompromittierung den Client löschen oder deaktivieren und neu anlegen.