UltiPro Directory (UKG Pro) Connector 

This topic describes how to import users from UltiPro to OneLogin using the UltiPro directory connector, essentially treating UltiPro as your user directory of record.

Prerequisite Requirements:

• BI User Report with several required fields
  • First Name
  • Last Name
  • Email Address
  • Username
  • Ultipro Employee ID
  • Status

Note: Additional fields may be required based on downstream user workflows

• Ultipro User Account that is able to view/download the above report via API access. Fields required for access the BI Report:
  • Username
  • Password
  • Domain
  • Client Access Key
  • User Access Key

1. Log into OneLogin as an administrator and go to Users > Directories.

2. Click New Directory and select UltiPro.

3. Give the directory a name, and then choose OneLogin under Authenticate users in.

4. Click Save to enable additional configuration fields and tabs.

   

5. To use this directory connector to import users from UltiPro to OneLogin, select Enabled under Importing Users.

6. Enter the API Settings required to connect to the UltiPro API.

   

   Username and Password are the credentials for the UltiPro administrator account that has access to the API.

   You can get your Domain from your UltiPro administrative URL:
   https://your_domain.ultipro.com/services/BIDataService

   The Client Access Key is also known as the Customer API Key, and the User Access Key is also known as the User API Key. Both can be found under System Configuration > Web Services ton the Security tab. 

   Note: If you use an UltiPro Service Account, you will need the User API key from the Service Account administrative page and you must have appropriate permissions granted to the Service Account for the Reports-as-a-Service service. If you use an UltiPro Web User account, you will need the User API key from the Web Service administrative page.

7. Click Authenticate to connect to the API.

   Wait a few seconds for the authentication to finish. After a successful authentication, the Authenticate button changes to the Disconnect button and the page displays the Import details section and the Directory Attributes tab.

   

8. Select the report from which you want to import users from the drop-down list.

   This report also determines the UltiPro fields available to you to map to OneLogin attributes on the Directory Attributes tab.

9. Click Fetch Schema to retrieve the available UltiPro fields to sync with OneLogin.

   These fields will appear on the Directory Attributes tab when you click Save.

10. On the Directory Attributes tab, map the UltiPro fields you want to import to OneLogin.

    

    Select the Ultipro field from the dropdown in the Directory Field column for each required field.

    Click the + plus button at the top right to add rows, where you can map additional UltiPro fields to OneLogin fields. For any new mappings, you must create a OneLogin custom user field to hold the value you want to sync with the UltiPro field. All custom fields will be available for selection from the dropdown in the OneLogin Field column in rows that you add.

11. Click Save.

12. Click the More Actions menu and select Synchronize Users (Force) to initiate the user import.

    The directory connector also synchronizes users automatically every six hours.

13. Go to the Events tab to view when the user import has finished.