WorkOS Docs Homepage
Integrations

JumpCloud SCIM

Learn about syncing your user list with JumpCloud SCIM.

This guide outlines how to synchronize your application’s JumpCloud directories using SCIM v2.0.

To synchronize an Enterprise’s users and groups provisioned for your application, you’ll need to provide the Enterprise with two pieces of information:

  • An Endpoint that JumpCloud will make requests to.
  • A Bearer Token for JumpCloud to authenticate its endpoint requests.

Both of these are available in your Endpoint’s Settings in the WorkOS Dashboard.

Steps 2, 3, and 4 below will need to be carried out by the Enterprise when configuring your application in their JumpCloud instance.

Login to your WorkOS Dashboard and select “Organizations” from the left hand navigation bar.

Select the organization you’ll be configuring a new Directory Sync for.

Under “Actions” click “Add Directory”.

A screenshot highlighting the "Add Directory" option within an Organization in the WorkOS Dashboard.

Select “JumpCloud SCIM v2.0” from the dropdown, and input your Enterprise’s Name.

Then, click “Create Directory.”

A screenshot highlighting the "Create Directory" modal for creating a JumpCloud directory in the WorkOS Dashboard.

Your JumpCloud SCIM v.2.0 directory sync has now been created successfully with an Endpoint and Bearer Token.

A screenshot highlighting the "Directory Details" for a JumpCloud directory in the WorkOS Dashboard.

We have support for custom labeled URLs for Directory Sync endpoints. Contact us for more info!

Log in to the JumpCloud admin dashboard, select “SSO” on the left and select your Application.

Select or Create JumpCloud App

If you haven’t created an application, you’ll need to first create a custom SAML application in JumpCloud. JumpCloud only supports configuring SCIM provisioning in an existing SAML application. You can use our JumpCloud SAML documentation to configure your SAML application before moving on to SCIM provisioning.

Select “Identity Management” from the top navigation menu.

A screenshot highlighting the "SSO" tab and app selection in the JumpCloud admin dashboard.

Scroll down to the “Configuration settings” section. Make sure SCIM 2.0 is selected as the SCIM version.

Copy and paste the Endpoint from your WorkOS Dashboard in the “Base URL” field.

Then, copy and paste the Bearer Token from your WorkOS Dashboard into the “Token Key” field.

Next, test the connection to confirm the configuration settings.

A screenshot highlighting the "Base URL" and "Token Key" input fields in the JumpCloud admin dashboard.

After you receive a success message for the configuration, make sure the Group Management toggle is “On”, and then activate the settings.

A screenshot highlight the "Group Management" field toggled on in the JumpCloud admin dashboard.

After the activation step is successful, save the configuration.

A screenshot highlighting the "Save" button in the JumpCloud admin dashboard.

In order for your users and groups to be synced, you will need to assign them to your JumpCloud Application. Select “User Groups” from the top navigation menu.

Select the groups of users you would like to sync and save your changes.

A screenshot highlighting the User Groups tab in the JumpCloud admin dashboard.

Begin provisioning users and groups and witness realtime changes in your WorkOS Dashboard.