From f6e658ce35a269d668fb7318933785dc4c263013 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Tue, 17 Nov 2026 23:52:03 +0100 Subject: [PATCH] Make execution controls and maintenance workflows easier to use --- docs/mvp-completion-plan.md | 8 +++ tests/browser/approval.spec.ts | 2 +- tests/browser/management-read.spec.ts | 8 +-- tests/browser/mcp-token-management.spec.ts | 7 ++ tests/browser/mvp-actions.spec.ts | 3 +- tests/browser/order-composer.spec.ts | 55 ++++++++++++++++ tests/browser/pending.spec.ts | 2 +- web/src/devices.tsx | 2 +- web/src/main.tsx | 77 +++++++++++++++++----- web/src/management.tsx | 41 ++++++++++-- web/src/mcp-token-management.tsx | 29 ++++++-- web/src/order-composer.tsx | 25 ++++++- web/src/style.css | 2 +- 13 files changed, 221 insertions(+), 40 deletions(-) diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index a3fdb3c..55748e4 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -82,6 +82,14 @@ Den aktuellen Kernablauf mit den vorhandenen Build-, Deployment- und Operatorbef Der integrierte Quellstand liegt auf `codex/mvp-development-release`. Die auf dem dedizierten Server aktivierte Revision für API, Gateway und öffentliche API ist `a7f554a`, Datenbankschema 32. Linux betreibt Release `0.1.0-mvp.2`, Windows GNU `0.1.6`. Ältere, aufgabenfremde Arbeiten liegen weiterhin gesondert im Arbeitsbaum. +### WebUI-Review · Ausführungsstopp und Wartung + +1. Den Mandantenstatus unter „Rechte & Ausführungsstopp“ direkt vom Server lesen und nach einer Änderung neu laden. Die Seite zeigt die passende Aktion für den gelesenen Zustand. +2. Neustarts unter „Neuer Auftrag“ vorbereiten. Der Assistent prüft auf genau ein Ziel, passende Berechtigung und die Gerätefähigkeiten. Der gespeicherte Plan durchläuft die reguläre Einreichung und Genehmigung. Den alten JSON-Planer unter „Verwaltung → Erweitert“ für die übrigen Wartungsfunktionen erreichbar halten. +3. Entwicklungsabnahmen im Gerätedetail nur im simulierten Testprofil zeigen. Geräteinformationen, Historie und gespeicherte Ergebnisse gehören zur öffentlichen WebUI. +4. Geräteaufnahme, Agent-Releaseübersicht und MCP-Tokens vereinfachen. Der Paketkatalog zeigt verständliche Leerzustände unter „Erweitert“. +5. Als Nächstes Auftragsfilter über die gesamte Liste, Namen und Ergebnislinks im Gerätedetail sowie Entscheider und Entscheidungszeit im Genehmigungsverlauf ergänzen. Skriptbibliothek und Kundenkontext danach überarbeiten. + ### Wiederanlauf nach frühem Abbruch — nativ abgenommen Der Controller wurde nach registriertem Helperkontakt vor der zentralen Freigabe mit Exitcode 85 beendet. Ein unabhängiger erneuter Aufruf stellte den normalen Geräteabgleich wieder her. Geräteidentität, Archivnachweise und Release blieben gebunden, die Probe erzeugte keine Aufträge. [Abnahme vom 17. November](evidence/windows-update-early-abort-20261117.json) diff --git a/tests/browser/approval.spec.ts b/tests/browser/approval.spec.ts index b215d5d..100e660 100644 --- a/tests/browser/approval.spec.ts +++ b/tests/browser/approval.spec.ts @@ -21,7 +21,7 @@ test('dev/test browser simulation: login → fixed plan → pending → explicit await page.getByRole('checkbox', { name: `Ziel ${asset}`, exact: true }).check(); await page.getByRole('link', { name: 'Aufträge', exact: true }).click(); await page.getByRole('link', { name: 'Neuer Auftrag', exact: true }).click(); - await page.getByRole('button', { name: 'Weiter zum Skript' }).click(); + await page.getByRole('button', { name: /Weiter (zum Skript|zur Aktion)/ }).click(); await page.getByRole('radio', { name: 'Einmaliges Skript' }).check(); await page.getByLabel('Skriptinhalt', { exact: true }).fill("printf '%s\\n' 'Hello World'\n"); await page.getByText('Zeitfenster und Ausführungsoptionen', { exact: true }).click(); diff --git a/tests/browser/management-read.spec.ts b/tests/browser/management-read.spec.ts index b9cc3c7..82c507c 100644 --- a/tests/browser/management-read.spec.ts +++ b/tests/browser/management-read.spec.ts @@ -8,15 +8,13 @@ test('real dev browser membership/catalog read and administrative controls stay const catalog = page.waitForResponse(r => new URL(r.url()).pathname.endsWith('/package-recipes')); await test.step('management:login-banner', async () => { await login(page); await expect(page.getByRole('status')).toContainText('SIMULIERT'); }); await page.getByRole('link', {name:'Verwaltung',exact:true}).click(); - await page.getByRole('link', {name:'Paketkataloge',exact:true}).click(); + await page.getByRole('link', {name:'Erweitert',exact:true}).click(); await test.step('management:catalog-response', async () => { expect((await catalog).status()).toBe(200); }); await test.step('management:catalog-heading', async () => { await expect(page.getByRole('heading', { name: 'Unveränderlicher Paketkatalog und Artefakte' })).toBeVisible(); }); await page.getByRole('link', {name:'Rechte & Ausführungsstopp',exact:true}).click(); await test.step('management:membership-heading', async () => { await expect(page.getByRole('heading', { name: 'Mitgliedschaft und Ausführungsstopp' })).toBeVisible(); }); - await test.step('management:unknown-stop', async () => { await expect(page.getByText('unknown — kein lesender Stopstatus-Endpunkt angekündigt', { exact: false })).toBeVisible(); }); - await page.getByRole('link', {name:'Aufträge',exact:true}).click(); - await page.getByRole('link', { name: 'Neuer Auftrag', exact: true }).click(); - await page.getByText('Weitere Wartungsaktionen', { exact: true }).click(); + await test.step('management:stop-status', async () => { await expect(page.getByRole('status', { name: 'Ausführungsstatus' })).toHaveText(/Neue Starts sind (freigegeben|gestoppt)/); }); + await page.getByRole('link', {name:'Erweitert',exact:true}).click(); await page.getByRole('link', { name: 'Wartungsauftrag planen', exact: true }).click(); await test.step('management:action-option', async () => { await expect(page.getByLabel('Aktion', { exact: true }).locator('option[value="apt_native_acceptance"]')).toHaveCount(1); }); await test.step('management:select-native', async () => { await page.getByLabel('Aktion', { exact: true }).selectOption('apt_native_acceptance'); }); diff --git a/tests/browser/mcp-token-management.spec.ts b/tests/browser/mcp-token-management.spec.ts index 238fca6..b3d591d 100644 --- a/tests/browser/mcp-token-management.spec.ts +++ b/tests/browser/mcp-token-management.spec.ts @@ -55,6 +55,7 @@ test('creates with selected rights, displays once, copies, revokes and keeps sec } }); await mount(page); + await page.getByRole('button', { name: 'Neues Token', exact: true }).click(); await expect(page.getByRole('checkbox', { name: /Inventar lesen/ })).toBeChecked(); await expect(page.getByRole('checkbox', { name: /Genehmigung einreichen/ })).not.toBeChecked(); await page.getByLabel('Name', { exact: true }).fill('MCP client'); @@ -74,6 +75,9 @@ test('creates with selected rights, displays once, copies, revokes and keeps sec await page.getByRole('button', { name: 'Widerruf bestätigen' }).click(); await expect(page.getByRole('status')).toContainText('widerrufen'); await expect(page.getByRole('button', { name: 'Widerrufen', exact: true })).toHaveCount(0); + await expect(page.getByText('Keine aktiven Tokens.')).toBeVisible(); + await page.getByRole('button', { name: 'Verlauf', exact: true }).click(); + await expect(page.getByRole('cell', { name: /Widerrufen am/ })).toBeVisible(); }); test('clears a displayed secret on session switch and refuses a simulated management session', async ({ page }) => { @@ -81,6 +85,7 @@ test('clears a displayed secret on session switch and refuses a simulated manage ? { tokens: [], allowed_scopes: ['inventory:read'], default_scopes: ['inventory:read'] } : { ...metadata, token: syntheticSecret } })); await mount(page); + await page.getByRole('button', { name: 'Neues Token', exact: true }).click(); await page.getByLabel('Name', { exact: true }).fill('MCP client'); await page.getByRole('button', { name: 'Token erstellen', exact: true }).click(); await expect(page.getByLabel('Einmaliger Token')).toHaveValue(syntheticSecret); @@ -100,11 +105,13 @@ test('discards a late create response after the owning session changes', async ( await route.fulfill({ json: { tokens: [], allowed_scopes: ['inventory:read'], default_scopes: ['inventory:read'] } }); }); await mount(page); + await page.getByRole('button', { name: 'Neues Token', exact: true }).click(); await page.getByLabel('Name', { exact: true }).fill('MCP client'); await page.getByRole('button', { name: 'Token erstellen', exact: true }).click(); const creation = await pending; await page.evaluate(next => (window as unknown as { renderTokenFixture: (session: unknown) => void }).renderTokenFixture(next), { ...auth, csrf_token: 'replacement-session' }); + await page.getByRole('button', { name: 'Neues Token', exact: true }).click(); await expect(page.getByLabel('Name', { exact: true })).toHaveValue(''); await creation.fulfill({ json: { ...metadata, token: syntheticSecret } }); await expect(page.getByLabel('Einmaliger Token')).toHaveCount(0); diff --git a/tests/browser/mvp-actions.spec.ts b/tests/browser/mvp-actions.spec.ts index 458df35..db4f703 100644 --- a/tests/browser/mvp-actions.spec.ts +++ b/tests/browser/mvp-actions.spec.ts @@ -38,7 +38,8 @@ test('simulated human prepares root request through UI only, without approving', await page.getByRole('checkbox', { name: `Ziel ${text(expected.asset_id)}`, exact: true }).check(); await page.getByRole('link', { name: 'Aufträge', exact: true }).click(); await page.getByRole('link', { name: 'Neuer Auftrag', exact: true }).click(); - await page.getByText('Weitere Wartungsaktionen', { exact: true }).click(); + await page.getByRole('link', { name: 'Verwaltung', exact: true }).click(); + await page.getByRole('link', { name: 'Erweitert', exact: true }).click(); await page.getByRole('link', { name: 'Wartungsauftrag planen', exact: true }).click(); await page.getByLabel('Aktion', { exact: true }).selectOption(text(request.action)); if (request.action === 'run_script') { diff --git a/tests/browser/order-composer.spec.ts b/tests/browser/order-composer.spec.ts index 33c90fc..66f432e 100644 --- a/tests/browser/order-composer.spec.ts +++ b/tests/browser/order-composer.spec.ts @@ -63,6 +63,61 @@ test.afterAll(async () => { await server?.close(); }); +test('uses the execution stop status and blocks restart planning until the device reports support', async ({ page }) => { + const api = '/api/v1/tenants/' + tenantId; + const permissions = [...auth.permissions, 'tenant:stop', 'system:execute']; + let stopped = false, ready = false; + const writes: unknown[] = []; + await page.route(origin + '/auth/config', r => r.fulfill({ json: { + dev_login_enabled: false, local_login_enabled: true, oidc_configured: false, oidc_login_url: null + } })); + await page.route(origin + '/auth/session', r => r.fulfill({ json: { ...auth, permissions, principal: { ...auth.principal, simulated: false } } })); + await page.route(origin + '/api/v1/**', r => { + const req = r.request(), pathname = new URL(req.url()).pathname; + if (pathname === '/api/v1/tenants') return r.fulfill({ json: listing(auth.tenants) }); + if (pathname === '/api/v1/approvals') return r.fulfill({ json: { ...listing([]), pending_count: 0 } }); + if (pathname === api + '/execution-stop' && req.method() === 'GET') { + return r.fulfill({ json: { tenant_id: tenantId, changes_stopped: stopped } }); + } + if (pathname === api + '/devices') return r.fulfill({ json: listing([windows]) }); + if (pathname === api + '/devices/' + windows.asset_id) return r.fulfill({ json: { + ...windows, tenant_id: tenantId, + capabilities: ready ? ['reboot', 'rmm.sync.v1', 'windows.reboot/1', 'helper.system.v1', 'system:reboot'] : [] + } }); + if (req.method() !== 'GET') writes.push(req.postDataJSON()); + return r.fulfill({ status: 409, json: { code: 'UNSUPPORTED_CAPABILITY' } }); + }); + + await page.goto(origin + '/#verwaltung/rechte'); + const status = page.getByRole('status', { name: 'Ausführungsstatus' }); + await expect(status).toHaveText('Neue Starts sind freigegeben'); + await expect(page.getByText('Mandantenausführung stoppen', { exact: true })).toBeVisible(); + stopped = true; + await page.reload(); + await expect(status).toHaveText('Neue Starts sind gestoppt'); + await expect(page.getByText('Mandantenausführung stoppen', { exact: true })).toHaveCount(0); + await expect(page.getByText('Mandantenausführung wieder zulassen', { exact: true })).toBeVisible(); + expect(writes).toHaveLength(0); + + await page.goto(origin + '/#auftraege/neu'); + await page.getByRole('checkbox', { name: /test-windows/ }).check(); + await page.getByRole('button', { name: 'Weiter zur Aktion' }).click(); + await page.getByRole('radio', { name: 'Gerät neu starten' }).check(); + await page.getByLabel('Begründung', { exact: true }).fill('Neustart prüfen'); + const plan = page.getByRole('button', { name: 'Zusammenfassung ansehen' }); + await expect(page.getByRole('alert')).toContainText('keine Neustartfähigkeit'); + await expect(plan).toBeDisabled(); + expect(writes).toHaveLength(0); + ready = true; + await expect(plan).toBeEnabled({ timeout: 8000 }); + await plan.click(); + await expect(page.getByRole('alert')).toContainText('unterstützt die ausgewählte Ausführung noch nicht'); + expect(writes).toEqual([expect.objectContaining({ + action: 'reboot', targets: { asset_ids: [windows.asset_id] }, + parameters: expect.objectContaining({ execution_identity: 'system', reconnect_timeout_seconds: 180 }) + })]); +}); + test('shows the bound script text alongside single and per-device results', async ({ page }) => { const operationId = randomUUID(); const multiOperationId = randomUUID(); diff --git a/tests/browser/pending.spec.ts b/tests/browser/pending.spec.ts index f59ff4f..2daa92a 100644 --- a/tests/browser/pending.spec.ts +++ b/tests/browser/pending.spec.ts @@ -24,7 +24,7 @@ test('real TLS UI: login, tenant, fixed preview, pending, reload, CSRF denial an await page.getByRole('checkbox', { name: `Ziel ${asset}`, exact: true }).check(); await page.getByRole('link', { name: 'Aufträge', exact: true }).click(); await page.getByRole('link', { name: 'Neuer Auftrag', exact: true }).click(); - await page.getByRole('button', { name: 'Weiter zum Skript' }).click(); + await page.getByRole('button', { name: /Weiter (zum Skript|zur Aktion)/ }).click(); await page.getByRole('radio', { name: 'Einmaliges Skript' }).check(); await page.getByLabel('Skriptinhalt', { exact: true }).fill("printf '%s\\n' 'Hello World'\n"); await page.getByText('Zeitfenster und Ausführungsoptionen', { exact: true }).click(); diff --git a/web/src/devices.tsx b/web/src/devices.tsx index d597992..f1c7111 100644 --- a/web/src/devices.tsx +++ b/web/src/devices.tsx @@ -270,7 +270,7 @@ function DeviceDetail({ )} - {scoped && + {scoped?.principal.simulated && customer === recoveryTenant && asset === recoveryAsset && allowed(scoped, 'inventory:read') && ( diff --git a/web/src/main.tsx b/web/src/main.tsx index 3ea7091..e33900e 100644 --- a/web/src/main.tsx +++ b/web/src/main.tsx @@ -9,7 +9,7 @@ import { ScriptLibrary } from './script-library'; import { McpTokenManagement } from './mcp-token-management'; import React, { useEffect, useState } from 'react'; import { createRoot } from 'react-dom/client'; -import { actions, Action, ApiError, authConfig, approvalBlockers, expectedStdout, objectId, page, Page, PlanInput, pretty, record, RecordValue, request, session, Session, stringField, tenant, tenantPath, validateInput, windowsPowerShellRemoteSignedProfile, fullMaintenanceScriptProfile } from './api'; +import { actions, Action, ApiError, authConfig, approvalBlockers, expectedStdout, objectId, page, PlanInput, pretty, record, RecordValue, request, session, Session, stringField, tenant, tenantPath, validateInput, windowsPowerShellRemoteSignedProfile, fullMaintenanceScriptProfile } from './api'; import './style.css'; import { AdminControl, Catalog, TenantControls } from './management'; import { allowed, availableActions, parseStrictJson, powerShellApprovalBlockers, powerShellPlanJobs, rootWarning, systemWarning, systemPlanJobs, validateSensitiveInput, verifyPlanIntegrity, queryLogsApprovalBlockers, queryLogsPlanJobs, windowsMsiApprovalBlockers, windowsMsiPlanJobs, verifyWindowsMsiManifest, fullMaintenanceWarning } from './safety'; @@ -115,14 +115,15 @@ export function QueryLogsPlanNotice({ plan }: { plan: RecordValue }) { return ; } catch { return ; } } -function PageStatus({ data }: { data: Page }) { return

