---
title: FQDN Virtual Host Map
description: Key:Value maps of incoming hostname to outgoing domain. The map key must be set; the map value can contain one or more * wildcards. Map keys and values are case insensitive.
component: web-agents
version: 2025.11
page_id: web-agents:properties-reference:com.sun.identity.agents.config.fqdn.mapping
canonical_url: https://docs.pingidentity.com/web-agents/2025.11/properties-reference/com.sun.identity.agents.config.fqdn.mapping.html
---

# FQDN Virtual Host Map

Key:Value maps of incoming hostname to outgoing domain. The map key must be set; the map value can contain one or more `*` wildcards. Map keys and values are case insensitive.

This property requires [Enable FQDN Check](com.sun.identity.agents.config.fqdn.check.enable.html) to be `true`, and [FQDN Default](com.sun.identity.agents.config.fqdn.default.html) to be set to suitable default FQDN.

Examples:

`com.sun.identity.agents.config.fqdn.mapping[agent.localtest.me]=agent.example.com`

`com.sun.identity.agents.config.fqdn.mapping[agent.localtest.me]=agent-*`

`com.sun.identity.agents.config.fqdn.mapping[agent.localtest.me]=agent--other-`

`com.sun.identity.agents.config.fqdn.mapping[agent.othertest.me]=other.example.com`

Learn more in [FQDN checks](../user-guide/fqdn-checking.html) in the *User Guide*.

|                    |                                                                             |
| ------------------ | --------------------------------------------------------------------------- |
| Property name      | `com.sun.identity.agents.config.fqdn.mapping`   Introduced in Web Agent 4.x |
| Function           | FQDN check                                                                  |
| Type               | String Map                                                                  |
| Bootstrap property | No                                                                          |
| Required property  | No                                                                          |
| Restart required   | No                                                                          |
| AM console         | Tab: `Global`Title: `FQDN Virtual Host Map`                                 |