Java Agents 2024.6

Alternative Agent Host Name

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 Port Number and Alternative Agent Protocol.

Property name

org.forgerock.agents.agent.hostname

Aliases

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

org.forgerock.agents.agent.hostname
  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 Host Name