Java Agents 2023.11.1

Alternative Agent Port Number

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 Protocol.

Property name

org.forgerock.agents.agent.port

Aliases

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

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

Function

Agent

Type

Integer

Default

-2147483648

Bootstrap property

No

Required property

No

Restart required

No

Local configuration file

AgentConfig.properties

AM console

Tab: Advanced

Title: Alternative Agent Port Number