Skip to content

Integrate Lens ID with JumpCloud#

Lens Pro subscription feature

Info

Apart from Lens Desktop Pro, this feature requires a Lens Control Center subscription. Visit Lens Store or contact the sales team to get full access to the features.

The System for Cross-domain Identity Management (SCIM) specification is designed to make managing user identities in cloud-based applications and services easier. Lens ID supports the SCIM integration with the JumpCloud directory platform. For details about the JumpCloud products, see the JumpCloud official website.

Prerequisites:

  • Lens Business ID
  • Enabled Lens Control Center
  • Administrator account on the JumpCloud platform

Create the SSO application#

To create a Lens ID SSO application in the JumpCloud directory platform:

  1. Log in to the JumpCloud directory platform as an administrator.
  2. In the left panel of the JumpCloud administrator account interface, click SSO Applications.
  3. Click Add New Application above the list of applications.
  4. Select Custom Application and click Next.
  5. Select Import users from this app (Identity Management) and click Next.
  6. In the Display Label input field, type the application name and click Save Application.

    Note

    For clarity purposes, we recommend using the value of the Business ID field in the Profile section of your Lens Business ID.

  7. Optional. Click Configure Application to proceed to the application configuration process.

Configure the SSO application#

  1. As JumpCloud administrator, select the application from the list.
  2. In the application configuration menu, select the Identity Management tab and specify the parameters as follows:

    Option Recommended value Comment
    API Type SCIM
    SCIM Version SCIM 2.0
    Base URL Base URL Find this value in Lens Business ID > Authentication > Base URL
    Test User Email test@test.com You can use any value of the email address format
  3. Test the application functioning by clicking Test Connection.

  4. Disable the Enable management of User Groups and Group Membership in this application flag.
  5. Click Activate in the header of the configuration menu and then click Save.

Add a new group#

Create a group of users to be synchronized with your Lens Business ID:

  1. From the JumpCloud administrator account, navigate to User Groups.
  2. Click the plus button in the top bar.
  3. On the Details tab of the group configuration menu, specify the group name and other additional parameters.
  4. On the Users tab, specify the members of the group.
  5. On the Applications tab, select the application needed.
  6. Click Save.

Add users to the application#

  1. From the JumpCloud administrator account, navigate to SSO Applications.
  2. Select the user group and, in the group profile, open the User Groups tab.
  3. Select the group needed and click Save.

Adding user accounts to the application synchronizes them with the Lens Business ID. If there is an available subscription seat, a user gets automatically assigned to it. You can remove the user from the Lens Business ID and unassign the subscription seat through the JumpCloud administrator account. To do so, suspend the user account from the corresponding application.