PingAccess

Installing and configuring QuickStart components

Install the QuickStart utility along with PingAccess and PingFederate.

Before you begin

Make sure you run the QuickStart server with a supported PingAccess Java Runtime Environment.

Steps

  1. On the PingFederate Downloads page, download PingFederate 12.2 or later.

  2. If you plan to use the one-time authentication app, install the client-initiated backchannel authentication (CIBA) authenticator plugin.

    1. Copy the plugin corresponding to your PingFederate version from the <Quickstart Home>/plugins/deploy directory into the <PingFederate Home>/server/default/deploy directory:

      • PingFederate 13.0 or earlier: Copy pf.plugins.ciba-auth-plugin-example-pre-13.1.jar.

      • PingFederate 13.1 or later: Copy pf.plugins.ciba-auth-plugin-example.jar.

    2. Copy the contents of the <Quickstart Home>/plugins/conf directory into the <PingFederate Home>/server/default/conf directory.

      If you want to use an authenticator other than CIBA, you must configure it manually in PingFederate before configuring the one-time authentication app.

  3. Perform first-time setup in PingFederate.

  4. On the PingAccess Downloads page, download PingAccess 8.2 or later.

    1. Install PingAccess.

    2. Perform first-time setup in PingAccess.

  5. On the Add-ons tab of the PingAccess Downloads page, download the PingAccess QuickStart bundle. Extract the files.

  6. Change to the QuickStart directory and run the quickstart-server-<version>.jar file.

    java -jar quickstart-server-6.2.0.0.jar

    You can use the --server.port=<port> argument to specify a port other than the default of 8443.

    java -jar quickstart-server-6.2.0.0.jar --server.port=8444

Next steps