SCIM-based role management

DX supports managing user roles through SCIM when your identity provider is supported by WorkOS and supports Directory Sync for users and groups.

  • When SCIM-based role management is enabled, you cannot manage roles in the DX UI.
  • This capability is provided through WorkOS.
  • Before setup, confirm your provider is listed in WorkOS integrations and supports SCIM/Directory Sync.

Setup instructions

Step 1: Enable SCIM in DX

Contact DX support to enable the SCIM Directory Sync feature for your account.

Step 2: Configure SCIM

  1. Once Directory Sync is enabled, go to the DX admin area and browse Directory Sync.
  2. Go to the WorkOS portal to connect your IdP and select the groups you want to sync with DX.
  3. In DX, click on the ellipsis menu to select the role you want to map to each IdP group.