In order to enable seamless user and permissions management in Venn, Venn offers integrations with third-party Identity Providers (IdPs), including JumpCloud.
If you configure JumpCloud as your Venn Identity Management solution, your users will be created, modified, and deleted in JumpCloud and synced to Venn. Additionally, users' Venn login information will be managed through JumpCloud.
Learn how to manage Venn user access with JumpCloud as your IdP.
Requirements for SCIM Provisioning
In order to successfully sync over users, your JumpCloud user records must include these required fields:
- First Name (firstname in JumpCloud)
- Last Name (lastname in JumpCloud)
- Email (email in JumpCloud)
Additionally, your JumpCloud users' username values must meet the following criteria:
- Length: The string must be between 2 and 40 characters long.
- Allowed characters:
- Numbers
0-9 - Uppercase letters
A-Z - Lowercase letters
a-z - Hyphen/dash
- - Underscore
_
- Numbers
Any users in JumpCloud that do not meet this criteria will fail to provision.
Set up JumpCloud As Your IdP
You must have Admin access to JumpCloud in order to set it up as your Venn IdP.
To set up JumpCloud as your IdP:
- The Venn team or a Venn partner will guide you through the process of changing your Identity Provider to JumpCloud in Venn's Company Admin.
- Log in to JumpCloud Admin.
-
In the menu at left, click SSO Applications under USER AUTHENTICATION.
- Click Add New Application.
- Click Select under Custom Application, then click Next.
- Check the box next to Manage Single Sign-On (SSO) and select Configure SSO with SAML. Then, click Next.
- Set a Display Label and optional description for the Workplace app. Uncheck Show this application in User Portal and then click Save Application.
- On the confirmation screen, click Configure Application.
- You will be brought to the SSO tab of the Application Configuration page, update the following fields, and then click Save:
-
IdP Entity ID:
https://jumpcloud.venn-dev.com/sso/jump-cloud -
SP Entity ID:
https://jumpcloud.os33dev.com/sso/jump-cloud -
ACS URLs:
https://jumpcloud.os33dev.com/sso/jump-cloud - Sign: click the radio button next to Assertion
-
IdP Entity ID:
- Click on the application name again and go back to the SSO tab. Click Export Metadata.
- Copy and share the exported metadata with your Venn team. They will add that information to the JumpCloud federation settings in Venn's Company Admin.
- In JumpCloud Admin, go to the Identity Management tab of the Application Configuration page, update the following fields, and then click Save:
-
Base URL:
https://jumpcloud.venn.com/scim
-
Base URL:
- Copy the Token Key.
- Share the Token Key with your Venn team. They will add that information to the JumpCloud federation settings in Venn's Company Admin.
- Your Venn team will test, and then activate the connection in Venn's Company Admin.
Once these steps are complete, JumpCloud will be set up as you IdP for Venn and users will be provisioned into Venn from JumpCloud.
Manage User Access to Venn when JumpCloud is Your IdP
Follow the steps in this article to manage user access to Venn once you have set up JumpCloud as your IdP.