GitHub

Deploying the integration files

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

About this task

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

Steps

  1. Download the GitHub Login Integration Kit .zip archive from the Ping Identity Integration Directory.

  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 GitHub Login Integration Kit files that you customized in the <pf_install>/pingfederate/server/default/conf/ directory.

    2. Delete the pf-github-idp-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 there is more than one version of the pf-authn-api-sdk-<version>.jar file in your <pf_install>/pingfederate/server/default/lib directory, delete all but the latest version of the file.

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

  7. Start PingFederate.

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