Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
Submit each host install credential mint once
pulse-triage[bot]98f2aef8daa1
diff --git a/docs/release-control/v6/internal/subsystems/agent-lifecycle.md b/docs/release-control/v6/internal/subsystems/agent-lifecycle.mdindex 1d3b8a3283..042f1cdc20 100644--- a/docs/release-control/v6/internal/subsystems/agent-lifecycle.md+++ b/docs/release-control/v6/internal/subsystems/agent-lifecycle.md@@ -228,6 +228,9 @@ an execution-scoped token. Toggling after a mint prepares a replacement withoutrevoking earlier tokens: a displayed token may already be installed and reporting.The new token and its command flags are admitted together; commands stay lockedwhile minting, and a failed mint restores the previous complete state. Preparing+a host install credential makes one non-retrying request, including on a 403;+the generic CSRF retry must not resubmit this credential-creation operation.+The existing authentication and CSRF gates are unchanged. Preparinga replacement does not change an installed agent's local command access or anyexisting token's scopes. Rerunning the installer on the intended host is stillrequired; explicit token revocation stays in Tokens after checking no agent stilldiff --git a/docs/release-control/v6/internal/subsystems/api-contracts.md b/docs/release-control/v6/internal/subsystems/api-contracts.mdindex 5ad0f49905..bea384891a 100644--- a/docs/release-control/v6/internal/subsystems/api-contracts.md+++ b/docs/release-control/v6/internal/subsystems/api-contracts.md@@ -5159,13 +5159,17 @@ the authoritative analysis outcome.host; absence of local usage evidence is not evidence it is unused. Mintinga replacement preserves the old credential and its scopes. Command flagsand the replacement credential become available atomically, or the complete- previous command state is restored on failure. The installer explains that+ previous command state is restored on failure. Host install mints opt out of+ the shared API client's automatic retry, including its generic 403/CSRF+ replay: a failure returns to the operator without resubmitting credential+ creation. Authentication and CSRF checks remain enabled. The installer explains thatpreparation does not reconfigure an installed agent and that deliberaterevocation belongs in Tokens only after checking no agent still uses it.`InfrastructureOperationsModel.test.tsx`,`useInfrastructureOperationsState.branchcov0722pm.test.tsx` and`InfrastructureInstallerSection.test.tsx` cover this consuming boundary;- native service recovery remains separate.+ `nodes.test.ts` pins the non-retrying host mint and browser HTTP fixtures+ verify a single refused submission. Native service recovery remains separate.24. Keep connected-infrastructure surface vocabulary canonical across theshared `/api/state` and reporting/install consumers:`frontend-modern/src/types/api.ts` must treat `truenas` as a first-classdiff --git a/frontend-modern/src/api/__tests__/nodes.test.ts b/frontend-modern/src/api/__tests__/nodes.test.tsindex 95acdb3f7a..d18c014478 100644--- a/frontend-modern/src/api/__tests__/nodes.test.ts+++ b/frontend-modern/src/api/__tests__/nodes.test.ts@@ -30,6 +30,34 @@ describe('NodesAPI', () => {vi.clearAllMocks();});+ describe('createHostAgentInstallToken', () => {+ it.each([false, true])(+ 'submits one non-retrying host mint with command access %s',+ async (enableCommands) => {+ const record = {+ id: 'install-1',+ name: 'Host install',+ prefix: 'synthetic',+ suffix: 'only',+ createdAt: '2026-11-02',+ };+ vi.mocked(apiFetchJSON).mockResolvedValueOnce({ token: 'synthetic-install-token', record });++ const result = await NodesAPI.createHostAgentInstallToken({+ enableCommands,+ name: 'Host install',+ });++ expect(apiFetchJSON).toHaveBeenCalledExactlyOnceWith('/api/agent-install-command', {+ method: 'POST',+ retry: false,+ body: JSON.stringify({ type: 'host', enableCommands, name: 'Host install' }),+ });+ expect(result).toEqual({ token: 'synthetic-install-token', record });+ },+ );+ });+describe('getNodes', () => {it('fetches all nodes', async () => {const mockNodes: NodeConfig[] = [{ id: 'node1', name: 'Node 1' } as NodeConfig];diff --git a/frontend-modern/src/api/nodes.ts b/frontend-modern/src/api/nodes.tsindex dc59a4c3f9..be8b047cb6 100644--- a/frontend-modern/src/api/nodes.ts+++ b/frontend-modern/src/api/nodes.ts@@ -312,6 +312,9 @@ export class NodesAPI {'/api/agent-install-command',{method: 'POST',+ // Minting creates a credential. A refusal must return to the operator,+ // not pass through the shared client's automatic 403/CSRF replay.+ retry: false,body: JSON.stringify({type: 'host',enableCommands: params.enableCommands,diff --git a/frontend-modern/src/components/Settings/__tests__/InfrastructureOperationsModel.test.tsx b/frontend-modern/src/components/Settings/__tests__/InfrastructureOperationsModel.test.tsxindex cf6dba8d98..835d8f0e3f 100644--- a/frontend-modern/src/components/Settings/__tests__/InfrastructureOperationsModel.test.tsx+++ b/frontend-modern/src/components/Settings/__tests__/InfrastructureOperationsModel.test.tsx@@ -457,8 +457,12 @@ describe('infrastructure operations model', () => {expect(useInfrastructureInstallStateSource).toContain('setCurrentToken(supersededToken);');expect(useInfrastructureInstallStateSource).not.toContain('SecurityAPI.deleteToken');expect(infrastructureInstallerSectionSource).toContain('disabled={state.isGeneratingToken()}');- expect(infrastructureInstallerSectionSource).toContain('does not reconfigure an installed');- expect(infrastructureInstallerSectionSource).toContain('Earlier tokens remain valid.');+ expect(infrastructureInstallerSectionSource.replace(/\s+/g, ' ')).toContain(+ 'does not reconfigure an installed agent',+ );+ expect(infrastructureInstallerSectionSource.replace(/\s+/g, ' ')).toContain(+ 'Earlier tokens remain valid.',+ );});it('keeps infrastructure install and operations surfaces free of retired commercial telemetry wrappers', () => {