Agent Guides › Web Agent Guide › Basic Web Agent Configuration › Set the Agent Name and Default Agent Name Identities

Set the Agent Name and Default Agent Name Identities

The Agent name is the Agent’s identity. The Policy Server uses this identity to tie policies to a Web Agent. You can define the name of a Web Agent with the following parameters:

AgentName

Defines the identity of the Web Agent. It establishes a mapping between the name and the IP address of each web server instance hosting an Agent.

If a value is not set for this parameter, or if the Web Agent does not find a match among the values listed, the Web Agent uses the value set in the DefaultAgentName parameter instead.

Note: This parameter can have more than one value. Use the multi-value option when setting this parameter in an Agent Configuration Object. For local configuration files, add the parameter name followed by each value to separate lines in the file.

Default: No default

Limits: Must contain 7-bit ASCII characters in the range of 32-127, and include one or more printable characters. Cannot contain the ampersand (&) and asterisk (*) characters. Not case-sensitive. For example, the names MyAgent and myagent are treated the same.

Example: myagent1,192.168.0.0

Example: myagent, www.sitea.com

DefaultAgentName

Defines a name that the Web Agent uses when it receives a request on an IP address or interface for which there is no agent name specified in the AgentName parameter.

If you are using virtual servers, you can set up your SiteMinder environment quickly by using a DefaultAgentName instead of defining a separate Web Agent for each virtual server.

Important! If you do not specify a value for the DefaultAgentName parameter, you must list every agent identity in the AgentName parameter. Otherwise, the Policy Server will not be able to tie policies to the Web Agent.

Default: No default

Limits: Must contain 7-bit ASCII characters in the range of 32-127, and include one or more printable characters. Cannot contain the ampersand (&) and asterisk (*) characters. Not case-sensitive. For example, the names MyAgent and myagent are treated the same.

If you are configuring virtual server support, you must specify a value for the AgentName or DefaultAgentName parameter.

To set the agent name and default agent name identities

1. Specify the agent name identities by doing either of the following:
   • For central agent configurations, open the Agent Configuration Object on the Policy Server User Interface, and then add the values that you want to the AgentName parameter.
   • For local agent configurations, open the local configuration file on your web server. Add the values you want on a separate lines in the file.
2. Specify a default agent name identity by doing either of the following:
   • For central agent configurations, open the Agent Configuration Object on the Policy Server User Interface, and then add the value that you want to the DefaultAgentName parameter.
   • For local agent configurations, open the local configuration file on your web server. Add the value you want to the DefaultAgentName parameter.

   The agent name and default agent name identities are set.

More Information

How to Set Up Virtual Server Support