Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Log Impersonation History

Enable impersonation history logging using a system property.

The impersonation history log tracks the following impersonation details on the Impersonation History [sys_user_impersonation_history] table when an impersonation is performed using the UI.

  • Impersonating user
  • Impersonated user
  • Impersonation start and end times
  • SessionID

Ensure that the identity.impersonation.history.enabled property doesn’t exist in the System Properties [sys_properties] table, or exists and is set to a value of true.

More information

AttributeDescription
Configuration nameidentity.impersonation.history.enabled
Configuration typeSystem Properties \(/sys\_properties\_list.do\)
Data typeBoolean
Recommended valuetrue
Default valuetrue
Fallback valuetrue
CategoryError handling and logging
Security risk- Severity score: 4.9 - CVSS score: Medium - Security risk details: When this property is set to `true`, impersonation session details are logged in the Impersonation History \[sys\_user\_impersonation\_history\] table. Use this information for auditing in security investigations or for compliance purposes.
Functional ImpactWhen this property is set to `true`, impersonation session details are logged in the Impersonation History \[sys\_user\_impersonation\_history\] table. When set to `false`, the impersonation details aren’t captured this table.
Dependencies and prerequisitesNone

Parent Topic:Error handling and logging