---
title: Public AM URL
description: "The assembled \"public\" URL of AM. This URL is used by the agent to redirect the user's browser to AM for login (customised or not), or if necessary, exchange an SSO token for a JWT."
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.public.am.url
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.public.am.url.html
---

# Public AM URL

The assembled "public" URL of AM. This URL is used by the agent to redirect the user's browser to AM for login (customised or not), or if necessary, exchange an SSO token for a JWT.

The following properties make up the URL:

* [AM Authentication Service Protocol](org.forgerock.agents.am.protocol.html)

* [AM Authentication Service Host Name](org.forgerock.agents.am.hostname.html)

* [AM Authentication Service Port](org.forgerock.agents.am.port.html)

* [AM Authentication Service Path](org.forgerock.agents.am.path.html)

The "private" URL is used by the agent for tasks such as establishing websockets, and obtaining authentication tokens or session information. The AM or load balancer instance can be behind a firewall to which the agent has access.

Define this property when public access to AM is restricted to a different URL from the private URL.

|                          |                                                                                                                                                |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.public.am.url`                                                                                                           |
| Aliases                  | `com.forgerock.agents.public.am.url`   Introduced in Java Agent 5.6.3.0`org.forgerock.agents.public.am.url`   Introduced in Java Agent 5.6.3.0 |
| Function                 | Miscellaneous, Required                                                                                                                        |
| Type                     | String                                                                                                                                         |
| Bootstrap property       | Yes                                                                                                                                            |
| Required property        | Yes - If this property is missing, the agent fails to start                                                                                    |
| Restart required         | Yes - Restart the container after changing the property                                                                                        |
| Local configuration file | `AgentBootstrap.properties`                                                                                                                    |