Web Agent Properties That Are Map Constructs

Knowledge of the format of these map constructs is often not required in order to set them. For example when you configure the properties using OpenSSO Enterprise Console, you do not interact with the “<key>[<name>]=<value>” formatting involved with map constructs. However, if you use OpenSSO Enterprise Console to set a map, though the formatting information provided in this section is not applicable, the general information about maps is useful.

See the following table to determine when the map construct format is required to set this property.

Table 4–2 Use of the Map Construct Format: Required or Not

Method for Setting Properties	Location of Agent Configuration	Use of Map Construct Format Required
Using the OpenSSO Enterprise Console	Centralized agent configuration	NO
Using the ssoadm command-line utility	Centralized agent configuration	YES
Using the OpenSSOAgentConfiguration.properties file	Local agent configuration	YES

Certain web agent properties are specified as maps. A map construct has the following format (Does not apply when OpenSSO Enterprise Console is used):

<key>[<name>]=<value>

key

The configuration key (name of the configuration property)

name

A string that forms the lookup key as available in the map

value

The value associated with the name in the map

---

Note –

Properties that are specified in this manner must follow the preceding format, otherwise they will be treated as invalid or missing properties.

For a given <name>, there may only be one entry in the configuration for a given configuration key (<key>). If multiple entries with the same <name> for a given configuration key are present, only one of the values will be loaded in the system and the other values will be discarded.

---

---

Example 4–3 Example of Web Agent Properties That Are Map Constructs

com.sun.identity.agents.config.fqdn.mapping[invalid_hostname] = valid_hostname
com.sun.identity.agents.config.profile.attribute.mapping[mail] = email

---