Global Audit & Compliance #
Every administrative attempt—successful, denied, or failed—is persisted to a tamper-evident, hash-chained audit log (AuditLog).
Fail-Closed Audit Invariant #
- If the persistent audit sink is unavailable,
control-backendreturns503 Service Unavailable(ErrPlatformAuditUnavailable) without executing the requested mutation. - Audit records never include raw passwords, tokens, recovery codes, or email content (
ADR-0025).
Audit Endpoints & Views #
- Platform Audit Summary (
GET /v1/platform/audit): - Accessible tosuper_adminandauditorroles (limit1–100,offsetpagination). - Returns allowlisted summary records (sequence,at,actoraspa_...ID,operation,target,outcome) without exposing internal tenant IDs or raw hash-chain secrets. - Hash-Chain Verification (
GET/POST /v1/audit/verify): - Verifies continuous cryptographic linking across audit sequence entries. - Daily Audit Anchoring (
POST /v1/audit/anchor): - Seals a daily cryptographic anchor (day,count,headSHA-256 digest) to the configuredAnchorStorefor external tamper detection.
Audited Platform Operations #
- Identity & Access:
platform_bootstrap,platform_passkey_enroll,platform_user_invite,platform_role_grant,platform_role_revoke,platform_session_revoke,platform_recovery_code_setup,platform_recovery_code_consume - Operations & Recovery:
platform_service_status_read,platform_service_logs_read,platform_service_restart,platform_recovery_backup,platform_recovery_restore,platform_recovery_verify - Changes & Alerts:
platform_changes_maintenance,platform_changes_releases,platform_changes_rollback,platform_alert_acknowledge,platform_alert_snooze,platform_alert_resolve
NOTE
The auditor role has strict read-only permissions across /v1/platform/audit and /v1/platform/users, enabling independent compliance reviews without operational privileges.