Okta Custom Attribute Mapping

This article outlines the steps required to configure custom attributes provisioning for SiQ and refer to our article on Provisioning Okta for more initial setup information of your Okta integration.

As shown in the Okta Universal Directory (UD) Profile Editor, the base profile that Okta imports from SiQ consists of 20+ attributes. Some of these attributes are mapped to the Okta user profile by default. Others must be first created for the Okta user as custom attributes, then mapped manually. The recommended mappings from SiQ to Okta were preconfigured in SiQ's base profile.

Do note that you must have Okta administrator permissions in order to perform this custom attribute mapping. This support article shows the Classic UI.

Okta's SiQ application has been enhanced to support user-defined custom attributes, enabling Okta to import more than 20 attributes to SiQ . These attributes must be created and mapped manually by an end user.



Define Attribute

Begin by defining your attribute(s). When logged into Okta as an admin, navigate to Applications [1], then either search for SpaceIQ [2] or click on the SpaceIQ app directly in the list [3]:




Inside the SpaceIQ Okta Application, click on the Provisioning tab [1] and make sure To App is selected [2]. Scroll way down until you see the SpaceIQ Attribute Mappings section [3]. Within that section is a Go to Profile Editor button [4] you should click on:


In the Profile Editor, click on Add Attribute [1]Fill in the form with these Attributes:

  • Data type [2] - Select string.
  • Display Name [3] - Enter in a readable label for your attribute. For example, Badge Number, Title, etc.
  • External Name [4] -  The name of the attribute in the IdP assertion or Profile API such as SAML attribute name. Separate words with an underscore rather than spaces. For example: starte_date, badge_number, etc.
  • External namespace [5] - Enter urn:ietf:params:scim:schemas:core:2.0:User.
  • Description [6] - Describe the purpose and function of the attribute field in your own words.
  • Scope [7] - Check the User personal option.

Leave Enum unchecked, and optionally set attribute value lengths and also optionally flag the attribute as required. Click Save [8] when done:



Map Attribute 

With the attribute defined, you can proceed to mapping. Navigate to the Profile Editor as described above, and this time click on Mappings instead of Add Attribute:


On the mapping screen, make sure the SpaceIQ to Okta option is selected [1]. You should see the SpaceIQ attributes on the left, and Okta attributes on the right. Scroll down until you find a newly added attribute that has the text "Choose an attribute or enter an expression" in the field [2]. You can begin typing into that field to filter your mapping options, or click on the drop down arrow [3] to expand the menu with all the available mapping options. Make your selection:



Then click on Okta to SpaceIQ [1] and repeat the process described above, looking for anything you may have missed. You can also type in the name of an Okta user here [2] to preview their particular mappings. When you are all done, click on Save mappings [3]:



Apply Mapped Attributes

Once attributes are defined and mapped you will need to take one additional step to force an immediate synchronization. As described above, go back to the Applications > SpaceIQ > Provisioning tab  and scroll down to the SiQ Attribute Mappings section [1]. Click on the Force Sync button [2] to update all users:



When an attribute is mapped, it will appear in the SiQ platform in the right drawer:




0 out of 0 found this helpful
Have more questions? Submit a request