Articles in this section

Set up a connection to ADP Workforce Now using SSL

Saikumar Rachamalla
Updated

ADP Workforce Now is a single-database platform with which you can get a comprehensive HR suite with payroll, time, HR, talent, and benefits all under one roof. Also, you can connect seamlessly to your existing tools and partners or hundreds of best-in-class, pre-integrated apps in the ADP Marketplace.

Important

Before integrating with ADP, you must purchase API access for your account. You may be asked to pay a one-time implementation fee and recurring monthly fees for API access. Contact ADP support for details.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection *

Enter a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

SSL client key *

Generate a KEY file and upload it to this setting.

How to generate a KEY file

SSL certificate *

Generate a CSR file and send it to your ADP representative to receive the PEM certificate file to upload to this setting.

How to create a CSR file

Account type *

Select either of the following ADP accounts, depending on the access level provided when you signed up:

Production: if your account URL is https://api.adp.com.

UAT: if your URL is https://uat-api.adp.com.

Client ID *

Generate a certificate signing request (CSR) file and send it to your ADP representative to receive the client ID and client secret to enter for your connection.

How to create a CSR file

Client secret *

Generate a CSR file and send it to your ADP representative to receive the client ID and Client secret to enter for your connection. Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s secret safe. When editing this form later, you must enter this value again; it is stored only when the connection is saved and never displayed as text.

How to create a CSR file

SSL passphrase 

You can set a password or phrase for your SSL certificate and key (when combined, known as a PKCS12) for additional security.

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see token auth universal connector documentation.

How to create a CSR file and a KEY file

On a Mac

SSL connections to ADP require you to install OpenSSL Light and modify the system variables for your OS. Since Mac operating systems currently support an older version of OpenSSL (LibreSSL), Celigo recommends installing Homebrew instead.

Mac uses bash shell, so you can add environment variables to your .bash_profile file. Verify that these files are visible on your machine.

Tip

At the end of the file, you may see export command lines. If so, add these environment variables here. If not, just add them at the end of the file.

  1. Enter the following command:

    export PATH="/usr/local/opt/openssl/bin:$PATH”

  2. Restart the terminal, then enter the following command:

    source ~/.bash_profile

  3. Check that your OpenSSL version has been updated with the following command:

    openssl version

  4. To generate the KEY file, enter this one-line command:

    openssl genrsa -out yourcompanynamehere_auth.key 2048

    Replace yourcompanynamehere with your company’s name.

  5. To generate the CSR file, enter the following one-line command:

    openssl req -new -key yourcompanynamehere_auth.key -out yourcompanynamehere_auth.csr

    Replace yourcompanynamehere with your company’s name.

Email the CSR file to your ADP representative. After ADP gets your file, they will send you your client ID and client secret. The connection sends your client ID as proof that an authorized person wants to establish a connection between ADP and integrator.io.

On a Windows PC

SSL connections to ADP require you to install OpenSSL Light and modify the system variables for your OS. Use the following steps to add the OPENSSL_CONF variable to your system variables.

  1. Click the Windows Start button and search for “Edit the system environmental variables.”

  2. Click Edit the System environment variables.

  3. The System Properties window opens to the Advanced tab. Click the Environment Variables... button in the lower right corner of the window.

  4. In the System variables section, click New....

  5. Type OPENSSL_CONF in the Variable name field.

  6. Type c:\OpenSSL-Win32\bin\openssl.cfg in the Variable value field.

  7. Click OK.

Next, edit the file openssl.cfg:

  1. In your file system, open openssl.cfg.

  2. In the [req_attributes] section, delete unstructuredName = An optional company name.

Open a command prompt and change the directory to c:\OpenSSL-Win32\bin to create the files:

  1. To generate the KEY file, type this one-line command:

    openssl genrsa -out yourcompanynamehere_auth.key 2048

    Replace yourcompanynamehere with your company’s name.

  2. To generate the CSR file, use this one-line command:

    openssl req -new -key yourcompanynamehere_auth.key -out yourcompanynamehere_auth.csr

    Replace yourcomanynamehere with your company’s name.

Email the CSR file to your ADP representative. After ADP gets your file, they will send you your client ID and client secret. The connection sends your client ID as proof that an authorized person wants to establish a connection between ADP and integrator.io.

Additional references