Setup SCIM Provisioning for Okta (OIN)

Learn how to automate user and group lifecycle management between Okta and Symbol Security using SCIM 2.0 via the official Okta Integration Network (OIN) application.

Prerequisites

Before configuring SCIM provisioning, ensure you have:

  • An active Okta tenant with Super Admin or Application Admin permissions.
  • A Symbol Security account with Company Admin or MSP/vCISO Partner Admin permissions.
  • The Symbol Security app already added to your Okta Admin Console from the Okta App Catalog (see Configure Okta Single Sign-On (SSO) for Symbol Security).

Supported Features

The Okta Symbol Security SCIM integration supports the following provisioning features:

  • Create Users: New users assigned to the Symbol Security app in Okta are automatically created in Symbol Security.
  • Update User Attributes: Changes made to a user’s profile in Okta (such as first name, last name, or email) are automatically pushed to Symbol Security.
  • Deactivate Users: Unassigning a user from the Symbol Security app or deactivating their account in Okta revokes their access and deactivates their profile in Symbol Security.
  • Push Groups: Okta groups and group memberships can be pushed to Symbol Security to organize learners for targeted phishing campaigns and training assignments.

Important Note on Existing Users (First-Time Sync): If you already have users in Symbol Security prior to enabling SCIM, ensure their email addresses in Okta match their existing Symbol Security accounts. When SCIM runs its initial sync, Okta will link matching email addresses rather than creating duplicate profiles.

Configuration Steps

Step 1: Generate a SCIM API Token in Symbol Security

  1. Sign in to the Symbol Security portal:

    • Single Company Admins: Click the menu icon in the top-right corner, select Settings, and navigate to the SCIM Provisioning section.
    • MSP/vCISO Partners: Navigate to the target Company Profile, open the Settings tab, and select SCIM Provisioning.
  2. Click Setup SCIM (if not already active).

  3. Copy the SCIM Base URL (if required by your OIN integration) and click Generate Token to create a new Bearer Token.

  4. Copy and store the Bearer Token securely—you will enter it into Okta in the next step.

Step 2: Enable API Integration in Okta

  1. Sign in to your Okta Admin Console.
  2. Go to Applications > Applications and open your Symbol Security application.
  3. Select the Provisioning tab and click Configure API Integration.
  4. Check the Enable API integration box.
  5. Enter the API Token (Bearer Token) copied from Symbol Security in Step 1 (and the SCIM Base URL, if prompted).
  6. Click Test API Credentials to confirm Okta can connect to Symbol Security. Once you see the verification success message, click Save.

Step 3: Enable Provisioning Actions in Okta

  1. While still on the Provisioning tab of your Symbol Security app in Okta, select To App under the Settings menu on the left.

  2. Click Edit and enable the following options:

    • Create Users
    • Update User Attributes
    • Deactivate Users
  3. Click Save.

Step 4: Assign Users and Push Groups

  1. Assign Users:

    • Navigate to the Assignments tab in Okta.
    • Click Assign and select Assign to People or Assign to Groups.
    • Select the users or groups you want to provision into Symbol Security, click Assign, and click Done.
  2. Push Groups (Optional):

    • Navigate to the Push Groups tab in Okta.
    • Click Push Groups and select Find groups by name or Find groups by rule.
    • Choose the Okta groups you want to sync as user groups in Symbol Security and click Save.

Troubleshooting & Support

  • Authentication Errors: If Test API Credentials fails, verify that your Bearer Token in Symbol Security has not expired or been revoked, and ensure there are no leading/trailing spaces when pasting it into Okta.
  • Sync Failures: Check the System Log in Okta (Reports > System Log) or the SCIM Logs tab inside Symbol Security for detailed error responses.
  • Need help? Contact Symbol Security Support at [email protected].