Admin Audit Log
Vorian Connect records every sensitive administrative action — GDPR erasure requests, role changes, rule lifecycle events, agent configuration pushes, and audited PHI access — in an immutable, tenant-scoped audit log. Each event captures the actor, action, timestamp, IP address, and structured target details, providing a HIPAA-ready audit trail and GDPR Article 30 record of processing activities.
How It Works
- The gateway writes audit rows to the
admin_audit_logtable whenever a sensitive administrative action completes — rule creates, destination updates, config pushes, PHI troubleshooting access, and more - Each row captures the actor's Zitadel user ID, the action type, a structured JSON target payload describing what changed, the originating IP address, and a server-assigned timestamp
- Audit writes are best-effort for non-critical operations (they do not block the action itself), but fail closed for destructive operations — patient erasure and directory-sync deactivation cannot proceed if the audit row cannot be written
- The dashboard audit page at
/auditdisplays the log with cursor-based keyset pagination, loading 50 events at a time and navigating forward and backward through history - Target JSON is sanitized before display — secrets, tokens, and PHI-bearing fields are never exposed in the audit UI or CSV export
What's Tracked
The audit log captures over 40 distinct action types across every administration surface:
- Patient data: GDPR erasure requests — logged before any destructive mutation with the planned scope (analyte rows and message count)
- Team management: Role changes, member removal, member disable/reactivate, and invitation creation
- Clinical rules: Rule create, update, delete, clone, and simulate — plus validation evidence exports
- Instrument sources: Source create, update, and delete — plus agent configuration pushes
- Destinations & routing: Destination and delivery route create, update, and delete — plus module routing changes
- Interface operations: Template creation and interface deployment
- Delta checks: Accept and reject actions on flagged delta-check results
- Message operations: Reprocess requests and resend requests
- Order routing: Manual routing overrides
- ML & mapping: Unmapped result map/ignore actions and identity mapping create/update/delete
- Directory sync: Sync connection creation, preview dry-runs, apply operations, and deactivation review/execute
- Validation: Validation evidence exports
- PHI access: Every PHI reveal is recorded in a dedicated
phi_decrypt_logaudit table with the operator's troubleshooting reason and an optional support-case ID. The generaladmin_audit_logstill stores only areason_providedflag — not the free-text reason — to keep patient identifiers out of the broad audit trail
Where It Fits
The audit log lives in the Administration section of the dashboard sidebar, gated by the audit:view permission. It is a read-only surface — audit rows are written by the system, never by operators. The CSV export at /api/audit/export produces a PHI-safe spreadsheet for compliance reporting, with spreadsheet formula prefixes neutralized.
Audit logs are tenant-scoped through PostgreSQL Row-Level Security (RLS) — each tenant sees only its own events. Cross-tenant audit visibility requires platform-level vorian_admin access.
Technical Details
- Storage:
admin_audit_logtable with columns for tenant ID, actor user ID, action type, JSONB target, IP address, and timestamp - PHI decrypt audit: A dedicated
phi_decrypt_logtable records each PHI reveal with the operator's reason and optional support-case ID, written by the message detail and message trace PHI-reveal paths on both successful and failed decrypt attempts - Pagination: Keyset pagination on the
idcolumn — avoids the performance degradation ofOFFSET-based pagination on large tables - Sanitization: The
sanitizeAuditTargetfunction strips sensitive fields from the target JSON before it reaches the UI or export - Permissions:
audit:viewfor dashboard access; platformvorian_adminfor cross-tenant visibility - Export: CSV download at
/api/audit/exportwith formula neutralization viacsv-export.ts