Configure provisioning for Cornerstone OnDemand
This guide provides the steps required to configure provisioning for Cornerstone OnDemand. It assumes that you've created a Cornerstone OnDemand app instance in your Okta org.
Contents
Features
The following provisioning features are supported:
- Push new users
Users created through Okta are also created in CornerStone OnDemand.
- Push user deactivation
Deactivating the user or disabling the user's access to the app through Okta also deactivates the user in CornerStone OnDemand.
- Push profile update
Updates made to the user's profile through Okta are also pushed to CornerStone OnDemand.
- Reactivate users
User accounts can be reactivated in CornerStone OnDemand.
Requirements
Before you can enable Provisioning Features, you will need the following:
Register an app in Cornerstone OnDemand
- Sign in to your Cornerstone account.
- Go to Admin > Tools > EDGE & API Management > Manage OAuth 2.0 Applications.
- Click + Register New Application.
- Enter your Application Name (for example, OktaCornerStoneIntegration).
- Enter a Cornerstone User ID as the User ID. Often this is the admin's User ID.
- Optional. Set the Access Token Validity Period.
- Search for and select the following API scopes:
- employee.create
- employee.read
- employee.updatefull
- employee.updatepartial
- ou.read
- outype.read
- Click Register Application.
- Copy your client secret. You enter this value when you set up provisioning for Cornerstone OnDemand in Okta.
- Click Continue.
- Copy the Client ID for your app. You enter this value when you set up provisioning for Cornerstone OnDemand in Okta.
Configuration steps
Do the following after creating your Cornerstone OnDemand app integration in Okta:
- In the Admin Console, go to Applications > Applications.
- Open your Cornerstone OnDemand app instance.
- Go to the Provisioning tab and click Configure API Integration.
- Select Enable API integration.
- Enter your OAuth Client Id and OAuth Client Secret that you copied from Cornerstone when registering your app.
- Optional. Validate your credentials by clicking Test API Credentials. If your credentials are valid, you’ll see a message saying that your credentials were successfully verified.
- Click Save.
- Select the provisioning options to enable and then click Save.
Cornerstone External ID
Cornerstone External ID is a required field in Cornerstone.
If you don't add this attribute to your Cornerstone OnDemand App User profile, it's automatically set to the Okta username.
If you choose to add the attribute to your Cornerstone OnDemand App User profile, then you must perform the following steps:
- Go to the Provisioning tab and click Go to Profile Editor.
- Click Mappings.
- Switch to the Okta User to Cornerstone OnDemand tab.
- Enter a mapping for
cornerstoneExternalId
- Click Save Mappings.
Group and user assignment
- Go to the Assignments tab.
- Choose to Assign to People or Assign to Groups from the Assign dropdown menu.
- Locate the user or group to assign Cornerstone OnDemand to, and click Assign.
- Choose a Division from the dropdown list.
- Click Save and Go Back.
Schema discovery
This feature allows you to extend the Cornerstone OnDemand App User profile with additional attributes using the Profile Editor and then sync them with Cornerstone OnDemand.
The following extended attributes are supported:
- Middle Name
- Name Prefix
- Name Suffix
- Phone Work
- Phone Fax
- Phone Mobile
- Address Line 1
- Address Line 2
- Address Mail Stop
- Address City
- Address State
- Address Postal Code
- Address Country Code
- Approver
- Manager
- Gender
- Ethnicity
- Message
- Absent
- Language
- Cost Center
- Employee Type
- Grade
- Location
- Position
Note: Okta usernames must be used when assigning values to the Approver and Manager attributes.
Note: Adding any of the following attributes to your Cornerstone OnDemand App User profile requires you to perform a few steps to sync values between the app and Okta:
- Cost Center
- Employee Type
- Grade
- Location
- Position
Perform the following steps to retrieve the values for any of the attributes in the preceding list:
- Go to the Provisioning tab and click Integration.
- Click Edit.
- Click Save.
- The attribute values are now available when assigning groups and users to Cornerstone OnDemand.