Java Agents 2024.9

Enable User Principal Flag

When the property User Mapping Mode is USER_ID, this flag indicates whether to identify the user through the user DN, as follows:

  • If true, the DN is taken from universalId, retrieved from the AM user session info.

  • If false, the user is identified by the the property User Session Name.

Property name

org.forgerock.agents.userid.mapping.mode.use.dn.enabled

Aliases

com.sun.identity.agents.config.user.principal
  Introduced in Java Agent 5.0
  Recognized from AM 6

org.forgerock.agents.userid.mapping.mode.use.dn.enabled
  Introduced in Java Agent 5.6

Function

User mapping

Type

Boolean: true returns true; all other strings return false.

Default

false

Bootstrap property

No

Required property

No

Restart required

No

Local configuration file

AgentConfig.properties

AM console

Tab: Global

Title: Enable User Principal Flag

Legacy title: User Principal Flag