---
title: Client Hostname Header
description: The name of the HTTP header used to determine the hostname of a client. See also Client IP Address Header.
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.http.header.containing.remote.hostname
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.http.header.containing.remote.hostname.html
---

# Client Hostname Header

The name of the HTTP header used to determine the hostname of a client. See also [Client IP Address Header](org.forgerock.agents.http.header.containing.ip.address.html).

If this property is not set, the value returned by `HttpServletRequest.getRemoteHost` is used.

|                          |                                                                                                                                                                                                                                                           |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.http.header.containing.remote.hostname`                                                                                                                                                                                             |
| Aliases                  | `org.forgerock.agents.http.header.containing.remote.hostname`   Introduced in Java Agent 5.6`com.sun.identity.agents.config.client.hostname.header`   Introduced in Java Agent 5.0   [Recognized](preface.html#how_am_manages_multiple_aliases) from AM 6 |
| Function                 | Client identification, Continuous security                                                                                                                                                                                                                |
| Type                     | String                                                                                                                                                                                                                                                    |
| Bootstrap property       | No                                                                                                                                                                                                                                                        |
| Required property        | No                                                                                                                                                                                                                                                        |
| Restart required         | No                                                                                                                                                                                                                                                        |
| Local configuration file | `AgentConfig.properties`                                                                                                                                                                                                                                  |
| AM console               | Tab: `Advanced`Title: `Client Hostname Header`                                                                                                                                                                                                            |