Get instant support with our search!
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
- Navigate to Applications > Applications > Browse App Catalogue > Search for MetaCompliance > Add Integration
- Enter the following:
- Region code
-
Company key
Paste the company key provided.
- Click Done
Step 2: Enable Provisioning Features
In Okta:
- Go to the Provisioning tab > To App.
- Click Edit under the 'Provisioning to App' section.
- Ensure the following boxes are checked:
- ✔️ Create Users
- ✔️ Update User Attributes
- ✔️ Deactivate Users
- 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:
- Go to your app's 'Assignments' tab.
- Click Assign > Assign to People.
- Select a user and click Assign > Done.
To assign groups:
- Go to Assignments > Assign to Groups.
- 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