---
title: Fragment Relay URI
description: A URI to act as a dummy endpoint within the agent for capturing URL fragments in unauthenticated requests:
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.authn.fragment.relay.uri
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.authn.fragment.relay.uri.html
---

# 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](preface.html#how_am_manages_multiple_aliases) 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`                                                                                                |