To Create a New Agent

Creating a new agent is also referred to as creating a new agent profile. You can perform this task in the OpenSSO Administration Console. Some of the individual steps only apply to the J2EE and Web policy agent types.

1. Click the Access Control tab.
2. Click the name of the realm to which the agent will belong.
3. Click the Agents tab.
4. Select the tab for the appropriate agent type.
   • Web Agents
   • J2EE Agents
   • Web Service Provider Agents
   • Web Service Client Agents
   • STS Client Agent

     The Security Token Service client agent has two types from which to choose, Discovery agent and STS agent. For more information on these agent types, see STS Client.

   • 2.2 Agents

     The 2.2 Agents tab is for agents in the Policy Agent 2.2 software set.

   • Agent Authenticator
5. In the Agent section, click New.
6. In the Name field, enter the name for the new agent profile.
7. Enter and confirm the Password.

   ---

   Caution – This password must be the same password that you enter in the agent profile password file that you specify when you run the agentadmin program to install the agent.

   ---

   Steps 8–10 Apply to Web and J2EE policy agents only.

8. Select the applicable configuration: Local or Centralized .

   When local configuration is selected, the properties related to this agent cannot be edited from the Console. In such a scenario, the agent retrieves configuration information from the local files, OpenSSOAgentBootstrap.properties and OpenSSOAgentConfiguration.properites, in the agent installation directory. For an agent configured locally, change property values by editing the OpenSSOAgentConfiguration.properites file directly.

9. In the Server URL field, enter the OpenSSO server URL.

   For example:

   http://OpenSSO_EnterpriseHost.example.com:8080/OpenSSO

10. In the Agent URL field, enter the URL for the agent application, agentapp .

    For example:

    Web Agents

    http://agentHost.example.com:8090

    J2EE Agents

    http://agentHost.example.com:8090/agentapp

11. Click Create.

    The Console creates the agent profile and displays the agent page again, with a link to the new agent profile.

    To do additional configuration for the agent profile, click this link to display the Edit agent page.