---
title: Legacy Login URL List
description: Adds parameters conditionally to legacy login URLs.
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.legacy.login.url.list
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.legacy.login.url.list.html
---

# Legacy Login URL List

Adds parameters conditionally to legacy login URLs.

Format, with no spaces between values:

`domain/path|url?param1=value1&param2=value2`

* Domain/path

  The incoming request URL:

  * Domain: For example, `example.com`. The agent must match the domain and its subdomains. For example, `example.com` matches `mydomain.example.com` and `www.example.com`. Domains can also include path information, for example, `example.com/market`, but cannot specify ports.

  * Subdomain: For example, `mydomain.example.com`. The agent match the domain, the subdomain, and any sub-subdomain. For example, `mydomain.example.com` matches `true.mydomain.example.com`. Subdomains can include path information, for example, `mydomain.example.com/s6ecure`, but cannot specify ports.

  * Path: For example, `/myapp`.

  * No value: Nothing is specified before the `|` character and the rule applies to every incoming request.

* URL

  The URL to which redirect incoming login requests. The URL may be an AM instance, an AM site, or a website other than AM.

  Specify a URL in the format `protocol://FQDN[:port]/URI`, where the port is optional if it is 80 or 443. For example:

  `https://myweb.example.com/authApp/login.jsp`

  `https://am.example.com:8443/am/XUI/#login/`

  `https://am.example.com:8443/am/customlogin/login.jsp`

  If the URL is not specified, the agent redirects the request to the AM instance or site specified by the following bootstrap properties:

  `org.forgerock.agents.am.protocol://org.forgerock.agents.am.hostname:org.forgerock.agents.am.port/org.forgerock.agents.am.path`

* \&parameter1=value1

  Parameters that can be added to the URL. Add as many parameters as your custom login pages need. Chain parameters with an & character, for example, `realm=value&parameter1=value1&parameter2=value2`.

Examples

`org.forgerock.agents.legacy.login.url.list[0]=example.com|https://am.example.com/am/XUI/#login&realm=customers`

`org.forgerock.agents.legacy.login.url.list[1]=myapp.domain.com|https://login.example.com/apps/login.jsp?realm=sales`

`org.forgerock.agents.legacy.login.url.list[2]=sales.example.com/marketplace|?realm=marketplace`

`org.forgerock.agents.legacy.login.url.list[3]=|https://login.example.com/apps/login.jsp?realm=sales&isblue=true&carowner=true`

`org.forgerock.agents.legacy.login.url.list[4]=|?realm=sales`

|                          |                                                                                                                                                                                                                                                    |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.legacy.login.url.list`                                                                                                                                                                                                       |
| Aliases                  | `org.forgerock.openam.agents.config.conditional.custom.login.url`   Introduced in Java Agent 5.6   [Recognized](preface.html#how_am_manages_multiple_aliases) from AM 7`org.forgerock.agents.legacy.login.url.list`   Introduced in Java Agent 5.6 |
| Function                 | Custom login redirect, Default Login Redirect, Login redirect, Login Redirect (Default)                                                                                                                                                            |
| Type                     | List                                                                                                                                                                                                                                               |
| Bootstrap property       | No                                                                                                                                                                                                                                                 |
| Required property        | No                                                                                                                                                                                                                                                 |
| Restart required         | No                                                                                                                                                                                                                                                 |
| Local configuration file | `AgentConfig.properties`                                                                                                                                                                                                                           |
| AM console               | Tab: `AM Services (from AM 7)`Title: `Legacy Login URL List`Legacy title: `Custom Conditional Login URL`                                                                                                                                           |