User Guide for Workday HackerRank Configuration

Overview

This article discusses the configurations required to set up HackerRank and Workday integration.

The configuration guide is broadly divided into three sections.

1. Workday Security Configuration
2. Assessment Configuration in Workday
3. HackerRank Configuration

Workday Security Configuration

Login to your Workday account and follow the steps below to complete the security configuration for setting up the integration between Workday and HackerRank.

1. Access the Create Integration System User task and configure a Workday account for the integration.
   • Name the account “HackerRank_Integration_User.”
   • Keep the Session Timeout Minutes to the default value of zero to prevent session expiration. An expired session can cause the integration to stop before it completes.
   • Select the Do Not Allow UI Sessions checkbox. This option prevents the integration system user from signing in to Workday through the UI.

2. Create Integration System Security Groups (Unconstrained).
   • Access the Create Security Group task.
   • Choose Integration System Security Group (Unconstrained)
   • Name the Security Group “HackerRank_Integration_SG”

• • Click OK to save
  • On the Edit Integration System Security Group (Unconstrained) screen, Select the Integration System User account “User HackerRank_Integration_User” to include in the security group.

3. Edit Domain Security Policies.
   • Here are the Domain Security Policy Permissions required for the Security Group. 

Functional Area	Domain Security Policy	Domain Security Policies Inheriting Permission	Type of Permission	Operation
Recruiting	Candidate Data: Job Application	Candidate Data: Bundle Resumes	Integration Permission	Get Only
Recruiting	Candidate Data: Assessment Results		Integration Permission	Get and Put
Contact Information	Person Data: Work Contact Information	Person Data: Work Address Person Data: Work Instant Messenger Person Data: Work Phone Person Data: Work Web Address	Integration Permission	Get Only

 

• To grant the security group access to the domains required by your integration, follow these steps for each domain:
  • Access the View Domain report and find the domain.
  • As a related action on the domain, select Domain > Edit Security Policy Permissions.
  • Add the security group you created to the Integration Permissions and select Get and Put based on the table above.

4. Activate Pending Security Policy Changes.

• Access the Activate Pending Security Policy Changes task.
• Describe your changes in the Comment field.
• Select the Confirm checkbox to activate your changes.

5. If the ISU authenticates using the user name and password, access the Maintain Password Rules task. Add the integration system user to the System Users exempt from the password expiration field.

• To avoid integration errors caused by expired passwords, Workday recommends that you prevent Workday passwords from expiring.

IP Address Whitelisting (Optional)

You can add an extra layer of security by implementing an IP whitelist. The HackerRank service communicates to Workday from the following two IP addresses:

• 100.25.76.193
• 3.233.184.164

We suggest implementing in a sandbox or implementation environment first and testing completely end to end before introducing the static IP address restriction to simplify troubleshooting. 

Assessment Configuration in Workday

 This is a two-step process that involves

• Setup Assessment Status in Workday
• Setup HackerRank Assessment in Workday

Setup Assessment Status in Workday

In this step, you need to set up the assessment status on the workday. 

Assessment Status Name	Reference ID	Overall Status	Test Status
HackerRank Send Invite	HackerRank_Send_Invite	Yes
HackerRank Accepted	HackerRank_Accepted	Yes
HackerRank Declined	HackerRank_Declined	Yes
HackerRank Invited	HackerRank_Invited	Yes	Yes
HackerRank Completed - Qualified	HackerRank_Completed_Qualified		Yes
HackerRank Completed - Evaluation Required	HackerRank_Completed_Evaluation_Required		Yes
HackerRank Completed - Failed	HackerRank_Completed_Failed		Yes

Follow the below steps to set up the Assessment task.

1. Access the Maintain Assessment Statuses task 

2. Click on the Plus mark at the top to add a new Status

3. Give a name, then check the box for Overall Status or Test Status. Overall Status will refer to the integration working. Test statuses will be used to track the candidate’s performance on the test. 

4. Click on the OK button at the bottom of the page. 

5. After the page saves, Hover over the magnifying glass and click on the three dots for more options. Go to Integration IDs -> Edit Reference ID.

6. Set the Reference ID to match the value in the table above and then click on the OK button.

This is what the table should look like when you are done. Note the order, which will make it easier for recruiters to use.

 

Setup HackerRank Assessment in Workday

HackerRank customers can create their own custom tests, and the identifiers for these tests are unique for each customer. Therefore, any test names and test IDs must be added to Workday on a per-customer basis. This process is not something that can be automated, so it requires an implementer to add tests manually to Workday.

Steps:

1. Open a test in HackerRank
2. Note down the Name and Test ID from the HackerRank Test page and the page URL, respectively. In the example below, the Test ID is 454785, and the Test Name is “HackerRank Full-stack Developer Hiring Test.”  

3. Open Workday and access the Maintain Recruiting Assessment Tests task

4. Add a new Test. Set name to the Test Name

5. Chose Ok on the page

6. After the page saves, hover next to the magnifying glass and chose Integration IDs -> Edit reference ID

7. Set the Reference ID to the Test ID from HackerRank

Note: When building out and testing the integration for the first time, you can get the Name and Test ID from the HackerRank Test page and the page URL, as described above.

When the integration is ready, you can log into your HackerRank for Work account and do a one-time bulk export of all the tests that need to be entered into Workday.

Follow the below steps in your HackerRank account to bulk export the available tests.

• Click on the Settings button from the top left menu
• Select the ATS Integration option from the left panel
• Under Workday, click on the Configure button.
• Under the CodeScreen Integration setup section, click on download all published tests.

Note: You need to add all new tests that are created in HackerRank and need to be used in Workday manually. 

Business Process Configuration

This integration gets initiated from the Assess Candidate Business Process. This integration does not require any configuration that is different from the default.

Make sure you configure the Job Application business process to include assessment.

Configure Default Tests (Optional setup)

Follow the below steps to configure default tests in Workday.

Steps:

1. Access the Edit Job Requisition task.
2. Search for and open the Job Requisition.
3. Proceed to the Job section of the Job Requisition and scroll to the bottom of the page.
4. Click on the Edit icon in the Assessments section.
5. Add a test to the Default Assessment Tests selection box.

• When assigning an assessment to the candidate, the default test will show up by default in the list of assessment tests. The recruiter can change this before sending the test if the default is not right for the candidate.

Note: A default test cannot be added once the job is live and candidates are added to it.

HackerRank Configuration

The HackerRank side configuration involves the URL and authentication setup.

• Login to HackerRank with an account that has Company Admin permissions
• Click on the Settings option from the top left menu
• Select the ATS Integration option from the left panel
• Under Workday, click on the Configure button.
• Enter valid Workday user credentials and WSDL service URL in the URL and Authentication Setup section
• Click on Save and Test

Note:  Once the recruiter invites a candidate to take a test, HackerRank will not invite the candidate again to retake the same test or take a different test. If you want to change this setup and want your candidate to get another chance after a certain period of time, you may control the setting from the below option.

 

 

Once the configuration is completed, click on the Enable Integration button to enable the process.

This marks the end of the configuration process. After this, you will be able to invite candidates for HackerRank assessments from Workday and view their results.

You can check the Workday - HackerRank Test Integration: User Guide to know more about the workflow.