From acbff0060d4dfbd5ddef285d61d3fedac2bea784 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Wed, 18 Nov 2026 13:03:37 +0100 Subject: [PATCH] Explain client enrollment and MCP curl usage in the live WebUI --- web/src/main.tsx | 57 +++++++++++++++++++++----------- web/src/mcp-token-management.tsx | 40 ++++++++++++++++++++++ 2 files changed, 78 insertions(+), 19 deletions(-) diff --git a/web/src/main.tsx b/web/src/main.tsx index 4313039..ed8219a 100644 --- a/web/src/main.tsx +++ b/web/src/main.tsx @@ -199,25 +199,19 @@ function DeviceEnrollment({ tenantId, auth, customerName }: { tenantId: string; const [issuing, setIssuing] = useState(false); const [copied, setCopied] = useState(false); const [adminScripts, setAdminScripts] = useState(false); + const origin = enrollment?.origin; + const linuxInstaller = origin && enrollment.platforms.includes('x86_64-unknown-linux-gnu') ? `${origin}/install/linux.sh` : null; + const windowsPlatforms = ['x86_64-pc-windows-gnu', 'x86_64-pc-windows-msvc'].filter(platform => enrollment?.platforms.includes(platform)); + const windowsInstaller = origin && windowsPlatforms.length > 0 ? `${origin}/install/windows.ps1` : null; return

Gerät aufnehmen

-

Kunde {customerName} · Der Einmalcode gilt 15 Minuten.

-

Installation auf dem Zielgerät

- - - {adminScripts &&

Der lokale Installer aktiviert mit --enable-admin-scripts unter Linux oder -EnableAdministratorScripts unter Windows den Skript-Helper. - {' '}Für jeden Auftrag gelten zusätzlich die Skript- und Administratorrechte des Kunden und die Genehmigung in der WebUI.

} -

Die passenden Befehle erscheinen mit dem Einmalcode. Geben Sie den Code bei der Abfrage auf dem Zielgerät ein.

+

Wählen Sie oben den Kunden für das neue Gerät. Der Einmalcode gilt für {customerName} und verfällt nach erfolgreicher Aufnahme oder nach 15 Minuten.

@@ -229,13 +223,38 @@ function DeviceEnrollment({ tenantId, auth, customerName }: { tenantId: string; }}>Einmalcode kopieren {copied &&

Einmalcode wurde kopiert.

} - {enrollment.origin && enrollment.platforms.includes('x86_64-unknown-linux-gnu') && <>

Linux, mit einem Administratorkonto ausführen

{`curl --fail --show-error --silent '${enrollment.origin}/install/linux.sh' -o linux.sh && sudo sh linux.sh '${enrollment.origin}'${adminScripts ? ' --enable-admin-scripts' : ''}`}
} - {enrollment.origin && ['x86_64-pc-windows-gnu','x86_64-pc-windows-msvc'].filter(p => enrollment.platforms.includes(p)).map(platform => -

Windows {platform.endsWith('-gnu') ? 'x64 (GNU)' : 'x64 (MSVC)'}, in einer administrativen Windows PowerShell ausführen

-
{`Invoke-WebRequest -UseBasicParsing '${enrollment.origin}/install/windows.ps1' -OutFile .\\windows.ps1
-.\\windows.ps1 -BootstrapBase '${enrollment.origin}' -Platform '${platform}'${adminScripts ? ' -EnableAdministratorScripts' : ''}`}
)} } - +
+

Installation auf dem neuen Gerät

+
    +
  1. Öffnen Sie auf dem neuen Linux-Gerät ein Terminal mit sudo-Rechten oder auf dem neuen Windows-Gerät Windows PowerShell 5.1 (64 Bit) als Administrator.
  2. +
  3. Führen Sie den passenden Befehlsblock unten aus. Er lädt das Installationsskript per HTTPS vom Server und startet es.
  4. +
  5. Fügen Sie den oben angezeigten Einmalcode ein, sobald das Skript nach Einmalcode (Linux) oder One-time enrollment token (Windows) fragt. Bestätigen Sie mit Enter. Eine vorherige Passwortabfrage von sudo gehört zur Anmeldung mit Administratorrechten.
  6. +
  7. Prüfen Sie nach der Installation, ob das neue Gerät unter Geräte beim gewählten Kunden erscheint.
  8. +
+ + {adminScripts &&

Der lokale Installer aktiviert mit --enable-admin-scripts unter Linux oder -EnableAdministratorScripts unter Windows den Skript-Helper. + {' '}Für jeden Auftrag gelten zusätzlich die Skript- und Administratorrechte des Kunden und die Genehmigung in der WebUI.

} + {!enrollment &&

Die Downloadlinks und Befehle erscheinen hier, sobald ein Einmalcode angezeigt wird.

} + {enrollment && !origin &&

Für die Geräteaufnahme ist keine HTTPS-Downloadadresse konfiguriert.

} + {origin && !linuxInstaller && !windowsInstaller &&

Für diesen Kunden ist derzeit kein Linux- oder Windows-Installer verfügbar.

} + {linuxInstaller && <> +

Linux (x86-64)

+

Installationsskript linux.sh

+
{`curl --fail --show-error --silent '${linuxInstaller}' -o linux.sh && sudo sh linux.sh '${origin}'${adminScripts ? ' --enable-admin-scripts' : ''}`}
+ } + {windowsInstaller && <> +

Windows (x64)

+

Installationsskript windows.ps1{windowsPlatforms.length > 1 && '. Führen Sie einen der beiden Befehlsblöcke aus.'}

+ {windowsPlatforms.map(platform =>
+ {windowsPlatforms.length > 1 &&

{platform.endsWith('-gnu') ? 'GNU' : 'MSVC'}

} +
{`Invoke-WebRequest -UseBasicParsing '${windowsInstaller}' -OutFile .\\windows.ps1
+.\\windows.ps1 -BootstrapBase '${origin}' -Platform '${platform}'${adminScripts ? ' -EnableAdministratorScripts' : ''}`}
+
)} + } +
; } diff --git a/web/src/mcp-token-management.tsx b/web/src/mcp-token-management.tsx index 8b832d1..cb50f81 100644 --- a/web/src/mcp-token-management.tsx +++ b/web/src/mcp-token-management.tsx @@ -94,6 +94,45 @@ function requestFailure(error: unknown, fallback: string): string { return fallback; } +function McpCurlHelp() { + const endpoint = new URL('/mcp', window.location.origin).href; + return
+ MCP mit curl verwenden +

Verwenden Sie den erstellten Token bei jeder Anfrage an {endpoint} im HTTP-Header Authorization: Bearer <MCP-Token>.

+

Führen Sie das Beispiel in Bash aus und fügen Sie den Token bei der verdeckten Eingabe ein. Das Beispiel startet eine Sitzung und listet die MCP-Werkzeuge auf.

+
{String.raw`(
+  set -o pipefail
+  read -rsp 'MCP-Token: ' mcp_token || exit 1
+  printf '\n'
+
+  mcp() {
+    curl --fail --silent --show-error '${endpoint}' \
+      --header @- \
+      --header 'Content-Type: application/json' \
+      --header 'Accept: application/json, text/event-stream' \
+      --header 'MCP-Protocol-Version: 2025-11-25' \
+      "$@" <<< "Authorization: Bearer $mcp_token"
+  }
+
+  session_id=$(mcp --dump-header - --output /dev/null --data '{
+    "jsonrpc":"2.0","id":1,"method":"initialize","params":{
+      "protocolVersion":"2025-11-25","capabilities":{},
+      "clientInfo":{"name":"curl","version":"1.0"}
+    }
+  }' | awk 'tolower($1) == "mcp-session-id:" { sub(/\r$/, "", $2); print $2 }') || exit 1
+  if [ -z "$session_id" ]; then
+    printf '%s\n' 'Der Server hat keine MCP-Sitzungs-ID geliefert.' >&2
+    exit 1
+  fi
+
+  mcp --header "Mcp-Session-Id: $session_id" \
+    --data '{"jsonrpc":"2.0","method":"notifications/initialized"}' || exit 1
+  mcp --header "Mcp-Session-Id: $session_id" \
+    --data '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
+)`}
+
; +} + export function McpTokenManagement({ auth, tenantId }: { auth: Session; tenantId: string }) { if (!canManageMcpTokens(auth, tenantId)) return null; // Reset even an in-flight creation when the actual session, tenant or rights change. @@ -237,6 +276,7 @@ function TokenManagement({ auth, tenantId }: { auth: Session; tenantId: string } {listing.allowed_scopes.length === 0 &&

Ihre Mitgliedschaft bietet keine Rechte für ein MCP-Token.

} } +

Ausgestellte Tokens