Java Agents 2023.11.2

Alternative Agent Protocol

In environments when agents are behind a load balancer or reverse proxy which does a SSL offloading, the request URL is changed to match the URL that the agent receives.

The agent then uses the new URL as the redirection value in the pre-authentication cookie, created during the first unauthenticated request to the agent.

Use the following properties to override the agent redirection value with the URL of the original client request: Alternative Agent Host Name, and Alternative Agent Port Number.

Property name

org.forgerock.agents.agent.protocol

Aliases

com.sun.identity.agents.config.agent.protocol
  Introduced in Java Agent 5.0
  Recognized from AM 6

org.forgerock.agents.agent.protocol
  Introduced in Java Agent 5.6

Function

Agent

Type

String

Bootstrap property

No

Required property

No

Restart required

No

Local configuration file

AgentConfig.properties

AM console

Tab: Advanced

Title: Alternative Agent Protocol