Skip to main content
Version: 1.0.0-beta

Permissions — Audit Universe

Who can do what in the Audit Universe and Library modules.

Permission Matrix​

ActionAdminCAEManagerAuditorQAViewerClient
View universe items✅✅✅✅✅✅❌
Create universe items✅✅✅✅❌❌❌
Edit universe items✅✅✅✅❌❌❌
Delete universe items✅✅❌❌❌❌❌
Archive universe items✅✅✅❌❌❌❌
Import (bulk)✅✅✅❌❌❌❌
Export✅✅✅✅✅✅❌
View risks✅✅✅✅✅✅❌
Create risks✅✅✅✅❌❌❌
Edit risks✅✅✅✅❌❌❌
Delete risks✅✅❌❌❌❌❌
View controls✅✅✅✅✅✅❌
Create controls✅✅✅✅❌❌❌
Edit controls✅✅✅✅❌❌❌
Delete controls✅✅❌❌❌❌❌
Map risk-control links✅✅✅✅❌❌❌
Use AI suggestions✅✅✅✅✅❌❌
Apply AI suggestions✅✅✅✅❌❌❌

API Permission Strings​

These are the granular permission strings used in the backend RBAC engine:

PermissionDescription
universe:readView universe items
universe:createCreate new universe items
universe:updateEdit existing universe items
universe:deleteDelete universe items
universe:importBulk import
universe:exportExport data
risk:readView risk statements
risk:createCreate risks
risk:updateEdit risks
risk:deleteDelete risks
control:readView controls
control:createCreate controls
control:updateEdit controls
control:deleteDelete controls
ai:suggestRequest AI suggestions
ai:applyApply AI suggestions to records

Data Isolation​

All audit universe data is isolated by organization through:

  1. API Layer — PermissionChecker dependency validates role and org membership
  2. Query Layer — OrgScopedQuery automatically filters by org_id
  3. Database Layer — PostgreSQL Row-Level Security (RLS) policies enforce isolation
warning

Users can never access universe items from another organization, regardless of their role. This is enforced at the database level.

Audit Trail​

Every action in the Audit Universe module generates an AuditLogEvent:

ActionEvent Logged
Create entityCREATE on AuditUniverseItem with all field values
Edit entityUPDATE on AuditUniverseItem with before/after diff
Delete entityDELETE on AuditUniverseItem with archived record
Risk create/edit/deleteCorresponding events on Risk
Control create/edit/deleteCorresponding events on Control
ImportIMPORT on AuditUniverseItem with count and results
ExportEXPORT on AuditUniverseItem with export parameters
AI suggestion requestAI_ACTION with request details and model used
AI suggestion appliedAI_ACTION with applied changes and confidence score