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-backend returns 503 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 #

  1. Platform Audit Summary (GET /v1/platform/audit): - Accessible to super_admin and auditor roles (limit 1–100, offset pagination). - Returns allowlisted summary records (sequence, at, actor as pa_... ID, operation, target, outcome) without exposing internal tenant IDs or raw hash-chain secrets.
  2. Hash-Chain Verification (GET / POST /v1/audit/verify): - Verifies continuous cryptographic linking across audit sequence entries.
  3. Daily Audit Anchoring (POST /v1/audit/anchor): - Seals a daily cryptographic anchor (day, count, head SHA-256 digest) to the configured AnchorStore for 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.