Blink/Okta: Set Up Guide for SCIM

Establish the SCIM for your Blink Organization to automatically provision users.

Updated over a week ago

Setting up SCIM for your Blink Organization will allow for you to automatically provision users. This means that users profile fields will be synced over and updated.
​All information is fed into Blink. Changes to any profile cannot be done in Blink, only within Okta.

To start this process, you need a secret token. This can be acquired by reaching out to support@joinblink.com. This will be generated and sent back to you within the same week this is requested.

In this article:

Supported/Unsupported Features

What Features are supported with this:

  • Create an Okta User in Blink

  • Update an Okta User in Blink

  • Disable an Okta User in Blink

Currently, Blink does not support the following Okta provisioning features, but we might do in the future:

  • Pushing Users from Blink to Okta

  • Pushing Groups from Okta to Blink

Configuration Steps

Step 1: Adding the Blink Application to your Okta Applications

  1. Login to Okta, go to your Applications and click Browse App Catalog

  2. Search for Blink, select the app and click Add Integration

  3. On the General Settings screen, change the Application Label should you wish to (default to “Blink”)

  4. Decide on the Application Visibility to your users (default visibility is hidden from users on Web and Mobile but you can change this by ticking either or both checkboxes)

  5. Once finished, click Done

Step 2: Configure API Integration

  1. Click the Provisioning Tab and then click Configure API Integration

  2. Tick the Enable API Integration checkbox

  3. Enter the API token provided by Blink in the API Token field

  4. Click Test API Credentials

  5. If the test is successful click Save. If not contact support@joinblink.com.

Step 3: Configure the Provisioning Settings "To App"

  1. Click the Provisioning Tab and in the Settings panel, select To App.

  2. Then click Edit and tick the Create Users, Update User Attributes and Deactivate Users “Enable” checkboxes. Click Save to save your changes.

Step 4: Choose your Okta to Blink mappings

  1. Click on the Provisioning tab ang scroll down to the Blink Attributes Mappings section

  2. In this section, in the Attribute column, you will find the Blink attributes available to map from Okta. The Value column shows which Okta value is currently mapped to the corresponding Blink attribute.

  3. The app comes with the default above mappings, but you can update these according to your needs or choose to not map certain attributes at all.

  4. To update a mapping click the pencil icon against the attribute you wish to modify

    1. On next screen, against Attribute Value select an attribute type from the dropdown menu:

      1. Same value for all users: with this option you can choose to hardcode the same value for all users. If you select it, enter the hardcoded value you wish to apply in the text box per the below

      2. Map from Okta Profile: this option allows you to directly map an Okta Profile attribute to the Blink attribute. If you pick this option, select the desired Okta field from the dropdown menu

      3. Expression: this option is useful if you wish to add some logic or manipulate an Okta attribute before sending it over to Blink. If you pick this option a text field will appear for you to write your expression. Please refer to the Expression Language Reference from Okta for more details on how to write expressions.

    2. The Apply on radio buttons prompt you to choose whether you wish this attribute to be updated in Blink only when the user is created the first time (Create option) or if you wish all future updates to this field are synced to Blink (Create and update option). We recommend Create and update to ensure both Okta and Blink user profiles are in sync at all times.

    3. Once all done, you can check you are happy with the value you selected for your Blink attribute by typing one of your users’ name in the preview box. The output value will show in the green section. Once happy click Save.

  5. To delete a mapping and choose to not map a particular Blink attribute at all, click the cross icon against the relevant attribute. On the following screen, click OK

    1. Once done, the attribute will show as Not mapped as per the below

    2. To start mapping this attribute again, click on icon pencil and follow instructions described above in 4.

Step 5: Assign Workers or Groups to the Blink Application

  1. This step will assign users or groups to the application, so they start being provisioned into Blink

  2. Please refer to this GUIDE to assign individuals or groups to the Blink app

  3. Users assigned should now start being provisioned into Blink

FAQs

What does this integration not support?

  • Pushing Users from Blink to Okta

  • Pushing Groups from Okta to Blink

This may be supported in the future.

Why is something going wrong?

If you are having any issues with this please do reach out to support@joinblink.com.

Did this answer your question?