Search

ADP

ADP

Prerequisites

Before you can establish a connection with ADP, go to ADP’s Developer Self Service Portal to obtain the necessary credentials. You need to copy both a private key (.key) and a public key (.pem) that you obtain from ADP. Follow the instructions in the ADP documentation.

Note: The PEM certificate is recommended over PFX. If you use PFX, read the special instructions below.

Setup Guide

Follow these steps to connect ADP to your CData Connect Cloud account:

  1. Open the Connections page of the CData Connect Cloud dashboard.

  2. Click + Add Connection in the upper-right corner.

  3. Type ADP into the search field, then click the data source name.

  4. On the Basic Settings tab of the new connection, enter a connection name or keep the default name.

  5. The Callback URL, or Redirect URL, is the URL you need (https://oauth.cdata.com/oauth/) when setting up your OAuth app. Copy this URL and paste it into your OAuth app.

  6. Enter the following information in CData Connect Cloud:

    • OAuth Client Id—the client Id assigned when you register your ADP account for OAuth.

    • OAuth Client Secret—the client secret assigned when you register your ADP account for OAuth.

    • SSL Client Cert—First, paste the entire private key that you copied in the ADP Developer Self Service portal. The private key begins with ---BEGIN PRIVATE KEY--- and ends with ---END PRIVATE KEY---.

      Then, open the .pem file you downloaded from the ADP Developer Self Service Portal. The .pem file contains the public key. Copy and paste the contents of the .pem file after the private key information. The public key begins with ---BEGIN CERTIFICATE--- and ends with ---END CERTIFICATE---.

      Note: If you followed the manual process to use a PFX certificate instead of PEM, you must use a password-protected PFX. You also need to change the SSL Client Cert Type setting to PFXBLOB in the Advanced Settings tab of this screen.

    • SSL Client Cert Password—(optional) the password for the Client Cert, if it is encrypted. If it is not password-protected, leave this field blank.

  7. Set the Use UAT field according to your ADP configuration.

  8. At the top of the CData Connect Cloud Add ADP Connection page, click Save & Test.

    • If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.

    • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.

    • Unsuccessful connections are saved as drafts and have a Status of Not Authenticated. You can return to the connection and authenticate it later.

More Information

For more information about interactions between CData Connect Cloud and ADP, see this information page.