Single Sign-On Service › SSO 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 Agent API. The Agent API and associated documentation accompany the Software Development Kit, which is available separately.

After you develop your own agent, 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. Create the agent type using the API included with the product.

Create a Custom Agent Object for the Agent Identity

To create a custom Agent identity, create an Agent object in the CSP console. 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

Copy Policy Server Objects

Resource Protection with a SiteMinder Agent

You associate a configured Agent with a realm, which is a collection of resources that you want to protect. Realms are protected by rules, which get included in an access control policy.