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 —
resourceTypeand, 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
RbacChangeTypevalues
Things you can do
| Task | How | Permission |
|---|---|---|
| Open the audit log | /rbac/analytics/audit (or View full audit log from the Dashboard) | canViewAuditLog |
| Filter the active tab | Edit the filter inputs and reload | canViewAuditLog |
| Paginate | Previous / Next in the footer | canViewAuditLog |
| Export a window of audit data | Use Analytics → Reports Export | canViewAnalytics |
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 /
hasLoadedindependently. 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.