Overview
HackerRank integrates with Oracle Recruiting Cloud (ORC) for Tests and Interviews to facilitate an easy and seamless hiring experience. The purpose of this document is to provide a step-by-step guide for setting up the Oracle Recruiting Cloud (ORC) - HackerRank Integration.
Key Features
- Send Test invites to candidates from ORC through your Candidate Selection Process.
- View candidate’s Test results in ORC including score and evaluator feedback.
- Have a direct link to a candidate’s Test report from ORC.
- Include Tests in your ORC job application flow - you can choose if candidates take this Inline (while applying to the job) or at the end of the job application.
- Generate HackerRank Interview links for Virtual & Remote Onsite Interviews with candidates.
- View Interview results and scorecard information from interviewers.
- Have a direct link to the candidate’s interview report from ORC.
We recommend setting up the integration in a sandbox ORC and HackerRank instance before implementing it in your production environment.
Prerequisites
User has Company Administrator access on HackerRank
Recruiting Administrator role (ORA_PER_RECRUITING_ADMINISTRATOR_JOB) on ORC
Integration Setup
- Log in to HackerRank with an Administrator license.
- Navigate to Settings>Integrations>Oracle Recruiting Cloud.
- Download the Integration ZIP file in Step 1 of the page.
- The HackerRank Integration configuration file contains information on the integration entered by HackerRank while building the integration. This includes API Tokens, Endpoints, and so on that are used by the ORC to identify the integration partner. When you upload this .ZIP file to ORC (2 steps later), the integration triggers will be stored in your ORC instance.
- Log in to ORC with a Recruiting Administrator Role (or higher).
- Import the HackerRank Integration Configuration ZIP file.
- Based on the instructions from the ORC team, here are guidelines from the ORC team to help you import the file into your ORC instance:
- Partner Enablement: Partner enablement consists of contacting the partner to obtain the implementation project .zip file and import it into Oracle HCM Cloud.
- You must have the Application Implementation Administrator role (ORA_ASM_APPLICATION_IMPLEMENTATION_ADMIN_ABSTRACT) and Recruiting Administrator (ORA_PER_RECRUITING_ADMINISTRATOR_JOB) are required to import the file provided by the partner.
-
In the Setup and Maintenance work area, click the Tasks icon and select the Manage Configuration Packages task.
-
In the Manage Configuration Packages page, in the Search Results section, click Upload.
Select the implementation project .zip file provided by the partner. -
Click Get Details to verify that the selected file is correct. If needed, click Update to select a different file and click on Submit.
-
When the warning message appears, click Yes. The upload process starts. Once the upload is done, the status changes to Completed successfully. Click the Refresh icon to update the status.
-
Once the upload is done, you must import setup data.
-
Select the row where Upload - Completed Successfully appears and click the Import Setup Data button.
-
If needed, click the Refresh icon to update the status.
-
Once the import is done, the status changes to Completed successfully.
-
The partner is now provisioned. If you go to the Recruiting Category Enablement task and Recruiting Category Provisioning and Configuration task, you can see that the status of the partner is set to Provisioned.
- For any questions related to the above guidelines from the ORC team, please contact the ORC team directly.
- Create an API User for HackerRank on ORC.
-
Here are guidelines from the ORC team to help you create an API User in your ORC instance:
-
Provide User Account Credentials: The Administrator provides the user account credentials to the partner for data synchronization. The partner uses this user account for authentication with HCM when updating the data.
-
A separate account is required for the testing environment and the production environment.
-
The following privileges are required:
-
For ASM: Use REST Service–Candidate Assessments
-
-
For any questions related to the above guidelines from the ORC team, please contact the ORC team directly.
-
Once this is done, you will have an API User Name and Password. Store this safely.
-
Optional:
-
We also support the addition of IP Whitelisting for an extra layer of security. This ensures that only requests coming from HackerRank’s servers make it through to your ORC instance.
-
If your API User Name and Password are compromised, this logic will block requests generated from servers outside HackerRank.
-
Reach out to your HackerRank contact or support@hackerrank.com and we will share our ORC Integration IPs with you.
-
-
- Copy and store your ORC Base URL:
-
Your ORC Base URL is the domain of your company’s ORC instance. \
-
We require this to be able to post data back to your ORC instance. We use this in addition to the API Users previously generated.
-
The API User Name and Password tells ORC that we’re a trusted partner trying to post data to your ORC instance.
-
Here’s how the ORC Base URL would look like: https://www.yourcompany.oraclecloud.com
-
Here’s a sample URL: https://eyte-dev12.fa.us2.oraclecloud.com/
-
- Generate OAuth Tokens from HackerRank:
-
For this integration, HackerRank uses OAuth 2.0 to authenticate incoming API requests.
-
For each customer, we have 3 unique tokens that need to be entered in ORC. Once we validate these 3 tokens, we generate a temporary access token that is used by ORC until it expires.
-
Once it expires, ORC has to send us the 3 tokens again for us to validate. This way any token compromised can’t be used for a time longer than 1000 seconds (16 mins 40 secs).
-
Click on Generate OAuth Tokens. You will get 3 tokens: Reference Key, Client ID, and Client Secret.
- Copy each token and store it safely. Once you close the modal, your tokens will be encrypted and you will not be able to see them again.
- If you misplace the token and cannot find it to be entered in ORC, you can come back and regenerate tokens from HackerRank. One thing to remember is that if your integration is active with any old tokens, it will stop working if you delete these tokens from HackerRank.
-
- Find the HackerRank Integration Provisioning page in ORC:
- In ORC, you need to enter all the OAuth tokens and activate the integration.
- You need to get to the HackerRank Integration setup page. Follow these steps to get there:
- Go to Setup and Maintenance.
- Click Recruiting and Candidate Experience.
- Click on Recruiting and Candidate Experience Management then go to RecruitingCategory Provisioning and Configuration.
- In the Integration Categories under Assessment Partners, you should see HackerRank. Click on the Edit (pencil) icon placed at the right end.
- You will land on the HackerRank Integration page.
- Enter Integration Details in ORC:
-
Once you get to the Integration Provisioning page, enter the 3 tokens generated from HackerRank: Reference Key, Client ID, and Client Secret.
-
At this point, you will also be able to set up the Validity and Validity Period:
-
Share Results Across Job Applications - If this is checked, we will use candidates’ test results across job applications if they were invited for the same test.
-
For example: If a candidate takes a test for Req A and then applies to Req B where you have the same test set up, we will not ask the candidate to take the test again. Instead, we will use their results from the previous attempt (for Req A).
-
Validity Period in Days - For the Validity logic of sharing test results across requisitions, this defines the number of days a test result is valid.
-
For example: If this is set as 30 days, and the candidate applies to Req B 40 days after taking the test. Then we will ask the candidate to take the test again.
-
We typically see our customers use a 6-month (180-day) validity logic. Meaning that they consider that a candidate may improve their skills in a 6-month period to make it worth their time to take the test again.
-
-
- Assign User Account in ORC:
- On the integration page, click on + Assign User Account. This will trigger a modal that will ask you for information on the user.
- This is the API User to which all HackerRank Tests and interviews will be tied.
In the modal, enter the User Name as ORC_HACKERRANK_USER (Use all caps and no spaces). - You can use any description. We recommend “User with all Tests and Interviews”. Then click OK.
- Once you click on OK, ORC sends us this User Name and initiates the first API call made from ORC to HackerRank.
- At this stage, ORC asks HackerRank for a list of all tests and interviews accessible to your company. We respond with 5 Interviews and up to 494 of your most recent Tests. (That makes it a total of 499 since ORC does not accept more than 499 packages for an integration).
If you are able to see the list of tests shown in Screening Packages, then the integration was successful. - If you are unable to see the tests or if ORC returns an invalid User Name error, check if you entered the “ORC_HACKERRANK_USER” as is without spaces or quotes.
- This is an example of what you will see if this step was successful:
- Once you see this, one final step on this page is to click on the Activate button at the top next to Save. Now, your Oracle configuration is completed.
- Assign Additional User Accounts in Oracle Recruiting:
- HackerRank supports adding more than one user account on Oracle. In the previous step, you added "ORC_HACKERRANK_USER" which is a user account that pulls in all the available HackerRank tests from your HackerRank account.
- HackerRank, now, supports adding individual users as user accounts on Oracle Recruiting. You can follow the same steps in Oracle by clicking on +Assign User Account and entering the users' email IDs.
- Note that these email IDs need to match with a valid HackerRank license.
- By adding individual accounts, only the tests that the provided email ID has access to will be pulled into Oracle. Thus making it easier for users to select a test that is most relevant to them and avoiding scrolling through a list of tests for roles and regions that they are not a part of.
This feature supports recruiters across teams and geographies to use the HackerRank - Oracle Recruiting integration effectively. - All the added user accounts will show up on the integration settings page in HackerRank.
- Note that if you want to delete these additional user accounts, you could do so from the integration settings page in HackerRank.
- Enter API User Details and ORC Base URL in HackerRank:
- Open HackerRank ORC Integration Settings Page.
- On the page, in Step 5. a. Enter the User Name and Password you previously generated from ORC.
- On the page, in Step 5. b. Enter the ORC Base URL.
- Make sure you press Test and Save. This will validate the credentials you entered. If the credentials are correct, you will see a success message on the screen and your details will be saved.
Now, your integration is successful and activated. You and users in your organization will be able to use HackerRank from within ORC.