Set up a connection to ADP Workforce Now using SSL

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, you have to configure it in the Create connection panel and must complete all of the required * authentication settings: 

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

• ADP Workforce Now API guide