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
Introduced in Web Agent 5.7

Type

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

Bootstrap property

Yes

Required property

Restart required

AM console

Tab: Advanced (From AM 7)

Title: Enable Fragment Redirect