AuthFI · Documentation

AuthFI Audit Logs

Every sensitive operation logged with who, what, when, where. Built-in observability dashboard. CSV / JSON export on Scale and Enterprise plans.

9 categoriesBuilt-in dashboardCSV / JSON exportUp to 365-day retention

Every sensitive operation in AuthFI is logged with who did it, what they did, when, and from where.

Query audit logs

GET /manage/v1/acme/logs?action=user.created&limit=50

Filters

ParameterDescription
actionEvent type (user.created, role.assigned, etc.)
actor_idWho performed the action
target_idWhat was affected
created_afterISO date filter
created_beforeISO date filter

Log entry

{
  "id": "log-uuid",
  "tenant_id": "tenant-uuid",
  "actor_type": "user",
  "actor_id": "admin-uuid",
  "action": "user.blocked",
  "target_type": "user",
  "target_id": "user-uuid",
  "ip_address": "10.0.1.50",
  "user_agent": "Mozilla/5.0...",
  "metadata": { "reason": "brute_force", "attempts": 5 },
  "created_at": "2026-03-22T10:30:00Z"
}

Logged actions

CategoryActions
Authlogin.success, login.failed, token.issued, token.revoked, password.reset, password.changed, mfa.enrolled, mfa.verified
Usersuser.created, user.updated, user.deleted, user.blocked, user.unblocked
Rolesrole.created, role.updated, role.deleted, role.assigned, role.removed, permission.created
Groupsgroup.created, group.updated, member.added, member.removed, group.role.assigned
SSOconnection.created, connection.updated, connection.deleted, saml.login, oidc.login
Cloudcloud.credentials, cloud.console_signin, cloud.account.created, cloud.mapping.created
Accessagent.registered, policy.created, policy.updated, access.allow, access.deny
SCIMscim.user.created, scim.user.updated, scim.sync.success, scim.sync.failed
Admintenant.updated, api_key.created, api_key.revoked, plan.upgraded

Export

On Scale and Enterprise plans, export audit logs as CSV or JSON:

GET /manage/v1/acme/logs/export?format=csv&created_after=2026-03-01

Observability dashboard

The console includes a built-in observability page with:

  • Login success/failure chart (Chart.js)
  • Active users over time
  • Top failed login IPs
  • MFA adoption rate
  • SSO connection health
GET /manage/v1/acme/observability

Returns pre-aggregated metrics for dashboard rendering.

Retention

PlanRetention
Build7 days
Ship30 days
Scale90 days + export
Enterprise365 days + export