Explain client enrollment and MCP curl usage in the live WebUI
Rust development slice / linux (push) Failing after 14s

This commit is contained in:
2026-11-18 13:03:37 +01:00
parent 7dccb204ec
commit acbff0060d
2 changed files with 78 additions and 19 deletions
+38 -19
View File
@@ -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 <section aria-label="Gerät aufnehmen"><h2>Gerät aufnehmen</h2>
<p>Kunde <strong>{customerName}</strong> · Der Einmalcode gilt 15 Minuten.</p>
<h3>Installation auf dem Zielgerät</h3>
<ul>
<li><strong>Linux</strong> · Installationsskript per HTTPS laden und mit Administratorrechten starten.</li>
<li><strong>Windows</strong> · Installationsskript per HTTPS laden und in einer administrativen PowerShell starten.</li>
</ul>
<label className="check"><input type="checkbox" checked={adminScripts} onChange={e => setAdminScripts(e.target.checked)}/>
Installationsbefehle für Administratorskripte anzeigen
</label>
{adminScripts && <p>Der lokale Installer aktiviert mit <code>--enable-admin-scripts</code> unter Linux oder <code>-EnableAdministratorScripts</code> unter Windows den Skript-Helper.
{' '}Für jeden Auftrag gelten zusätzlich die Skript- und Administratorrechte des Kunden und die Genehmigung in der WebUI.</p>}
<p>Die passenden Befehle erscheinen mit dem Einmalcode. Geben Sie den Code bei der Abfrage auf dem Zielgerät ein.</p>
<p>Wählen Sie oben den Kunden für das neue Gerät. Der Einmalcode gilt für <strong>{customerName}</strong> und verfällt nach erfolgreicher Aufnahme oder nach 15 Minuten.</p>
<button disabled={issuing || !allowed(auth, 'devices:enroll')} onClick={async () => {
setIssuing(true); setEnrollment(null); setEnrollmentError(null); setCopied(false);
try {
const result = record(await request(tenantPath(tenantId, '/enrollment-tokens'), { body: {}, csrf: auth.csrf_token }));
if (typeof result.token !== 'string' || !/^[a-f0-9]{64}$/.test(result.token) || typeof result.expires_at !== 'string') throw new Error('Ungültiger Einmalcode');
setEnrollment({ token: result.token, expires: result.expires_at, origin: typeof result.bootstrap_origin === 'string' ? new URL(result.bootstrap_origin).origin : null,
const bootstrap = typeof result.bootstrap_origin === 'string' ? new URL(result.bootstrap_origin) : null;
setEnrollment({ token: result.token, expires: result.expires_at, origin: bootstrap?.protocol === 'https:' ? bootstrap.origin : null,
platforms: Array.isArray(result.release_platforms) ? result.release_platforms.filter((p): p is string => typeof p === 'string') : [] });
} catch (error) { setEnrollmentError(errorText(error)); } finally { setIssuing(false); }
}}>Einmalcode erstellen</button>
@@ -229,13 +223,38 @@ function DeviceEnrollment({ tenantId, auth, customerName }: { tenantId: string;
}}>Einmalcode kopieren</button>
<button className="quiet" onClick={() => { setEnrollment(null); setCopied(false); }}>Code ausblenden</button>
{copied && <p role="status">Einmalcode wurde kopiert.</p>}
{enrollment.origin && enrollment.platforms.includes('x86_64-unknown-linux-gnu') && <><p>Linux, mit einem Administratorkonto ausführen</p><pre>{`curl --fail --show-error --silent '${enrollment.origin}/install/linux.sh' -o linux.sh && sudo sh linux.sh '${enrollment.origin}'${adminScripts ? ' --enable-admin-scripts' : ''}`}</pre></>}
{enrollment.origin && ['x86_64-pc-windows-gnu','x86_64-pc-windows-msvc'].filter(p => enrollment.platforms.includes(p)).map(platform =>
<div key={platform}><p>Windows {platform.endsWith('-gnu') ? 'x64 (GNU)' : 'x64 (MSVC)'}, in einer administrativen Windows PowerShell ausführen</p>
<pre>{`Invoke-WebRequest -UseBasicParsing '${enrollment.origin}/install/windows.ps1' -OutFile .\\windows.ps1
.\\windows.ps1 -BootstrapBase '${enrollment.origin}' -Platform '${platform}'${adminScripts ? ' -EnableAdministratorScripts' : ''}`}</pre></div>)}
</>}
<article>
<h3>Installation auf dem neuen Gerät</h3>
<ol>
<li>Öffnen Sie auf dem neuen Linux-Gerät ein Terminal mit <code>sudo</code>-Rechten oder auf dem neuen Windows-Gerät Windows PowerShell 5.1 (64 Bit) als Administrator.</li>
<li>Führen Sie den passenden Befehlsblock unten aus. Er lädt das Installationsskript per HTTPS vom Server und startet es.</li>
<li>Fügen Sie den oben angezeigten Einmalcode ein, sobald das Skript nach <strong>Einmalcode</strong> (Linux) oder <strong>One-time enrollment token</strong> (Windows) fragt. Bestätigen Sie mit Enter. Eine vorherige Passwortabfrage von <code>sudo</code> gehört zur Anmeldung mit Administratorrechten.</li>
<li>Prüfen Sie nach der Installation, ob das neue Gerät unter <a href="#geraete">Geräte</a> beim gewählten Kunden erscheint.</li>
</ol>
<label className="check"><input type="checkbox" checked={adminScripts} onChange={e => setAdminScripts(e.target.checked)}/>
Installationsbefehle für Administratorskripte anzeigen
</label>
{adminScripts && <p>Der lokale Installer aktiviert mit <code>--enable-admin-scripts</code> unter Linux oder <code>-EnableAdministratorScripts</code> unter Windows den Skript-Helper.
{' '}Für jeden Auftrag gelten zusätzlich die Skript- und Administratorrechte des Kunden und die Genehmigung in der WebUI.</p>}
{!enrollment && <p className="muted">Die Downloadlinks und Befehle erscheinen hier, sobald ein Einmalcode angezeigt wird.</p>}
{enrollment && !origin && <p role="status">Für die Geräteaufnahme ist keine HTTPS-Downloadadresse konfiguriert.</p>}
{origin && !linuxInstaller && !windowsInstaller && <p role="status">Für diesen Kunden ist derzeit kein Linux- oder Windows-Installer verfügbar.</p>}
{linuxInstaller && <>
<h4>Linux (x86-64)</h4>
<p>Installationsskript <a href={linuxInstaller} target="_blank" rel="noopener noreferrer">linux.sh</a></p>
<pre>{`curl --fail --show-error --silent '${linuxInstaller}' -o linux.sh && sudo sh linux.sh '${origin}'${adminScripts ? ' --enable-admin-scripts' : ''}`}</pre>
</>}
{windowsInstaller && <>
<h4>Windows (x64)</h4>
<p>Installationsskript <a href={windowsInstaller} target="_blank" rel="noopener noreferrer">windows.ps1</a>{windowsPlatforms.length > 1 && '. Führen Sie einen der beiden Befehlsblöcke aus.'}</p>
{windowsPlatforms.map(platform => <div key={platform}>
{windowsPlatforms.length > 1 && <p>{platform.endsWith('-gnu') ? 'GNU' : 'MSVC'}</p>}
<pre>{`Invoke-WebRequest -UseBasicParsing '${windowsInstaller}' -OutFile .\\windows.ps1
.\\windows.ps1 -BootstrapBase '${origin}' -Platform '${platform}'${adminScripts ? ' -EnableAdministratorScripts' : ''}`}</pre>
</div>)}
</>}
</article>
</section>;
}
+40
View File
@@ -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 <details>
<summary>MCP mit curl verwenden</summary>
<p>Verwenden Sie den erstellten Token bei jeder Anfrage an <code>{endpoint}</code> im HTTP-Header <code>Authorization: Bearer &lt;MCP-Token&gt;</code>.</p>
<p>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.</p>
<pre><code>{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"}'
)`}</code></pre>
</details>;
}
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 }
</fieldset>
{listing.allowed_scopes.length === 0 && <p>Ihre Mitgliedschaft bietet keine Rechte für ein MCP-Token.</p>}
</form>}
<McpCurlHelp/>
<h3>Ausgestellte Tokens</h3>
<div className="fleet-tabs">
<button type="button" aria-pressed={!history} onClick={() => {setHistory(false); setRevokeId(null);}}>Aktiv</button>