Programming Guides › Programming Guide for Java › Agent API › Implement the Pure Java Agent API

Implement the Pure Java Agent API

Applications that are built using the pure Java Agent API either directly or indirectly (through another agent) are insulated from underlying implementation details, including:

• User namespaces, such as LDAP directories, SQL databases, or NT domains
• Authentication methods as simple as username/password or as complex as PKI systems
• Authorizations based on group membership or individual profile data

Additional benefits provided by the Java Agent API include full session management support, automatic encryption key rollover, and real-time policy updates.

To implement the pure Java Agent API

1. Review the required software as listed in the accompanying release notes.
2. Review the sample code.
3. Write source code for your client application.
4. Ensure that SiteMinder can find the pure Java Agent API .jar file when you compile or run an agent that uses the Java Agent API. The JAR file, smagentapi.jar, is stored in the following locations:
   • Windows platforms:

   <install_path>\sdk\java

   • UNIX platforms:

   <install_path>/sdk/java

   Add smagentapi.jar to your CLASSPATH setting. When compiling, you can use the -classpath switch.

5. Compile the Java Agent API application using javac.

   For an example, see java-build.bat or java-build.sh in the sample directory smjavaagentapi.

6. Configure the Policy Server to use the Java Agent API application.
7. Run the application.