Skip to main content

​
Overview

User-related audit log events track actions and access related to user profiles and settings across the Centure platform. These events provide a comprehensive record of user interactions for security and compliance purposes.

​
user.view_settings

Triggered when a user views their account settings in the Centure platform.

​
Event Details

  • Action Name: user.view_settings
  • Actor: The user viewing their settings
  • Target: The same user whose settings are being viewed

​
Event Schema

{
  action: "user.view_settings",
  actor: {
    type: "user",
    id: string,
    name: string,
    metadata: {
      first_name: string,
      last_name: string,
      email: string,
      // Optional impersonator details
      impersonator_email?: string,
      impersonator_reason?: string
    }
  },
  targets: [{
    type: "user",
    id: string,
    name: string,
    metadata: {
      first_name: string,
      last_name: string,
      email: string
    }
  }],
  context: {
    location: string, // IP address or "unknown"
    userAgent: string // Browser/device information or "unknown"
  },
  metadata: {
    source: string // User-facing page route
  }
}

​
Example Payload

{
  "action": "user.view_settings",
  "actor": {
    "type": "user",
    "id": "user_123",
    "name": "Jane Doe",
    "metadata": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@example.com"
    }
  },
  "targets": [{
    "type": "user",
    "id": "user_123",
    "name": "Jane Doe",
    "metadata": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@example.com"
    }
  }],
  "context": {
    "location": "203.0.113.10",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
  },
  "metadata": {
    "source": "/settings/profile"
  }
}

​
Logging Conditions

  • Event is logged when a user navigates to their settings page
  • Does not log individual setting modifications, only settings page access
  • Requires audit logging to be enabled for the organization’s subscription tier

​
Security Notes

  • Captures IP address and user agent for additional context
  • Supports tracking of admin impersonation sessions
  • Values are sanitized to prevent potential injection or oversized field issues

​
Scope of User Audit Events

The user.view_settings event is currently the only Centure audit event for users. This event tracks when users access their account settings within the Centure platform.

​
Authentication and Lifecycle Events

User authentication, lifecycle, and profile events are tracked as system events by WorkOS (our authentication provider), not as Centure audit events. These system events include:
  • User authentication attempts (SSO, OAuth, password, MFA)
  • User account creation and deletion
  • Profile updates and password changes
  • Session management
  • Email verification and password resets
To view these system events, navigate to your organization’s System Events page (admin-only). For detailed information, see System Events or the WorkOS Events documentation.