Before you start, ensure you have the Java SDK, Apache Maven and an application server, such as Apache Tomcat, installed. The sample uses Apache Maven and assumes that the Java Agent API can be referenced as a dependency. It references Ping Identity’s public Maven repository, located at

If Internet access is unavailable, there are two other ways to reference the Java Agent API. First, after Apache Maven is installed, install the Java Agent API into your local dependency repository by executing the following command.

mvn install:install-file -Dfile=<AGENT_SDK_JAVA_HOME>/dist/pingaccess-agent-java-api- -DgroupId=com.pingidentity -DartifactId=pingaccess-agent-java-api -Dversion= -Dpackaging=jar

Alternatively, update the dependency in your pom.xml to point to the local installation.


With either of these options, replace <AGENT_SDK_JAVA_HOME> with the absolute path to the extracted pingaccess-agent-java-sdk- directory.

To download the SDK, go to the PingAccess downloads site and click the Add-ons tab.