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

Code Requirements

For a custom agent to be configured through a central host configuration object on the Policy Server, the agent must do the following:

• Initialize agent configuration through Sm_AgentApi_GetConfig().

  This function lets you pass to SiteMinder the name and path of the SmHost.conf file that resides on the trusted host. This file references the host configuration object on the Policy Server.

  Alternatively, you can pass the name and path of the WebAgent.conf file if it contains a reference to SmHost.conf.

  After the trusted host connects to the Policy Server, the interaction between the Policy Server and the agents on the trusted host is determined by the host configuration object on the Policy Server.

  Note: When you call Sm_AgentApi_GetConfig(), SiteMinder populates the Sm_AgentApi_Init_t structure. With central host configuration, you do not populate the structure directly.

• Pass the agent's name through Sm_AgentApi_SetDefaultAgentId().

  The name that the custom agent passes to SiteMinder in this function must match the name of the agent object that establishes a unique identity for your custom agent on the Policy Server.

  Call Sm_AgentApi_SetDefaultAgentId() after calling Sm_AgentApi_Init() and before making any other Agent API calls. This allows you to specify your custom agent name to SiteMinder without sending the name with each transaction.