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
Explain missing RBAC controls without widening access
pulse-triage[bot]75c336c39bc6
diff --git a/docs/RBAC.md b/docs/RBAC.mdindex b5e33e27fd..4f95ccdbd7 100644--- a/docs/RBAC.md+++ b/docs/RBAC.md@@ -37,11 +37,38 @@ user merely because no local administrator is configured.## Quick Start-1. Activate a Pro, grandfathered Pro+, Cloud, MSP, or Enterprise/custom license in **Settings → Plans & Billing**.+1. Confirm a Pro, grandfathered Pro+, Cloud, MSP, or Enterprise/custom license is active in **Settings → Plans & Billing**.2. Go to **Settings → Security → Roles**.3. Create roles with the permissions you need.4. Assign roles to users.+An active licence is not an administrator grant. For self-hosted Pulse, the+public Community runtime also does not gain Pro-only hooks when a licence is+activated. Check **Settings → Plans & Billing** for both the licence and runtime+status before changing access. If it shows **Pro runtime missing**, follow its+**Open Pulse Pro downloads** action and the [plans guide](PULSE_PRO.md); do not+buy a second licence or reset the data directory to clear this gate.++Keep an independent administrator recovery path while changing roles. If OIDC+group mappings are configured, the next sign-in replaces manually assigned+roles with the mapped set. Review [automatic role assignment](#automatic-role-assignment-via-oidc)+before relying on a manual assignment for continued access.++### If Roles or Users is missing or unavailable++- **Controls missing:** Settings navigation checks the runtime's `rbac`+ capability and this session's permission to administer users. A missing menu+ entry alone does not tell you which check failed. Check the licence/runtime+ status above and use an account already authorised for user administration.+- **Roles are unavailable for this session** or **User access is unavailable+ for this session:** the panel cannot use this session's access. Have an+ authorised administrator review the intended assignment; do not remove proxy+ role gating or widen an agent's token to bypass a denial.+- **Failed to load roles** or **Failed to load user assignments:** a failed+ read is not proof that no roles or users exist. Use the panel's **Retry** for+ that read when access is available. Do not create or delete access records to+ test it, and keep tokens, cookies and full API responses out of reports.+---## Managing Rolesdiff --git a/frontend-modern/public/docs/RBAC.md b/frontend-modern/public/docs/RBAC.mdindex b5e33e27fd..4f95ccdbd7 100644--- a/frontend-modern/public/docs/RBAC.md+++ b/frontend-modern/public/docs/RBAC.md@@ -37,11 +37,38 @@ user merely because no local administrator is configured.## Quick Start-1. Activate a Pro, grandfathered Pro+, Cloud, MSP, or Enterprise/custom license in **Settings → Plans & Billing**.+1. Confirm a Pro, grandfathered Pro+, Cloud, MSP, or Enterprise/custom license is active in **Settings → Plans & Billing**.2. Go to **Settings → Security → Roles**.3. Create roles with the permissions you need.4. Assign roles to users.+An active licence is not an administrator grant. For self-hosted Pulse, the+public Community runtime also does not gain Pro-only hooks when a licence is+activated. Check **Settings → Plans & Billing** for both the licence and runtime+status before changing access. If it shows **Pro runtime missing**, follow its+**Open Pulse Pro downloads** action and the [plans guide](PULSE_PRO.md); do not+buy a second licence or reset the data directory to clear this gate.++Keep an independent administrator recovery path while changing roles. If OIDC+group mappings are configured, the next sign-in replaces manually assigned+roles with the mapped set. Review [automatic role assignment](#automatic-role-assignment-via-oidc)+before relying on a manual assignment for continued access.++### If Roles or Users is missing or unavailable++- **Controls missing:** Settings navigation checks the runtime's `rbac`+ capability and this session's permission to administer users. A missing menu+ entry alone does not tell you which check failed. Check the licence/runtime+ status above and use an account already authorised for user administration.+- **Roles are unavailable for this session** or **User access is unavailable+ for this session:** the panel cannot use this session's access. Have an+ authorised administrator review the intended assignment; do not remove proxy+ role gating or widen an agent's token to bypass a denial.+- **Failed to load roles** or **Failed to load user assignments:** a failed+ read is not proof that no roles or users exist. Use the panel's **Retry** for+ that read when access is available. Do not create or delete access records to+ test it, and keep tokens, cookies and full API responses out of reports.+---## Managing Rolesdiff --git a/scripts/tests/test_admin_docs.py b/scripts/tests/test_admin_docs.pyindex 8153064541..d98ea8974b 100644--- a/scripts/tests/test_admin_docs.py+++ b/scripts/tests/test_admin_docs.py@@ -118,6 +118,44 @@ class AdminDocsTest(unittest.TestCase):self.assertEqual((DOCS / f"{name}.md").read_bytes(),(ROOT / "frontend-modern/public/docs" / f"{name}.md").read_bytes())+ def test_rbac_setup_guidance_matches_navigation_and_failure_states(self):+ guide = (DOCS / "RBAC.md").read_text()+ readable = " ".join(guide.replace("**", "").split())+ frontend = ROOT / "frontend-modern/src"+ navigation = (frontend / "components/Settings/settingsNavCatalog.ts").read_text()+ for panel in ("roles", "users"):+ with self.subTest(panel=panel):+ entry = navigation.split(f"id: 'security-{panel}'", 1)[1].split("},", 1)[0]+ self.assertIn("features: ['rbac']", entry)+ self.assertIn("hideWhenUnavailable: true", entry)+ self.assertIn(f"requiredCapability: '{panel}'", entry)+ for label, source in (+ ("Pro runtime missing", "utils/licensePresentation.ts"),+ ("Open Pulse Pro downloads", "utils/licensePresentation.ts"),+ ("Roles are unavailable for this session", "components/Settings/RolesPanel.tsx"),+ ("User access is unavailable for this session", "components/Settings/UserAssignmentsPanel.tsx"),+ ("Failed to load roles", "utils/rbacPresentation.ts"),+ ("Failed to load user assignments", "utils/rbacPresentation.ts"),+ ):+ with self.subTest(label=label):+ self.assertIn(label, readable)+ self.assertIn(label, " ".join((frontend / source).read_text().split()))+ for boundary in (+ "active licence is not an administrator grant",+ "licence and runtime status",+ "do not buy a second licence or reset the data directory",+ "independent administrator recovery path",+ "next sign-in replaces manually assigned roles",+ "#automatic-role-assignment-via-oidc",+ "runtime's `rbac` capability and this session's permission",+ "missing menu entry alone does not tell you which check failed",+ "do not remove proxy role gating or widen an agent's token",+ "not proof that no roles or users exist",+ "Do not create or delete access records to test it",+ ):+ with self.subTest(boundary=boundary):+ self.assertIn(boundary, readable)+def test_all_recipes_send_exact_methods_paths_and_bodies_with_each_header(self):with recording_server() as (port, requests):for name, operations in EXPECTED.items():