PingOne

Deploying the integration files

To get started with the integration, deploy the PingOne DaVinci Integration Kit files to your PingFederate directory.

Before you begin

If upgrading from PingOne DaVinci Integration Kit Beta, you must delete any Beta adapter configuration and existing files from /conf related to the PingOne DaVinci Integration Kit before updating PingFederate with content from the new .zip.

If running the kit after an upgrade results in a JSON schema validation error, you must add the nonce parameter to the input schema in DaVinci. For more information, see Building a flow in DaVinci.

About this task

If you operate PingFederate in a cluster, the following steps refer to the console node.

Steps

  1. Download the PingOne DaVinci Integration Kit .zip archive from the Add-ons tab of the PingFederate downloads page or the Ping Identity Marketplace.

  2. Stop PingFederate.

  3. If you’re upgrading an existing deployment, back up your customizations and delete earlier versions of the integration files:

    1. Back up any PingOne DaVinci Integration Kit files that you customized in the <pf_install>/pingfederate/server/default/conf/ directory.

    2. Delete the pf-pingone-davinci-adapter-<version>.jar file from your <pf_install>/pingfederate/server/default/deploy directory.

  4. Extract the .zip archive and merge the contents of the dist directory with your <pf_install>/pingfederate directory.

  5. If you backed up any customized files, modify the new files with your customizations.

  6. Start PingFederate.

  7. If you operate PingFederate in a cluster, repeat steps 2-6 for each engine node.