Configure Real-time SCIM User Provisioning from Entra ID

Streamline lifecycle management for your organization by connecting Entra ID with JumpCloud through a real-time user import SCIM integration. This integration lets you manage your organization’s user identities in Entra ID, and easily connect users to all of the IT resources they need through JumpCloud. After you connect Entra ID with JumpCloud through our SCIM server, depending on the integration settings you choose, users are seamlessly created, updated, and deleted in JumpCloud according to the actions you take on users in Entra ID.

Prerequisites

• A JumpCloud Administrator API key

Considerations

• The ?aadOptscim062020 feature flag must be added to the Tenant URL for user updates and deprovisioning to be supported.
  • Only new users will be created if this flag is not added
• Real-time Group import isn’t currently supported

Attribute Considerations

• The manager attribute isn’t supported

Integrating Entra ID with the JumpCloud SCIM Server

1. Log in your Microsoft Entra admin center. 
2. Click on Enterprise applications to create a custom app. 
3. Click New application > Create your own application.

4. Under What’s the name of your app? Enter a name to distinguish the JumpCloud integration.
5. Next, answer the question, What are you looking to do with your application? with the multiple choice answer, Integrate any other application you don’t find in the gallery (Non-gallery). Click Create. 
6. Now, you can see your application dashboard. In the left navigation menu, click on Single sign-on.

7. If you select the Password-based option, the Sign-on URL needs to be provided. Copy/Paste the JumpCloud user console URL link into the designated field and click Save. 
8. In the left navigation menu, click Provisioning.
9. Under the Provisioning Mode dropdown menu, select Automatic. This will power the real-time sync using the SCIM server. 
10. Under Admin Credentials, there are two fields required to connect the real-time JumpCloud import’s API and synchronize your user data.
    • Tenant URL: For JumpCloud, this is a SCIM-based URL: https://api.jumpcloud.com/scim/v2/?aadOptscim062020
    • Secret Token: A JumpCloud API key should be used to authorize this integration. The API key in JumpCloud is associated with an admin account. Use an admin account that has a role of Admin with Billing, Administrator, or Manager that will be a long lived admin account for your organization. See Generating a New API Key.
11. Click Test Connection. You will receive a notification that the authorization was successful. Click Save.
12. Under Mappings, click on Provision Microsoft Entra ID (formerly Active Directory) Groups. The default option will be enabled to Yes.

13. Now, go back to the Provisioning dashboard > Mappings section and click on the next option, Provision Microsoft Entra ID (formerly Active Directory) Users. Leave this option enabled to Yes. 
14. Under Target Object Actions, there are three available capabilities; Create, Update and Delete. You can choose which options you’d like.

15. Click on an attribute to edit it. The attribute mapped to userName needs to be adjusted to satisfy JumpCloud’s attribute validation. We suggest userPrincipalName, the default mapping, be edited to adjust the source attribute to mailNickname, this is typically the first.lastname. Click Ok.
16. The attribute, mail needs to be edited to adjust the source attribute to userPrincipalName. The primary email in JumpCloud is the work email which serves as the userPrincipalName in Entra. 
17. From here, you can delete any attributes that you don’t want mapped. Take a look at the Attribute Mappings table below to see which attributes JumpCloud sends to Entra because not all attributes are supported. 
18. Once the Attribute Mappings are set, click Save. You will be prompted to confirm you want to save your changes, click Yes. 
19. Now, go back to the Provisioning dashboard > Settings section. There are options to Send email notifications if failures occur, in addition to Scope, which allows you to choose if you want to Sync all users and groups or only assigned users and groups. 
20. Leave the Provisioning Status toggled On. 
21. If any changes were made, click Save.
22. Go back to the main dashboard > left navigation menu, click on Users and groups to assign users to the app. 
23. Click Add user/group > Users > None Selected to select Users to add. Search for the users you want to add and click Select, then Assign.

JumpCloud Supported SCIM Attribute Mappings

The following table lists attributes that the JumpCloud SCIM client will accept from this integration. Learn about JumpCloud Properties and how they work with systemusers in our API.