Skip to main content

Okta SCIM Integration Guide

BrightHire supports SCIM provisioning with the Okta platform.

Will Decker avatar
Written by Will Decker
Updated over 11 months ago

SCIM Integration

Supported Features

  • Create users

  • Update user attributes

  • Activate & deactivate users directly from the Okta dashboard

  • Import users

Requirements

  • To set up BrightHire user provisioning with Okta, you need to have access to the Okta Admin account

  • Make sure that SAML setup is done as per the instructions given in the SAML configuration guide located on the Sign On application tab in Okta

❗ Important Note

Creating users in Okta (with default settings) will provision a user account in BrightHire and email all users an invite to BrightHire. Most organizations DO NOT want invites to be sent when users are added before BrightHire training has occurred. Check with your internal project team or BrightHire CSM before creating users in Okta

More information on this setting can be found in Configuration Steps section

Configuration Steps

  • Add BrightHire to your Okta Admin

    • Select the Applications tab and then select Browse App Catalog and search for "BrightHire"

    Note: We are assuming that the SAML setup is already done as mentioned here

  • Before starting, make sure you select Email for the Application username format on the Sign On application tab in Okta
    ​

  • Once the app is added, click on the Provisioning tab

  • Click on the Configure API Integration button

  • Click on Enable API integration

  • Click "Test API Credentials" to check if the token is working as expected. Once that completes, click Save

Provisioning Users

Please ensure that the username and email for users remain the same during user assignments

❗ "Create Users" - Creating users in Okta (with default settings) will provision a user account in BrightHire and email all users an invite to BrightHire. Most organizations DO NOT want invites to be sent when users are added before BrightHire training has occurred. Check with your internal project team or BrightHire CSM before creating users in Okta

In the Okta Provisioning tab, click Edit under Provisioning to App:

  • OPTIONAL - Enable "Create Users" - See note

  • Enable "Update User Attributes"

  • Enable "Deactivate Users"

  • Click Save

  • Assign the app to a user you would like to give BrightHire access by using the Assign button on the top left

That should be it!

  • The assigned users should start seeing the BrightHire app in their Okta dashboard and clicking on it should take them to the BrightHire dashboard! Voila!

If you have questions, please reach out to support at [email protected]

Did this answer your question?