---
title: Enable FQDN Checking
description: When true, the agent compares the hostname of each request to the mappings in FQDN Map.
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.fqdn.check.enabled
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.fqdn.check.enabled.html
---

# Enable FQDN Checking

When `true`, the agent compares the hostname of each request to the mappings in [FQDN Map](org.forgerock.agents.fqdn.map.html).

* If it finds a match, it transforms the request URL to the mapped URL.

* If it doesn't find a match, it transforms the request URL to the value in [Default FQDN](org.forgerock.agents.fqdn.default.html).

If [Default FQDN](org.forgerock.agents.fqdn.default.html) is not set, this property is automatically set to `false`.

|                          |                                                                                                                                                                                                                                  |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.fqdn.check.enabled`                                                                                                                                                                                        |
| Aliases                  | `com.sun.identity.agents.config.fqdn.check.enable`   Introduced in Java Agent 5.0   [Recognized](preface.html#how_am_manages_multiple_aliases) from AM 6`org.forgerock.agents.fqdn.check.enabled`   Introduced in Java Agent 5.6 |
| Function                 | Fully qualified domain name                                                                                                                                                                                                      |
| Type                     | Boolean: `true` returns true; all other strings return `false`.                                                                                                                                                                  |
| Default                  | `true`                                                                                                                                                                                                                           |
| Bootstrap property       | No                                                                                                                                                                                                                               |
| Required property        | No                                                                                                                                                                                                                               |
| Restart required         | No                                                                                                                                                                                                                               |
| Local configuration file | `AgentConfig.properties`                                                                                                                                                                                                         |
| AM console               | Tab: `Global`Title: `Enable FQDN Checking`Legacy title: `FQDN Check`                                                                                                                                                             |