Skip to main content

Dashboard — /rbac and /rbac/dashboard

The Dashboard is the landing page for RBAC. It gives you an at-a-glance picture of what is configured in your workspace and links into the rest of the module.

What you see​

Stat cards​

Four tiles summarize the current state. Each is clickable for members who have read access to the target surface:

  • Total roles — how many roles exist in this workspace, with the active count as the subtitle. Tap to open Roles.
  • Activity (Checks) — total permission-check evaluations and an N allowed, M denied subtitle. Tap to open Analytics.
  • Total resources — resources registered with RBAC in this workspace, with the number of resource types as the subtitle. Tap to open Resources.
  • Role assignments — active actor-role assignments. Tap to open the Agents listing.

Numbers come from the rbacAnalytics query plus the roles/resources queries (combined in useDashboardData). They are scoped to the current workspace.

Quick actions​

The left column shows quick-action cards. Each is rendered only if you have the matching permission:

  • Create role — opens /rbac/roles/create (requires role:create).
  • Check permissions — opens the Permission Checker (any read access).
  • Visibility rules — opens the Visibility page (read access; mutations require visibility:write).

Recent activity​

The right/main column lists the last few entries from the RBAC change log (rbacChangeHistory). Each row shows the description, the actor (changedBy), the entity type, and a relative timestamp. The footer link View full audit log drops into /rbac/analytics/audit for members with canViewAuditLog.

Note: this feed tracks RBAC configuration changes (role created, override added, assignment removed, etc.), not permission decisions. For permission decisions, use the Permission Checks tab on the Audit Log.

Things you can do​

TaskHow
Refresh statsTap Refresh in the page header
Open a stat detailTap any clickable stat card
Create a roleQuick actions → Create Role (admins)
Open the audit logView full audit log under Recent Activity

Permissions you need​

The dashboard is rendered as long as you have at least rbac:read (or module-rbac:role:read / module-rbac:permission:read as auth-level fallbacks). Workspace admins/owners bypass the check. Buttons and links are individually gated:

  • Create role quick action — requires role:create (admins).
  • Activity (Checks) stat is only clickable if you have canViewAnalytics.
  • Total resources stat is only clickable if you have canViewResources.
  • Role assignments stat is only clickable if you have canViewActors.
  • View full audit log is only rendered if you have canViewAuditLog.

If a quick action does not appear, your role does not include the corresponding permission. Ask a workspace admin to upgrade your role.

For the full list of RBAC actions and how they are evaluated, see modules/rbac/specs/06-permissions-authz.md.

Tips​

  • The numbers are computed from the rbacAnalytics aggregate — they may lag by a few seconds after a fresh change. Use Refresh to force a re-fetch.
  • The activity feed only shows RBAC events. For wider workspace activity, use the workspace activity feed.
  • Numbers are scoped to this workspace. Switching workspaces will load different numbers.
  • In the user variant (tabbed shell), the Dashboard is shown as the first tab alongside Roles and Permission Checker; the underlying page is the same.