Workday

Connect your Workday tenant to Opal

Opal's integration with Workday lets you leverage HRIS data as an additional source of truth for users, employee metadata, and their attributes IDP/HRIS Integration. The integration also allows you to manage access to entitlements such as Workday Security Groups and Roles.

Getting Started

To get started, go to the Apps page, click + at the top right, and click Workday. Then, click on the Workday tile.

2312

You will see a form to be completed. Since Workday configures permissions on the field level, the set up process will involve creating a Workday Integration System User and Workday Integration Security Group to ensure it has the necessary permissions. To connect your Workday tenant to Opal, please continue on to the below instructions.

Step 1 - In Workday, Create an Integration System User (ISU)

Navigate to the Workday Search bar, enter Create Integration System User, and select the corresponding Task

2312

In the Create Integration System User modal, enter the Account Information, including User Name, Password, and set the Session Timeout Minutes: 0 (recommended to prevent session expiry as it may lead to the integration timing out before completion)

2312

Step 2 - In Workday, Create a Security Group and assign it an Integration System User

Navigate to the Workday Search bar, enter Create Security Group, and select the corresponding Task

2312

In the Create Security Group modal, for the Type of Tenanted Security Group, select Integration System Security Group (Unconstrained) and enter a Name to represent the ISU.

2312

Once created, Edit the Security Group to associate it with the Integration System User you created in Step 1.

2312

Step 3 - In Workday, Configure Domain Security Policy Permissions

Navigate to the Workday Search bar, enter Maintain Permissions for Security Group, and select the corresponding Task

2312

In the task modal, first set the Operation to Maintain and set the Source Security Group to the Security Group you created in Step 2.

2312

Then, edit the Domain Security Policy Permissions and add the following GET ONLY operations:

View/Modify AccessDomain Security Policy
GET ONLYPerson Data: Work Contact Information
GET ONLYWorker Data: Current Staffing Information
GET ONLYWorker Data: Organization Information
GET ONLYWorker Data: Workers
GET ONLYWorker Data: All Positions
GET ONLYWorker Data: Worker ID
GET ONLYWorker Data: Active and Terminated Workers
GET ONLYWorker Data: Public Worker Reports
GET ONLYWorker Data: Employment Data
GET ONLYWorkday Accounts
GET ONLYIntegration Build

In Workday, you can add each by clicking on the + button on the top left of the table, for example:

2312

Step 4 - In Workday, Activate Security Policy Changes

Navigate to the Workday Search bar, enter Activate Pending Security Policy Changes, and select the corresponding Task.

2312

Review and check the Confirm box to activate the Security Policy Changes

2312

Step 5 - In Workday, Manage Authentication Policies

Navigate to the Workday Search bar, enter Manage Authentication Policies, and select the corresponding Report.

2312

Depending on your policy set up, you can choose to edit an existing policy or create a new one.

To create a new one, select Add Authentication Policy on the page.

  • Then, select from the dropdown the corresponding Environment you would like the policy to apply to.
  • In the table below, add an Authentication Ruleset by selecting the + button on the top left.
  • Provide an Authentication Rule Name, set the Security Group to the one you created in Step 2.
  • For the Authentication Conditions, select Any
  • For Allowed Authentication Types, select User Name Password
2312

Step 6 - In Workday, Activate All Pending Authentication Policy Changes

Navigate to the Workday Search bar, enter Activate All Pending Authentication Policy Changes, and select the corresponding Task.

2312

Add any comments, review, and check the Confirm box to activate the Authentication Policy Changes

2312

Step 7 - In Workday, Obtain the Web Services Endpoint for tenant

Navigate to the Workday Search bar, enter Public Web Services, and select the corresponding Report.

2312

In the table, locate the Human Resources (Public) Web Service, hover over it and click on the ... to the right of the text. Under Web Service, select View WSDL. This will open another page in the browser.

2312

In the new page containing the document tree, you can use Cmd + F / Ctrl + F to find /service, and you should see a URL address that looks like the following:

2312

The corresponding highlighted URL segment up to the /service path will be your Workday Web Services Endpoint. Note that each tenant may have a different endpoint, so a new endpoint would need to be created for each environment you would like to connect. The text directly after /service should represent your Workday Tenant Name. As an example, if your Workday log in URL is https://impl.workday.com/HelloWorld, your Workday Tenant Name would be HelloWorld.

Step 8 - Complete the Opal Form to Connect Workday

In Opal, enter the details based on the Workday items you configured in the previous steps:

  • Workday Integration System User username (Step 1)
  • Workday Integration System User password (Step 1)
  • Workday tenant URL subdomain (Step 7)
  • Workday Tenant Name
2312

Once all the information has been correctly filled out, click Create, and your connection should be set up and running!


What’s Next

Check out how to use Workday as an IDP/HRIS integration