The SCIM integration allows you to import and update users from Bob into Okta.

Okta will pull Employee, Department, Site and simple list data (e.g. country) into Okta as 'groups' that can be used to create rules in OKTA.

This article provides you with instructions on how to add more fields beyond those listed in the OKTA SCIM integration set up article.

Step 1: Retrieving information from Bob.

  1. From the left menu, select Settings > Integrations.
  2. Select Provisioning.
  3. In the Okta tile, click Manage.
  4. Scroll down to Data mapping.

All of the fields in the table are according to the service user permissions. 

Step 2: Pulling the data from Bob.

In this step you'll create the Bob fields in Okta so that you can later associate them with the custom Okta fields.

In Okta:

  1. Navigate to Directory > Profile editor > bob application > profile > Add attribute.

  2. Input the external name given by Hibob (e.g. managerID) in the External Name field.

  3. Input the following in the External namespace field: urn:ietf:params:scim:schemas:core:2.0:User

  4. Click Save.

Note: If you have multiple fields to add, you can click Save and Add Another and repeat this step and save once you've inputted all of the Bob fields.


Step 3: Creating the custom fields in Okta.

  1. Return to to the Profile editor, then click Okta on the left bar and click Profile.

  2. Input the name that you'd like to see in the following:

    • Display name: this is what will appear on the Okta interface, e.g. mangerId

    • Variable name: this is a backend name for your reference

  3. Click Save.

Note: Again, if you have multiple fields to add, you can click Save and Add Another and repeat this step and save once you're done.

You now have your new fields in Okta.


Step 4: Mapping the fields in Okta

  1. Go back to the Profile Editor, then click bob application > Mapping > Bob to Okta.

  2. Add the mapping between the fields that were created in steps 2 and 3, the left side being the bob fields and the Okta custom fields on the right.

  3. Click Save Mappings.