1. Before stopping the PingFederate server to upgrade the Google Workspace Provisioner, access the Attribute Mapping screen for existing channel configurations and note the current configuration.
    Warning:

    The upgrade process removes existing mappings and defaults on the Attribute Mapping screen. These must be configured again before activating the channel configuration.

  2. Disable the existing SP Connection where the Google Workspace Provisioner is configured.
  3. Delete the existing Google Workspace Provisioner SP Connection and save.
  4. Stop the PingFederate server if it is running.
  5. Unzip the Google Workspace Provisioner distribution .zip archive into a holding directory.
  6. Remove any versions of pf-google-quickconnection-x.x.jar from this directory: 
    <pf_install>/pingfederate/server/default/deploy
  7. Also remove the following files from the same directory if they are present:
    • prov-google-x.x.x.jar
    • pf-google-oauth-helper.war

    as well as these Google Admin SDK libraries:

    • google-api-client-x.x.x-rc.jar
    • google-api-services-admin-directory-directory_v1-rev-x.x.x-rc.jar
    • google-http-client-x.x.x-rc.jar
    • google-http-client-jackson2-x.x.x-rc.jar
    • google-oauth-client-x.x.x-rc.jar
    • google-oauth-client-jetty-x.x.x-rc.jar
    • jackson-core-x.x.x.jar
  8. From the dist directory of the new version of the connector, copy this file: 
    pf-google-quickconnection-3.1.1.jar

    into this directory:

    <pf_install>/pingfederate/server/default/deploy
  9. Start the PingFederate server.
  10. Create a new SP Connection, using Google Apps as the Connection Template.
  11. Follow the instructions in Configure a connection 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. Once completed with the attribute configuration, click Done, Done, and Save.
  15. Activate the SP Connection to resume Outbound Provisioning.