Enable Fragment Redirect

A flag to manage the browser’s URL fragment during authentication, as follows:

  • false: Remove the browser’s URL fragment during authentication. For example, a request to http://my.domain.com:8080/myapp/index.html#chapter-1 is authenticated and redirected to http://my.domain.com:8080/myapp/index.html. The fragment #chapter-1 is lost.

  • true: Save the browser’s URL fragment during authentication. For example, a request to http://my.domain.com:8080/myapp/index.html#chapter-1 is authenticated and redirected to the same URL. The fragment is not lost.

An extra redirect is incurred for all unauthenticated requests, to capture and process the URL fragment.

Fragment redirect is not possible in the following cases:

  • The request URL is marked for JSON responses, usually for non-browser clients, such as JavaScript or other coded clients.

  • The agent is configured to use Enable Custom Login Mode with the value 2, for non-OIDC compliant login flow, non-standard flow. The agent does not track the user’s authentication, and redirects the user with a goto query parameter to the originally requested resource.

Default: false

Property name

org.forgerock.agents.config.fragment.redirect.enable

Property aliases

org.forgerock.agents.config.fragment.redirect.enable (since 5.7)

Type

Boolean: true returns true; all other strings return false.

Bootstrap property

Yes

Required property

No

Restart required

No

AM console tab

Advanced (Available in the console from AM 7)