Programming Guides › Programming Guide for C › Agent API › Central Host Configuration › Configuration Requirements

Configuration Requirements

To configure a custom agent through a host configuration object on the Policy Server, you must complete the following steps:

1. Register the client machine where the agent resides as a trusted host.

   You register a trusted host with the smreghost tool. This tool is installed in directory <install_path>/sdk/bin.

   Registering a trusted host creates the following items:

   • A host configuration object on the Policy Server. The host configuration object can be modified in the Administrative UI at any time.
   • The file SmHost.conf on the client. This file includes the parameter hostconfigobject, which references the host configuration object on the Policy Server.

     The information in SmHost.conf is used to initialize the connection between the Policy Server and its agents, through the Agent API. Once the connection is initialized, the information in the host configuration object determines how the Policy Server and its agents interact.

2. Define an agent object on the Policy Server.

   An agent object establishes a unique identity for your custom agent by defining a name and other information that is specific to your custom agent.

   The name assigned to the custom agent must match the name that the custom agent passes programmatically to SiteMinder.