Skip to main content

Audit Log — /rbac/analytics/audit

The Audit Log is the per-event view onto RBAC activity. It serves two distinct streams via a tabbed interface:

  • Permission Checks — every evaluator decision (PermissionAuditLog), with the actor, target, decision, and decision path
  • Configuration Changes — every change to roles, assignments, overrides, visibility rules, policies, etc. (RbacChangeLog)

If Analytics tells you "X% of checks were denied", this page tells you which specific checks and who changed what.

Tabs​

The header has two tabs:

Permission Checks​

Backed by permissionAuditLog(scopeId:, filter:, pagination:). Each row shows:

  • Decision — green ✓ allow or red ✗ deny chip
  • Actor — actor ID + type
  • Resource — resourceType and, when present, resourceId
  • Action — the requested action (e.g. read, update)
  • Reason / decision path — which evaluator step matched (e.g. actor-level deny, role default permission via role:Editor, OPA denied)
  • Timestamp

Filters​

  • Actor ID — exact match
  • Resource type — exact match
  • Action — exact match
  • Result — All / Allowed / Denied

Hit Apply (or change a field and Reload) to fetch the filtered page.

Configuration Changes​

Backed by rbacChangeHistory(scopeId:, filter:, pagination:). Each row shows:

  • Description — human-readable summary (e.g. "Role 'Project Manager' updated")
  • Changed by — actor ID of the operator
  • Entity type — ROLE, ASSIGNMENT, OVERRIDE, RESOURCE, VISIBILITY_RULE, POLICY, CONFIG, etc.
  • Change type — see RbacChangeType (CREATE / UPDATE / DELETE / ASSIGN / REVOKE / OVERRIDE_ADD / OVERRIDE_REMOVE / ...)
  • Timestamp

Filters​

  • Changed by — actor ID
  • Entity type — free-form
  • Change type — pick from the enumerated RbacChangeType values

Things you can do​

TaskHowPermission
Open the audit log/rbac/analytics/audit (or View full audit log from the Dashboard)canViewAuditLog
Filter the active tabEdit the filter inputs and reloadcanViewAuditLog
PaginatePrevious / Next in the footercanViewAuditLog
Export a window of audit dataUse Analytics → Reports ExportcanViewAnalytics

Permissions you need​

The page is gated by canViewAuditLog (rbac:read plus the audit-view flag in PBAC; workspace admins/owners bypass).

The audit data itself is read-only — RBAC writes entries on every check and every configuration mutation, but nobody (including admins) can edit a logged row from the UI.

Tips​

  • The Permission Checks tab is the authoritative source when you need to explain why a specific request was allowed or denied. The Activity tab on a role only tracks role-change events, not decisions.
  • Decision paths are short, machine-friendly strings. Cross-reference them with the 8-step evaluator in Overview to see which step fired.
  • The two tabs reset offset / hasLoaded independently. Switching tabs always re-fetches from offset 0.
  • Pagination is offset-based with a fixed page size of 25. Next is disabled when fewer than 25 rows came back.
  • For aggregate trends (top actions, top actors, allowed/denied ratio over time) use Analytics — this page is event-by-event.
  • Retention of audit entries is set by the operator's database retention policy, not by this module. There is no fixed UI guarantee on how far back the log goes.