Java Agents 2024.9

Fragment Relay URI

A URI to act as a dummy endpoint within the agent for capturing URL fragments in unauthenticated requests:

  • When empty, unauthenticated requests to a URL with a fragment are authenticated and then redirected to the URL without the fragment.

  • When set, unauthenticated requests are authenticated and then redirected to the requested URL. An extra redirect is incurred for all unauthenticated requests, to capture and process the URL fragment.

Use a dummy URI within the agent web application, such as /agentapp/pre-authn-fragment-capture. Avoid dummy URIs used for other purposes.

Property name

org.forgerock.agents.authn.fragment.relay.uri

Aliases

org.forgerock.agents.authn.fragment.relay.uri
  Introduced in Java Agent 5.7
  Recognized from AM 7

Function

Fragment

Type

String

Bootstrap property

No

Required property

No

Restart required

No

Local configuration file

AgentConfig.properties

AM console

Tab: Advanced (from AM 7)

Title: Fragment Relay URI