Policy Server Guides › Policy Server Configuration Guide › Agents and Agent Groups › Custom Agents

Custom Agents

You create a custom agent using either the C or Java version of the CA SiteMinder® Agent API. The CA SiteMinder® Agent API and associated documentation are provided by the Software Development Kit, which is available separately.

Note: Custom Agents do not support central agent configuration. More information about using an API to create a custom Agent exists in the CA SiteMinder® Programming Guide for C or the CA SiteMinder® Programming Guide for Java.

After you develop your own Agent, you must configure a new Agent type. The Agent type defines the behavior of an agent and lets you use the custom Agent to protect resources. For example, if you developed a custom FTP Agent, you would then need to define an FTP Agent type.

Configure a Custom Agent Type

You configure a custom Agent type to define the behavior of a custom agent and to identify the custom agent when creating the agent object. You create the Agent type using a CA SiteMinder® API.

Note: More information on creating an Agent type using the C version of the CA SiteMinder® Agent API exists in the CA SiteMinder® Programming Guide for C .

Create a Custom Agent Object for the Agent Identity

To create a custom Agent identity, create an Agent object in the Administrative UI. Creating an Agent object and identity lets you associate the Agent with a realm.

Note: The following procedure assumes that you are creating an object. You can also copy the properties of an existing object to create an object.

To create an Agent object

1. Click Infrastructure, Agent.
2. Click Agents.

   The Agents page appears.

3. Click Create Agent.

   Verify that the Create a new object of type Agent option is selected.

4. Click OK.

   The Create Agent page appears.

   Note: Click Help for descriptions of settings and controls, including their respective requirements and limits.

5. Type the name and a description of the Agent.

   Limits:

   • Agent names must contain 7-bit ASCII characters in the range of 32-127, including one or more printable characters.
   • Agent names must not contain the ampersand (&) and asterisk (*) characters.
   • Agent names are not case-sensitive. You cannot create one agent named MyAgent and another Agent named myagent.
6. Select CA SiteMinder® as the Agent Style, Web Agent as the Agent Type, and the Supports 4.x agents option.

   The Trust Settings fields appear.

7. Type the IP Address of the server on which the Agent resides.
8. Type and confirm a shared secret.

   Limits:

   • The secret that you supply must match the secret that was assigned when the Agent was installed on the Web Server.
   • The secret must contain at least 1 character and not more than 255 characters.
   • The secret must only contain alphanumeric characters.
   • The secret must not contain embedded spaces.
9. Click Submit.

   The Agent object is created.

More information:

Configure a Custom Agent Type

Duplicate Policy Server Objects