Skip to main content
System for Cross-domain Identity Management (SCIM) group provisioning lets you manage Connect AI access by syncing groups from your identity provider (IdP). Groups synced from your IdP are read-only in Connect AI. Create and update groups in your IdP, and SCIM keeps Connect AI in sync. Deleting a group in Connect AI does not delete it from your IdP. To delete a group entirely, delete it in your IdP.

Prerequisites

  • SSO must be configured on your Connect AI account.
  • SCIM Groups must be enabled on your account. Contact CData Support to enable SSO and SCIM groups.
  • Microsoft Entra ID license requirement (Entra ID only): Automated SCIM provisioning requires Microsoft Entra ID Premium P1 or P2 (included with Microsoft 365 E3/E5). Organizations on the Entra ID free tier cannot configure automated provisioning.
Connect AI supports SCIM group provisioning with the following identity providers:
  • Microsoft Entra ID
  • Okta Workforce Identity Cloud
  • Custom IdP (configured via SAML or OpenID Connect)
The following SCIM providers are not supported:
  • PingFederate
  • Google Workspace
  • Active Directory Federation Services (ADFS)
  • Active Directory/LDAP

Configure SCIM Group Provisioning in Your Identity Provider

You obtain the SCIM endpoint URL and Bearer token through a self-service session that CData Support starts for you. Review Obtaining Your SCIM or SSO Credentials before you open the self-service link. The steps below walk through the full SCIM groups configuration for Microsoft Entra ID and Okta Workforce Identity Cloud.
Connect AI does not appear in the Entra application gallery. You must create a new application from the gallery.
1
From the Microsoft Entra admin center, navigate to Enterprise apps > + New application. Click Create your own application, enter a name for the application (for example, Connect AI SCIM), select Integrate any other application you don’t find in the gallery (Non-gallery), and click Create.
2
In the navigation menu, under Manage, select Properties. Set Assignment required to Yes and click Save.
3
In the navigation menu, under Manage, select Users and groups. Assign the users and groups you want to provision to Connect AI. When you assign a group, the users from that group are provisioned automatically.
4
In the navigation menu, under Manage, select Provisioning and click Get started.
5
Set Provisioning Mode to Automatic.
6
Under Manage, select Connectivity and configure the following parameters:
  • Tenant URL–enter the SCIM endpoint URL from the self-service session and append ?aadOptscim062020 to the end of the URL. This is Microsoft’s recommended workaround for a known SCIM 2.0 issue. See Microsoft’s documentation for more information.
  • Secret Token–enter the Bearer token from the self-service session.
Click Test Connection.
7
Under Manage, select Provisioning, expand Mappings, and confirm that Provision Entra ID Groups is set to Enabled.
8
Under Manage, select Attribute Mapping, then select the Users tab. In the row containing mail and emails[type eq "work"].value, click the edit icon and configure the following:
  • Set Match objects using this attribute to Yes.
  • Set Matching precedence to 2.
Click Apply to save, then click Save on the Attribute Mapping page.
If users in your organization do not have the mail attribute populated in Entra ID, edit the same row and change Source attribute to userPrincipalName to ensure the email field is always populated during provisioning.
9
On the main Enterprise application page, select Provision on demand. Search for and select a user or group you assigned, then click Provision. Verify that the user or group appears in Connect AI.
10
Under Provisioning, set Provisioning Status to On to begin provisioning all assigned users and groups. After groups appear in Connect AI, assign roles to the group. See Access Role Assignments.

Obtaining Your SCIM or SSO Credentials

CData Support sends you a one-time self-service link. You use the link to receive the values that you enter in your identity provider (IdP), such as the SCIM Tenant URL, the SCIM Bearer token, and the SSO callback URL.
The link works only once. Opening it uses it up, even if you close the page without finishing. Open the link only when you are ready to complete the entire process in one sitting.
Complete the following before you open the link:
  • Obtain any internal IT approvals or change tickets that your organization requires to configure your IdP.
  • Confirm that you have administrator access to your IdP (for example, Microsoft Entra ID or Okta).
  • Confirm with CData Support whether the link is for SSO or SCIM before you open it.
  • Have a secure place ready, such as a password manager, to store the values you receive.
  • Share the link only with the administrator who will complete the process. Do not forward it to anyone who might open it first.

Time Limits

The link expires if you do not open it within a limited time after Support sends it. After you open it, the session ends after a limited time. If the link expires or the session ends before you finish, ask Support for a new link. Contact CData Support for a new link if:
  • The link expired or you opened it before you were ready.
  • You must rotate your SCIM Bearer token or your IdP client secret.
  • You lost the values you received.
  • You are configuring a new environment or IdP application.

SCIM Groups User Provisioning and Deprovisioning

When a user is added to a synced group in your IdP, Connect AI automatically provisions them. There is no need for the user to verify via email. The new user inherits the access roles assigned to that group. See Access Role Assignments for details on assigning access roles to groups. The new user is also assigned the Query system role. You change the system role later by editing the user in the Users tab.
Edit User page for a user provisioned through SCIM groups
When a user is removed from a synced group, they lose the access roles assigned to that group. If the user is a member of multiple synced groups, they retain access through their remaining group memberships. To fully deprovision a user, remove them from all synced groups in your IdP and then call DELETE /users/{id} from the Management API to revoke personal access tokens (PATs) and any direct role and permission grants. The user record is retained but the user can no longer sign in.

Access Role Assignments

After groups are synced, you assign Connect AI access roles to groups in the Groups tab of the Identities page:
Groups tab of the Identities page listing synced SCIM groups and their access roles
All current and future members of the group automatically receive the assigned roles. A group can hold multiple roles, and the same role can be assigned to multiple groups. When you remove a role assignment from a group, members who held that role solely through this group assignment immediately lose it. See Roles for details on system and access roles. The Connect AI Audit Log displays SCIM group provisioning, membership changes, and role assignment changes.

Frequently Asked Questions

Why is the Get Started button unavailable in the Entra Provisioning tab? The Get Started button is unavailable when you are viewing an SSO enterprise app that does not have a native Entra provisioning connector. This is expected for Connect AI. You must create a new application from the gallery. See Configure SCIM Group Provisioning in Your Identity Provider.
Last modified on October 29, 2026