Java Integration Kit

Deploy the sample applications

The Java Integration Kit includes two applications that act as identity provider (IdP) and service provider (SP) in the demonstration environment. Deploy the applications into the PingFederate servlet container as follows.

About this task

As of Java Integration Kit 2.8, there are two versions of the OpenToken agent: the standard OpenToken agent, and the Jakarta EE 9 OpenToken agent. The Jakarta EE 9 OpenToken agent has its own version of the sample applications located in the /sample/jakarta folder.

  • You can only deploy the sample Jakarta applications on servers that support Jakarta EE 9. Currently, PingFederate does not support Jakarta EE 9.

  • You should not deploy both versions of the OpenToken agent on the same instance because they need to listen to the same endpoint.

To test a custom configuration, you can deploy the applications in a separate container on your network and then make the necessary configuration changes as described in Advanced installation and configuration.

Steps

  1. Stop PingFederate.

  2. From the Java Integration Kit .zip archive, copy the sample/IdpSample.war and sample/SpSample.war files to <pf_install>/pingfederate/server/default/deploy.

  3. Start PingFederate.