Listenstand: {data.as_of} · Vollständigkeit: {data.completeness} · begrenzt: {String(data.truncated)}. Fehlende Einträge sind kein Löschungsnachweis.

; } const initialParameters: Record = { run_script: {}, refresh_inventory: { scope: 'linux.base' }, query_logs: { unit: '', since: '', until: '', max_lines: 1000 }, set_service_state: { unit: '', state: 'running' }, ensure_package: { provider: 'apt', recipe_version: '', package: '', version: '', architecture: 'amd64', installation_context: 'system', apt_manifest: null }, apply_updates: { provider: 'apt', packages: [], reboot_policy: 'never', apt_manifest: null }, reboot: { reason: '', dependency_group: '', reconnect_timeout_seconds: 300 }, apt_native_acceptance: { recipe_id: 'rmm-apt-fixture-install-1.0', recipe_version: '1', apt_manifest: null }, update_agent: { release_id: '' }, }; function Planner({ tenantId, auth, selected, showPlan }: { tenantId: string; auth: Session; selected: string[]; showPlan: (id: string) => void }) { + const choices = availableActions(auth, actions).filter(action => auth.principal.simulated || !['run_script', 'reboot'].includes(action)); const [scriptPlatform, setScriptPlatform] = useState('linux'), [mixedVariants, setMixedVariants] = useState('[]'); - const [action, setAction] = useState('run_script'), [parameters, setParameters] = useState('{}'), [error, setError] = useState(null), [busy, setBusy] = useState(false); + const initialAction = auth.principal.simulated ? 'run_script' : 'refresh_inventory'; + const [action, setAction] = useState(initialAction), [parameters, setParameters] = useState(pretty(initialParameters[initialAction])), [error, setError] = useState(null), [busy, setBusy] = useState(false); const [identity, setIdentity] = useState('agent_service'); return

Neuen unveränderlichen Plan vorbereiten

Nur fest ausgewählte Asset-IDs. Keine Ausführung durch Planung oder Antrag; jede Aktion einschließlich Live-Inventar benötigt Genehmigung.

{ e.preventDefault(); setBusy(true); setError(null); const f = new FormData(e.currentTarget); try { @@ -132,7 +133,7 @@ function Planner({ tenantId, auth, selected, showPlan }: { tenantId: string; aut const ids = String(f.get('artifact_ids') ?? '').split(/[\s,]+/).filter(Boolean); if (ids.length) { if (ids.length > 16 || new Set(ids).size !== ids.length || ids.some(id => !/^[0-9a-f-]{36}$/i.test(id))) throw new Error('Maximal 16 eindeutige feste Artefakt-UUIDs'); input.artifact_ids = ids; } validateInput(input); await validateSensitiveInput(input, auth); const plan = record(await request(tenantPath(tenantId, '/operation-plans'), { body: input, csrf: auth.csrf_token })); showPlan(objectId(plan, 'plan')); } catch (e) { setError(errorText(e)); } finally { setBusy(false); } }}> - + {action === 'update_agent' &&

{agentUpdateWarning} Nur parameters.release_id aus dem Katalog; keine freien Vorgänger-, Dateipfad-, Artefakt- oder Policywerte. Gesamtbudget600s, Ausgabelimit höchstens65536Bytes. Fehlende frische Gerätepreview ergibt keine Planung.

} {action === 'query_logs' &&

Windows-MVP nur Quelle windows.eventlog.application.rustdiscovery-mvp-test, Kanal Application, Provider RustDiscovery-MVP-Test, agent_service. Festes UTC-Fenster höchstens24h,1–1000Events,1024–65536Bytes,äußere Joblaufzeit10–120s; inneres kooperatives Abfragebudget höchstens5000ms. Keine freie Kanal-/XPathauswahl und keine Bookmarkfortschreibung. Linux behält seine feste Journalunit.

} {action === 'apt_native_acceptance' &&

NUR SIMULIERTE DEV/TEST-NATIVABNAHME. In Vorbereitung; Backend/Helper/Scope müssen diese eigene Aktion unterstützen. Nur rmm-apt-fixture-install-1.0 oder rmm-apt-fixture-update-1.1, Rezeptversion 1, vollständiges Schema-2-Manifest. null/Platzhalter sind nicht konfiguriert, keine Produktionsaktion, keine automatische Ausführung.

} @@ -158,7 +159,14 @@ function WindowsMsiCatalog({ tenantId, auth }: { tenantId: string; auth: Session return { ...result, items }; }, [tenantId, cursor, revision]); return

Getrennter unveränderlicher Windows-MSI-Katalog

Nur die zwei festen eigenen Machine/x64-Rezepte. Import ist Metadatenpflege mit catalog:write, keine Genehmigung, Installation oder Capabilityfreigabe. Öffentliche MSI-Artefakte werden über den bestehenden Artefaktimport gebunden. Vollständiges geprüftes Manifest für den Parametereditor kopieren.

- {list.data && <>} + {list.data && <> + {list.data.items.length ? + :

Für diesen Kunden sind keine Windows-MSI-Rezepte hinterlegt.

} + {(cursor || list.data.next_cursor) &&
+ + +
} + }
Neues festes MSI-Manifest importieren { event.preventDefault(); setBusy(true); setError(null); setReceipt(null); try { if (!allowed(auth, 'catalog:write')) throw new Error('catalog:write unbekannt/nicht erteilt'); const manifest = await verifyWindowsMsiManifest(parseStrictJson(source)); @@ -179,7 +187,27 @@ function AgentReleaseCatalog({ tenantId, auth }: { tenantId: string; auth: Sessi return { ...result, items }; }, [tenantId, cursor, revision]); return

Signierter Agent-Releasekatalog

Installierte Clients können hier veröffentlichte Versionen beim nächsten regulären Abruf beziehen. Jedes signierte Manifest bindet eine Plattform sowie die genauen Agent- und Helperdateien.

- {list.data && <>} + {!list.data && !list.error &&

Releases werden geladen …

} + {list.data && !list.error && <> + {list.data.items.length ?
+ + {list.data.items.map(item => { + const manifest = record(item.manifest); + const platform = stringField(manifest, 'platform'); + return + + + + + ; + })} +
VersionPlattformSequenzPrüfstatus
{stringField(manifest, 'version')}{platform.includes('windows') ? 'Windows' : 'Linux'}{platform}{String(manifest.release_sequence)}{item.signature_and_time_valid ? 'Signatur und Zeitfenster gültig' : 'Derzeit ungültig'}
:

Für diesen Kunden liegen noch keine Agent-Releases im Katalog.

} + {(cursor || list.data.next_cursor) &&
+ + +
} + {!!list.data.items.length && } + }
Signiertes festes Release mit Agent und Helper veröffentlichen

Der Server prüft Signatur, Größe und SHA-256 beider Dateien. Erst nach dem vollständigen Upload wird die neue Version für Geräte sichtbar.

{ event.preventDefault(); setBusy(true); setError(null); setReceipts([]); const form = new FormData(event.currentTarget); try { if (!allowed(auth, 'catalog:write')) throw new Error('catalog:write unbekannt/nicht erteilt'); @@ -204,10 +232,17 @@ function DeviceEnrollment({ tenantId, auth, customerName }: { tenantId: string; const [enrollment, setEnrollment] = useState<{ token: string; expires: string; origin: string | null; platforms: string[] } | null>(null); const [enrollmentError, setEnrollmentError] = useState(null); const [issuing, setIssuing] = useState(false); + const [copied, setCopied] = useState(false); return

Gerät aufnehmen

-

Das HTTPS-Installationsskript fragt auf dem Gerät nach dem Einmalcode. Er gilt für {customerName} und läuft nach 15 Minuten ab.

+

Kunde {customerName} · Der Einmalcode gilt 15 Minuten.

+

Installation auf dem Zielgerät

+
    +
  • Linux · Installationsskript per HTTPS laden und mit Administratorrechten starten.
  • +
  • Windows · Installationsskript per HTTPS laden und in einer administrativen PowerShell starten.
  • +
+

Die passenden Befehle erscheinen mit dem Einmalcode. Das Skript fragt den Code auf dem Zielgerät ab.

- {enrollment && <> + {enrollment && <> + + + {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}'`}
} {enrollment.origin && ['x86_64-pc-windows-msvc','x86_64-pc-windows-gnu'].filter(p => enrollment.platforms.includes(p)).map(platform =>

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

@@ -580,7 +621,7 @@ function Workspace({ auth, logout }: { auth: Session; logout: () => void }) { ['zugang', 'MCP-Tokens'], ['aufnahme', 'Geräteaufnahme'], ['releases', 'Agent-Releases'], - ['kataloge', 'Paketkataloge'], + ['kataloge', 'Erweitert'], ['rechte', 'Rechte & Ausführungsstopp'] ]; const adminTab = tabs.some(([id]) => id === route.tab) ? route.tab : 'zugang'; @@ -706,15 +747,13 @@ function Workspace({ auth, logout }: { auth: Session; logout: () => void }) { route.tab === 'neu' ? <> ← Zu den Aufträgen -
Weitere Wartungsaktionen -

Inventur, Dienstverwaltung und weitere Wartungsaufträge planen.

- Wartungsauftrag planen -
: route.tab === 'wartung' ? <> - ← Zum neuen Auftrag + ← Zur erweiterten Verwaltung

Wartungsauftrag planen

- Geräte auswählen - + {allowed(scoped, 'operations:plan') ? <> + Geräte auswählen + + :

Die Berechtigung zum Planen von Aufträgen fehlt.

} : detailRoute && detailId ? <> ← Zu den Aufträgen {detailKind === 'entwurf' ? @@ -750,6 +789,10 @@ function Workspace({ auth, logout }: { auth: Session; logout: () => void }) { {adminTab === 'releases' && } {adminTab === 'kataloge' && ( <> + {allowed(scoped, 'operations:plan') &&
+

Erweiterte Wartung

+ Wartungsauftrag planen +
} diff --git a/web/src/management.tsx b/web/src/management.tsx index 0ea9c2e..82bb10a 100644 --- a/web/src/management.tsx +++ b/web/src/management.tsx @@ -1,5 +1,6 @@ import { useEffect, useState } from 'react'; import { pretty, record, request, Session, tenantPath, page, RecordValue } from './api'; +import { ErrorBox, useResource } from './resource'; import { adminIntent, allowed, parseStrictJson, recipeInput, sha256 } from './safety'; const message = (e: unknown) => e instanceof Error ? e.message : 'Unbekannter Fehler'; @@ -21,10 +22,33 @@ export function AdminControl({ auth, path, title, permission, warning, stopped,
; } export function TenantControls({ tenantId, auth }: { tenantId: string; auth: Session }) { - const [status, setStatus] = useState('unknown — kein lesender Stopstatus-Endpunkt angekündigt'); - return

Mitgliedschaft und Ausführungsstopp

Rollen: {auth.roles?.join(', ') || 'unknown'} · Rechte: {auth.permissions?.join(', ') || 'unknown'}

Aktueller Ausführungsstopp: {typeof status === 'string' ? status : pretty(status)}

Frontendberechtigungen sind keine Sicherheitsgrenze. Aktuelle Rechte/Tenant/CSRF/Policy prüft der Server. Anmeldemodi werden über /auth/config ermittelt; die Simulationskennzeichnung stammt ausschließlich aus der Serversitzung.

- setStatus('true — zuletzt erfolgreich per UI angefordert; kein unabhängiger aktueller Lesestatus')}/> - setStatus('false — zuletzt erfolgreich per UI angefordert; kein unabhängiger aktueller Lesestatus')}/> + const path = tenantPath(tenantId, '/execution-stop'); + const canStop = allowed(auth, 'tenant:stop'); + const canRead = canStop || allowed(auth, 'operations:read'); + const status = useResource(async signal => { + if (!canRead) return null; + const response = record(await request(path, { signal })); + if (response.tenant_id !== tenantId || typeof response.changes_stopped !== 'boolean') { + throw new Error('Der Server lieferte keinen gültigen Ausführungsstatus für diesen Kunden.'); + } + return response.changes_stopped; + }, [tenantId, auth.principal.id, canRead], canRead); + const stopped = status.error ? null : status.data; + return

Mitgliedschaft und Ausführungsstopp

+ +

{stopped === true ? 'Neue Starts sind gestoppt' + : stopped === false ? 'Neue Starts sind freigegeben' + : !canRead ? 'Die Berechtigung zum Lesen des Ausführungsstatus fehlt.' + : status.error ? 'Ausführungsstatus derzeit nicht verfügbar.' : 'Ausführungsstatus wird geladen …'}

+ {canStop && stopped !== null && } +
Rolle und Berechtigungen +

Rollen: {auth.roles?.join(', ') || 'Keine Rolle gemeldet'}

+

{auth.permissions?.join(', ') || 'Keine Berechtigungen gemeldet'}

+
; } async function downloadArtifact(path: string) { @@ -41,7 +65,14 @@ export function Catalog({ tenantId, auth }: { tenantId: string; auth: Session }) useEffect(() => { const controller = new AbortController(); setList(null); setError(null); request(tenantPath(tenantId, `/package-recipes${cursor ? `?cursor=${encodeURIComponent(cursor)}` : ''}`), { signal: controller.signal }).then(v => setList(page(v))).catch(e => { if (!controller.signal.aborted) setError(message(e)); }); return () => controller.abort(); }, [tenantId, cursor, revision]); const loaded = list ? page(list) : null; return

Unveränderlicher Paketkatalog und Artefakte

Exakte Paket-/Rezeptversionen, Architektur und SHA-256. Keine freie Download-URL oder LLM-URL als Installer. Import ist keine Ausführungsgenehmigung.

- {loaded && <>} + + {loaded && (loaded.items.length + ?
Paketrezepte und Prüfdaten
{pretty(loaded.items)}
+ :

Für diesen Kunden sind keine Paketrezepte hinterlegt.

)} + {loaded && (cursor || loaded.next_cursor) &&
+ + +
}
Neue unveränderliche Rezeptversion importieren

POST package-recipes, Recht catalog:write. Bestehende Versionen werden nicht bearbeitet; Plattform wird nur dargestellt, soweit geliefert, nicht aus Architektur erfunden.

{ e.preventDefault(); setError(null); setResult(null); setBusy(true); try { if (!allowed(auth, 'catalog:write')) throw new Error('catalog:write unbekannt/nicht erteilt'); const input = recipeInput(parseStrictJson(recipe)); const expected = await sha256(new TextEncoder().encode(JSON.stringify(input))); const response = record(await request(tenantPath(tenantId, '/package-recipes'), { body: input, csrf: auth.csrf_token })); diff --git a/web/src/mcp-token-management.tsx b/web/src/mcp-token-management.tsx index 87f3f61..56aa766 100644 --- a/web/src/mcp-token-management.tsx +++ b/web/src/mcp-token-management.tsx @@ -114,6 +114,8 @@ function TokenManagement({ auth, tenantId }: { auth: Session; tenantId: string } const [notice, setNotice] = useState(''); const [reload, setReload] = useState(0); const [revokeId, setRevokeId] = useState(null); + const [history, setHistory] = useState(false); + const [editing, setEditing] = useState(false); const mounted = useRef(false); const mutation = useRef(null); @@ -153,6 +155,8 @@ function TokenManagement({ auth, tenantId }: { auth: Session; tenantId: string } const metadata = mcpToken(reply); requireContract(typeof reply.token === 'string' && reply.token.length >= 32 && reply.token.length <= 512); setSecret({ token: reply.token, tokenId: metadata.token_id, name: metadata.name }); + setEditing(false); + setHistory(false); setListing(current => current && { ...current, tokens: [metadata, ...current.tokens] }); setName(''); setAllCustomers(false); setCustomerIds([tenantId]); setSelected(listing.default_scopes); setExpires(defaultExpiry()); } catch (err) { @@ -187,9 +191,17 @@ function TokenManagement({ auth, tenantId }: { auth: Session; tenantId: string } catch { if (mounted.current) setError('Kopieren ist im Browser nicht verfügbar. Sie können den angezeigten Token markieren und kopieren.'); } } + const endpoint = typeof window === 'undefined' ? '/mcp' : window.location.origin + '/mcp'; + const now = Date.now(); + const visibleTokens = listing?.tokens.filter(token => (token.revoked_at !== null || Date.parse(token.expires_at) <= now) === history) ?? []; return

MCP-Tokens

Erstellen Sie einen Zugang für Ihren MCP-Client. Skript- und Wartungsaufträge benötigen weiterhin die Genehmigung in der WebUI.

+

{endpoint}{' '} +

{error &&

{error}

} {notice &&

{notice}

} {secret &&
@@ -200,7 +212,9 @@ function TokenManagement({ auth, tenantId }: { auth: Session; tenantId: string }
} {!listing ?

Tokenliste wird geladen …

: <> - + {!editing && !secret && listing.allowed_scopes.length > 0 && + } + {editing && !secret &&
Neues MCP-Token @@ -218,20 +232,25 @@ function TokenManagement({ auth, tenantId }: { auth: Session; tenantId: string } Ortszeit dieses Browsers. Höchstens 365 Tage Gültigkeit. +
{listing.allowed_scopes.length === 0 &&

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

} - + }

Ausgestellte Tokens

+
+ + +
- {!listing.tokens.length ?

Es wurden noch keine Tokens erstellt.

:
+ {!visibleTokens.length ?

{history ? 'Keine widerrufenen oder abgelaufenen Tokens.' : 'Keine aktiven Tokens.'}

:
- {listing.tokens.map(token => + {visibleTokens.map(token => -
Name und IDKundenzugriffRechteErstellt und zuletzt verwendetGültigkeitVerwaltung
{token.name}{token.token_id}{token.principal} {token.audience === 'all' ? 'Alle aktuellen und zukünftigen Kunden' : (token.tenant_ids ?? [tenantId]).map(id => listing.available_customers?.find(c => c.tenant_id === id)?.name ?? auth.tenants.find(c => c.tenant_id === id)?.name ?? id).join(', ')} {token.scopes.map(scope => {scopeLabels[scope]} {scope})} Zuletzt verwendet {token.revoked_at ? <>Widerrufen am : <>{Date.parse(token.expires_at) <= Date.now() ? 'Abgelaufen am ' : 'Läuft ab am '}}{token.revoked_at === null && (revokeId === token.token_id ? <> + {!history && (revokeId === token.token_id ? <>

Zugang für „{token.name}“ jetzt beenden?

diff --git a/web/src/order-composer.tsx b/web/src/order-composer.tsx index b15333a..0b8fed7 100644 --- a/web/src/order-composer.tsx +++ b/web/src/order-composer.tsx @@ -222,6 +222,20 @@ export function OrderComposer({ tenantId, auth, initialAssetIds, onSubmitted, on const revision = scripts.data?.find((r) => r.revision_id === revisionId); const heads = latestRevisions(scripts.data ?? []); const rebootIdentity = hasWindows ? 'system' : 'root'; + const rebootAsset = mode === 'reboot' && step === 2 && selected.length === 1 ? selected[0] : null; + const rebootTarget = useResource(async signal => { + if (!rebootAsset || !canPlanReboot) return null; + const device = record(await request(path('/devices/' + encodeURIComponent(rebootAsset)), { signal })); + if (device.tenant_id !== tenantId || device.asset_id !== rebootAsset || device.lifecycle !== 'current' || + devicePlatform(device) !== (hasWindows ? 'windows' : 'linux')) { + throw Error('Das Zielgerät hat sich geändert. Wählen Sie es erneut aus.'); + } + const capabilities = Array.isArray(device.capabilities) ? device.capabilities : []; + const required = hasWindows + ? ['reboot', 'rmm.sync.v1', 'windows.reboot/1', 'helper.system.v1', 'system:reboot'] + : ['reboot', 'rmm.sync.v1', 'helper.root.v1', 'root:reboot']; + return { agentId: objectId(device, 'agent'), ready: required.every(capability => capabilities.includes(capability)) }; + }, [tenantId, rebootAsset, rebootIdentity, canPlanReboot], !!rebootAsset && canPlanReboot); const issues: string[] = []; if (targets.some((d) => !d?.current)) issues.push('Ein Zielgerät fehlt im aktuellen Bestand. Entfernen Sie es aus der Auswahl.'); @@ -241,6 +255,9 @@ export function OrderComposer({ tenantId, auth, initialAssetIds, onSubmitted, on if (mode === 'reboot') { if (selected.length !== 1) issues.push('Wählen Sie ein einzelnes Gerät für den Neustart.'); if (!allowed(auth, rebootIdentity + ':execute')) issues.push('Die Berechtigung für ' + identityNames[rebootIdentity] + ' fehlt.'); + if (rebootTarget.error) issues.push(issueMessage(rebootTarget.error)); + else if (rebootAsset && !rebootTarget.data) issues.push('Die Neustartfähigkeit des Geräts wird geprüft.'); + else if (rebootTarget.data?.ready === false) issues.push('Das Zielgerät meldet derzeit keine Neustartfähigkeit für ' + identityNames[rebootIdentity] + '.'); } if ( mode === 'once' && @@ -319,7 +336,8 @@ export function OrderComposer({ tenantId, auth, initialAssetIds, onSubmitted, on if ( fixed.plan_id !== planId || fixed.tenant_id !== tenantId || fixed.principal !== auth.principal.id || fixed.reason !== bound.reason || fixed.max_parallel !== 1 || fixed.halt_after_failures !== 1 || - jobs.length !== 1 || job.asset_id !== selected[0] || job.execution_identity !== rebootIdentity || + jobs.length !== 1 || job.asset_id !== selected[0] || job.agent_id !== rebootTarget.data?.agentId || + job.execution_identity !== rebootIdentity || action.action !== 'reboot' || action.reason !== bound.reason || action.dependency_group !== input.parameters.dependency_group || action.reconnect_timeout_seconds !== input.parameters.reconnect_timeout_seconds || @@ -602,9 +620,10 @@ export function OrderComposer({ tenantId, auth, initialAssetIds, onSubmitted, on ))} - {!devices.data.items.length && ( + {!devices.data.items.length && <>

{query ? 'Kein Gerät passt zur Suche.' : 'Keine Geräte im Bestand dieses Kunden.'}

- )} + {!query && allowed(auth, 'devices:enroll') && Gerät aufnehmen} + } {(prior.length > 0 || devices.data.next) && (