Okta Custom Attribute Mapping

Customer IT / SpaceIQ Onboarding Team

 

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

This article describes how to complete the custom attribute mapping for SiQ.

Note: This article is written against the Classic UI and for more information on custom attributes see the official documentation from Okta - Add custom attributes to an Okta user profile.

Contents

Prerequisites

You must have Okta administrator permissions in order to perform this custom attribute mapping. 

The Okta Integration needs to be completed first and the article Employee Attribute Mapping contains details of the variables.

Mapping Activities

Step 1. Define Attribute

From Okta, complete the following:

1. From the menu, click Applications. The Admin Dashboard (Classic UI) displays.

2. Click on your SiQ Application.

okta_atrribute_mapping1.png

3. Click the Provisioning tab.

4. In the left menu, make sure the To App is selected.

okta_atrribute_mapping2.png

5. Scroll down to the <SiQ app name> Attribute Mappings area.

okta_atrribute_mapping2a.png

6. Click the Go to Profile Editor button. The Profile Editor displays.

7. Click the + Add Attribute button. The Add Attribute dialog displays.

okta_atrribute_mapping3.png

8. Complete the following:

  • From the Data type drop-down, select string.
  • In the Display name field, enter a readable label for your attribute. For example, Badge Number, Title, etc.
  • In the External name field enter 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.
  • In the External namespace field, enter urn:ietf:params:scim:schemas:core:2.0:User.
  • In the Description field, enter the purpose and function of the attribute field.
  • For the Enum check box, leave this unchecked.
  • Optional - Set the attribute lengths and the attribute required check box.
  • Check the User personal check box.

9. Click the Save button.

Step 2. Map Attribute 

With the attribute defined, now you can map the attribute.

From the Profile Editor, complete the following:

1. Click on the Mappings button. The <SiQ app name> Profile Mappings.

okta_atrribute_mapping4.png

2. Make sure the <SiQ app name> to Okta User tab is selected.

You will see the <SiQ app name> attributes on the left and the Okta attributes on the right.

3. Scroll down until you find a newly added attribute that has the entry Choose an attribute or enter an expression in the drop-down. 

4. From the entry Choose an attribute or enter an expression drop-down, either select from the list or enter an expression.

5. Click the <SiQ app name> tab.

okta_atrribute_mapping5.png

6. Repeat steps 3 to 4.

7. Optional - If you want to see the mappings for an Okta User then in the Preview field enter the Okta User Name.

Note: Click the x to clear the user name.

okta_atrribute_mapping6.png

8. When you have finished the mappings, click the Save Mappings button.

9. Click Back to profiles.

 

Step 3. Apply Mapped Attributes

When attributes are defined and mapped you will need to take one additional step to force an immediate synchronization.

1. From the menu, click Applications > Applications. The Admin Dashboard displays.

2. Click on your SiQ Application.

3. Click the Provisioning tab.

4. In the left menu, make sure the To App is selected.

5. Scroll down to the <SiQ app name> Attribute Mappings area.

6. Click the Force Sync button to update all users.

okta_atrribute_mapping7.png

 

SiQ Data Drawer Example

When an attribute is mapped, it will display in the SiQ Floor Map's Data Drawer, for example:

In-SpaceIQ.jpg