Java Agents 2023.11.2

Conditional Logout URL List

Define URLs to which the agent can conditionally direct the user on logout. This property does not trigger logout.

Configure one or more conditions, using this format:

domain/path|url?param1=value1&param2=value2

The request URL is compared to each condition in the list until a match is found. Conditions are evaluated by order of length, starting with the longest, irrespective of their order in the list.

Depending on the value of the redirection URL, perform this additional configuration:

  • If the URL doesn’t perform a REST logout to AM, set Always invalidate sessions to true. The agent additionally invokes the AM REST logout endpoint to invalidate the session.

  • If the URL isn’t relative to an AM URL, or in the same scheme, FQDN, and port as an AM URL, add it to the AM validation service.

In the following example, example.com/path is evaluated before example.com; the default condition is the shortest, and is evaluated last:

org.forgerock.agents.conditional.logout.url.list[0]=example.com|?additional=value

org.forgerock.agents.conditional.logout.url.list[1]=example.com/path|?one=red&two=green&three=blue

org.forgerock.agents.conditional.logout.url.list[2]=mybank.com|http://mybank.com/myapp/logout?param=override

org.forgerock.agents.conditional.logout.url.list[3]=|?alpha=beta

For more information, refer to Conditionally log out to different URLs.

Property name

org.forgerock.agents.conditional.logout.url.list

Aliases

org.forgerock.openam.agents.config.conditional.logout.url
  Introduced in Java Agent 5.6
  Recognized from AM 6

org.forgerock.agents.conditional.logout.url.list
  Introduced in Java Agent 5.6

Function

Logout

Type

List

Bootstrap property

No

Required property

No

Restart required

No

Local configuration file

AgentConfig.properties

AM console

Tab: AM Services

Title: Conditional Logout URL List

Legacy title: AM Conditional Logout URL