SCIM - Okta Configuration Instructions (Pre-release version)

Disclaimer: This integration with Okta is currently under development and is not available to customers yet.

Introduction

This guide explains how to configure SCIM-based user provisioning between Okta and MetaCompliance. With SCIM integration, Okta can automatically create, update, and deactivate users in MetaCompliance.

Note: This guide does not cover Single Sign-On (SSO). SSO is managed separately and not enabled within this application.

 

Supported Features

The following provisioning features are supported:

  • Create Users
  • Update User Attributes
  • Deactivate Users
  • Import Users
  • Import Groups

 

Requirements

To enable provisioning, you'll need:

  • A valid API Token
  • Your assigned Company Key
  • Your regional Environment Code (see table below)

Region Codes

When configuring the integration, you must enter the region code matching your MetaCompliance tenant. Use the table below:

Region Region Code
Ireland ire
United States us
Netherlands nl
United Kingdom uk
Canada ca

If you're unsure of your credentials or region, please contact MetaCompliance Support - support@metacompliance.com


How to Configure

Step 1: Getting Started & App Settings

  1. Navigate to Applications > Applications > Browse App Catalogue > Search for MetaCompliance > Add Integration
  2. Enter the following:
    • Region code
    • Company key
      Paste the company key provided.
  3. Click Done

 Step 2: Enable Provisioning Features

In Okta:

  1. Go to the Provisioning tab > To App.
  2. Click Edit under the 'Provisioning to App' section.
  3. Ensure the following boxes are checked:
    • ✔️ Create Users
    • ✔️ Update User Attributes
    • ✔️ Deactivate Users
  4. Save the configuration.

5. Navigate to Integration > Edit.

  • Enter API Token.
  • Check Import Groups.
  • Click Test API Credentials, and a success notice will appear. (Contact MetaCompliance Support Team if it fails.)

6. Click Save


Step 3: Assign Users and Groups

You can assign users or groups from the 'Assignments' tab.

To assign individual users:

  1. Go to your app's 'Assignments' tab.
  2. Click Assign > Assign to People.
  3. Select a user and click Assign > Done.

To assign groups:

  1. Go to Assignments > Assign to Groups.
  2. Choose your group and click Assign > Done.


Supported Attributes

MetaCompliance supports a defined set of SCIM attributes that can be found within the Provisioning tab > MetaCompliance Attribute Mappings; the below attributes are required.

The attributes below are optional. If you do not want the particular attributes to sync into MetaCompliance, you can remove them by clicking on the X.


Known Issues

  • Assigning users without required attributes will fail.
  • Incorrect region codes will prevent API credential verification.

Troubleshooting

Issue Solution
"Invalid Credentials" error Ensure API token and region code are correct.
Users not being provisioned Confirm the provisioning features are enabled.
Users show as "Pending" in Okta Check for missing required fields.
App not visible in Okta catalogue Create the app manually using SCIM template.

Contact & Support

Need help? Reach out to:

  • MetaCompliance Support: support@metacompliance.com
Back to all articles