Dropbox Provisioner

Upgrading existing Dropbox connectors

Steps

  1. Before stopping the PingFederate server to upgrade the Dropbox Connector, on the Attribute Mapping tab for existing channel configurations, record the current configuration.

    The upgrade process removes existing mappings and defaults on the Attribute Mapping tab. You must configure these again before activating the channel configuration.

  2. Disable the existing service provider (SP) connection where the Dropbox Connector is configured.

  3. Delete the existing Dropbox Connector SP connection and save.

  4. Stop the PingFederate server if it is running.

  5. Extract the Dropbox Connector distribution .zip archive into a holding directory.

  6. Remove any versions of pf-dropbox-quickconnection-.x.jar from the <pf_install>/pingfederate/server/default/deploy directory.

  7. Remove the following files from the same directory if they are present:

    • pf-dropbox-oauth-helper.war

    • gson-2.2.4.jar

  8. From the /dist directory of the new version of the connector, copy the pf-dropbox-quickconnection-2.0.jar to the <pf_install>/pingfederate/server/default/deploy directory.

    Make sure to remove existing versions of Dropbox Connector files.

  9. Start the PingFederate server.

  10. Create a new SP connection using Dropbox as the connection template.

  11. Follow the instructions in the Creating a connection section to configure Metadata and OAuth.

  12. Access the Attribute Mapping for existing channel configurations and click Refresh Fields.

  13. Ensure all new required fields, if any, are mapped appropriately or have a default value.

  14. When you have finished the attribute configuration, click Done, Done, and Save.

  15. Click the toggle to activate the SP Connection to resume outbound provisioning.