Policy Server Guides › Policy Design Guide › Agents and Agent Groups › Configure a Web Agent › Create an Agent Object to Establish a Web Agent Identity › Configure an Agent Object for a 4.x Web Agent Identity

Configure an Agent Object for a 4.x Web Agent Identity

Important! You will receive correspondence from CA regarding the end date for 4.x Web Agent support.

Note: When you create or modify a Policy Server object in the Policy Server User Interface, use ASCII characters. Object creation or modification with non-ASCII characters is not supported.

To configure an agent object

1. Log into the Policy Server User Interface.
2. From the menu bar of the SiteMinder Administration window, select Edit, System Configuration, Create Agent.

   The Agent Properties dialog opens.

3. In the Name field, enter the name of the new Agent. This name is case-insensitive. You can’t create an agent named MyAgent and a different agent named myagent.

   Agent names must be 7-bit ASCII characters, in the range 32-127.

   Note: For Web Agents, the Agent identity name must correspond to the Agent name that you specified when you installed the Agent. If you change the Agent name in the Web Agent Management Console or the WebAgent.conf file (see the SiteMinder Web Agent Guide), you must also edit the Agent name here.

4. Optionally, in the Description field, enter a brief description of the Agent.
5. Select the Support 4.x agents check box.

   A further set of controls specific to 4.x agent types appears in the lower part of the dialog.

6. In the Agent Type group box, select the SiteMinder radio button.
7. In the drop-down list in the Agent Type group box, select Web Agent.
8. In the IP Address or Host Name field, enter the IP address or the host name of the server on which the Agent resides.

   Note: For virtual servers, define virtual server names and IP addresses as you would define a single server. Each Agent on a virtual server must have a unique Agent Name.

9. In the Shared Secret Field, enter an alphanumeric shared secret.

   Enter the shared secret assigned to the Agent when the Agent was installed on the Web server. The shared secret is used for mutual authentication when a 4.x Agent attempts to connect to a Policy Server. The secret must be between 1 and 255 characters in length and contain no embedded spaces.

   Note: You must use the same shared secret for each virtual server on a single Web server.

10. In the Confirm Secret field, re-enter the shared secret.
11. Click Apply to save the changes, or click OK to save the changes and return to the SiteMinder Administration window.

    When you create realms, you will associate each realm with a Web Agent identity.

You can only configure a SiteMinder 4.x Web Agent using a local Web Agent configuration file. For configuration parameter descriptions, see the SiteMinder Web Agent Guide.

There are a number of tasks that must be completed in order to fully configure a Web Agent. These tasks apply to local and central configuration of a Web Agent.

More information:

Start the Policy Server User Interface

Agent Dialog

Grouping Resources in Realms