SCIM is an open standard that works alongside SSO to allow you to create, update and deactivate users in Greenhouse more efficiently.
Updates made via SCIM will be instantaneous. Provisioning with SCIM allows syncing to happen immediately in Greenhouse as soon as a user is assigned to the Greenhouse Recruiting application in Okta.
Configure Okta SSO
Before configuring SCIM, you need to configure Okta SSO in Greenhouse Recruiting.
Make sure your SSO is status is set to Configured.
Configure SCIM for Okta
Copy the base URL and token in Greenhouse Recruiting
Go to the SCIM Configuration page. (Configure icon > Dev Center > SCIM Configuration)
Click the toggle next to Enable SCIM for Okta.
Paste the base URL and token in Okta
Open another tab in your browser and log in to your Okta account.
Go to the Greenhouse Recruiting app. Keep this tab open as you navigate between Okta and Greenhouse Recruiting.
In Greenhouse Recruiting, copy the link from the Base URL box by clicking Copy.
Go to the Provisioning page in Okta, then click Integration. Paste the URL in the SCIM 2.0 Base URL field in Okta.
Go back to Greenhouse Recruiting. In the SCIM token section, click Generate token. Then, click Copy.
Go to the Okta Integration page. Paste the token in the OAuth Bearer Token field.
Click Test API Credentials, then click Save.
Map attributes between Greenhouse Recruiting and Okta
Attribute mapping allows you to sync fields in your Okta account with fields in your Greenhouse Recruiting account.
A variable is a unique identifier assigned to an attribute. Every user attribute in Okta and Greenhouse Recruiting has an associated variable.
To start the attribute mapping process, follow the steps below to create attributes in Okta.
Okta profile editor
Go to the Profile Editor in Okta, then click on the profile labeled User (default).
Make sure your attributes include the following:
|Display name||Variable name||Data type||Attribute type|
Greenhouse Recruiting profile editor
Go to the Profile Editor in Okta, then click on the profile labeled Greenhouse Recruiting.
Click the + Add Attribute button.
Create the following attributes:
|Variable name||Data type||External namespace|
When you finish creating an attribute, click Save or Save and Add Another.
After you finish adding your attributes, click Mappings on the Profile Editor.
Select one of the following tabs at the top of the window:
- Greenhouse Recruiting User profile to Okta User Profile: This option maps attributes from Greenhouse Recruiting to Okta
- Okta User to Greenhouse Recruiting User: This option maps attributes from Okta to Greenhouse Recruiting
Set up the mappings as shown below by selecting an option from each dropdown.
When you finish, click Save Mappings.