Integrate with ZoomInfo

Use JumpCloud SAML Single Sign-On (SSO) to give your users convenient but secure access to ZoomInfo with a single set of credentials. By pairing authentication with SCIM identity provisioning, you can automatically create, update, and deprovision users in real time based on their JumpCloud group memberships. This eliminates the security risk of orphaned accounts, saves significant administrative time, and ensures that expensive ZoomInfo seat licenses are automatically reclaimed the moment an employee changes roles or leaves the company.

Prerequisites:

• A JumpCloud administrator account.
• JumpCloud SSO Package or higher.
• An active ZoomInfo Admin Portal account with user management rights.

Important Considerations:

• SSO First: You must configure and test your SAML SSO integration before setting up SCIM auto-provisioning.
• Mapping Existing Users: If you are an existing ZoomInfo customer, ensure that JumpCloud usernames and emails match ZoomInfo values exactly to prevent provisioning errors.
• Credit, Role, and Usage Settings: ZoomInfo credit allocations, role assignments, and usage resets are set by default to map strictly upon account creation. Subsequent modifications to user credits must be updated directly within the ZoomInfo Admin Portal.

Creating a new JumpCloud Application Integration

1. Log in to the JumpCloud Admin Portal.

2. Go to Access > SSO Applications.
3. Click + Add New Application.
4. You can also enter the name of the application in the Search field and select it.
5. You can either select an application from the available list or select Custom Application, and click Next.
6. Select the required options from the Select Options page and click Next. The Enter General Info page is displayed.
7. On the Enter General Info page, you can customize the display label, description and how the application displays:
   • Description - add a description that users will see in their user portal
   • User Portal Image - choose Logo or Color Indicator
   • Show in User Portal - select to ensure the app is visible in the user portal
8. Optionally, expand the Advanced Settings section and customize the IdP URL:
   • Enter a custom value to replace the default application name in the SSO IdP URL endpoint ( https://sso.jumpcloud.com/saml2/{custom_value})

9. Click Save Application.
10. Next, click:
    • Configure Application and go to the next section
    • Close to configure your new application at a later time

Configuring the SSO Integration

To navigate to your JumpCloud SSO connector

1. Log in to the JumpCloud Admin Portal.

2. Go to Access > SSO Applications.
3. Create a new application or select it from the Configured Applications list.
4. Select the SSO tab.

To configure ZoomInfo

1. Log in to ZoomInfo as an admin. 
2. Go to the Zoominfo Admin Portal.
3. Go to User Management > Single Sign-On.
4. Locate the ZoomInfo's SAML Service Provider Details section. Copy the following values and paste them into a temporary document:
   • Relay State
   • Audience URI
   • Assertion Consumer Service URL
5. In the JumpCloud Admin Portal, return to the ZoomInfo configuration window's SSO tab and enter the copied values into their corresponding fields:
   • In the Default Relay State field, paste the Relay State string. 
   • In the SP Entity ID field, paste the Audience URI string. 
   • In the ACS URL field, paste the Assertion Consumer Service URL string.
6. Click Save.

Authorizing SSO Application Access

Users are implicitly denied access to SSO Applications. After you connect an application to JumpCloud, you need to authorize user access to that application. You can authorize user access from the Applications, Users List or User Groups page. 

To authorize user access from the SSO Application’s page

1. Log in to the JumpCloud Admin Portal.

2. Go to Access > SSO Applications, then select the application to which you want to authorize user access.
3. Select the User Groups tab. If you need to create a new group of users, see Get Started: User Groups.
4. Select the check box next to the desired group of users to which you want to give access.
5. Click Save. 

To learn how to authorize user access from the Users or User Groups pages, see Authorize Users to an SSO Application.

Validating SSO user authentication workflow(s)

Check your SP's documentation to ensure that both workflows are supported.

IdP-initiated user workflow

• Access the JumpCloud User Console
• Go to Applications and click an application tile to launch it
• JumpCloud asserts the user's identity to the SP and is authenticated without the user having to log in to the application

SP-initiated user workflow

• Go to the SP application login - generally, there is either a special link or an adaptive username field that detects the user is authenticated through SSO

• Login redirects the user to JumpCloud where the user enters their JumpCloud credentials
• After the user is logged in successfully, they are redirected back to the SP and automatically logged in

Configuring the SCIM Integration

To navigate to your JumpCloud SCIM connector

1. Log in to the JumpCloud Admin Portal.

2. Go to Access > SSO Applications.
3. Create a new application or select it from the Configured Applications list.
4. Select the Provisioning tab.

To configure ZoomInfo

1. Return to the ZoomInfo Admin Portal and go to Company Settings > Auto Provisioning.
2. Click Generate API Token. Copy both the Base URL and the newly generated API Token string to your clipboard.
3. In the JumpCloud Admin Portal, return to the ZoomInfo configuration window's Provisioning tab and click Configure.
4. Under Configuration Settings, paste your API token into the Token Key field.
5. Review and edit any user attribute mappings, then click Activate.
6. Return to the ZoomInfo Admin Portal's Company Settings > Auto Provisioning page, refresh the page, and ensure that the Auto Provisioning User Management toggle automatically switches to On.

Attribute Mappings

The Export Attributes Mapping table lists the Required and Optional Mappings that JumpCloud sends to the Service Provider. See Attribute Considerations for more information regarding attribute mapping considerations. 

Learn about JumpCloud Properties and how they work with system users in our API. 

Modifying Attributes

To add user attributes

1. From your connector’s configuration page, select the Provisioning tab.
2. Expand the Export Attribute Mapping section and click Edit. The Optional Mappings table will open.
3. Scroll to the bottom of the table and click +Add Attribute.
4. Select one of the mapping types:
   • Direct Mapping (JSON Path) - send the value from a user attribute in JumpCloud directly to an attribute in the service provider
     • From the JumpCloud Attribute dropdown, select the desired attribute
       • If you choose “Custom User Attribute” you must type the name of the attribute exactly as it on the user details page. To see the dropdown again, you must delete the attribute and add a new attribute
     • From the SCIM Attribute dropdown, select the corresponding (destination) attribute
   • Expression - transform or combine multiple user attributes into a single, custom value before sending it to the service provider
     • Enter the expression in the JumpCloud Attribute field
     • From the SCIM Attribute dropdown, select the corresponding (destination) attribute
   • Constant - send a fixed, predefined value—like a specific company name —for every user to the service provider
     • This is a free text field with no validation, e.g., the attribute must match exactly, including case, to the corresponding attribute in the user record. Once the custom attribute is added, you must delete it and readd a new custom attribute to see the dropdown again.
5. Repeat these steps for additional attributes.
6. Click Preview Mappings to review the User Schema.
   • If you do not select a specific user from the Preview Filter dropdown, the schema will default to the first user.

7. Click:
   • Save and Sync to initiate an immediate full sync of the updated attributes
   • Update to initiate the update during the next modification of the user group's record, like adding a space to the Description field

To add group attributes

1. From your connector’s configuration page, select the Provisioning tab.
2. Expand the Export Attribute Mapping section and click Edit. The Optional Mappings table will open.
3. Scroll to the bottom of the table and click +Add Attribute.
4. Select one of the mapping types:
   • Direct Mapping (JSON Path) - send the value from a group attribute in JumpCloud directly to an attribute in the service provider
     • From the JumpCloud Attribute dropdown, select Custom Group Attribute and edit the attribute to be a role or license
     • From the SCIM Attribute dropdown, select Custom User Attribute and enter the corresponding role or license destination attribute
   • Expression - enter the expression that uses group membership to define the roles attribute
     • Enter the expression in the JumpCloud Attribute field
     • From the SCIM Attribute dropdown, select the corresponding (destination) attribute
5. Click Preview Mappings to review the Group Schema.
6. Click:
   • Save and Sync to initiate an immediate full sync of the updated attributes
   • Update to initiate the update during the next modification of the user group's record, like adding a space to the Description field

To modify existing attributes

This enhancement gives you complete control over the user attributes sent from JumpCloud to this application. You can:

• Fully control mappings - define which JumpCloud attribute or source data corresponds to an attribute in the SP's SCIM schema
• Use a variety of source values - map data from the user's standard attributes, Manager field, custom attributes, or other data sources
• Manipulate data with expressions - transform data, such as preferred first names and date format, using expressions before transmission to the SP. Learn more
• Preview changes - review your new mappings to ensure accuracy before you save

1. From your connector’s configuration page, select the Identity Management tab.
2. Expand the Export Attribute Mapping section and click Edit.
3. For the type of attribute you would like to modify:
   • Direct - select the new attribute from the dropdown(s)
   • Expression - click in the Expression field and make the desired edits. If necessary, select the new attribute from the SCIM Attribute dropdown
   • Custom - delete the existing values in either or both of the attribute fields and enter the new values
4. Click Preview Mappings to review the updated User Schema.
5. Click:
   • Save and Sync and then Continue to initiate an immediate full sync of the updated attributes
   • Update to initiate the update during the next modification of the user group's record, like adding a space to the Description field

Deleting attributes

1. From your connector’s configuration page, select the Identity Management tab.
2. In the Export Attribute Mapping section, click Edit. The Optional Mappings table will open.
3. Click Delete () to remove any optional attributes.

4. Click:
   • Save and Sync and then Continue to initiate an immediate full sync of the updated attributes
   • Update to initiate the update during the next modification of the user group's record, like adding a space to the Description field

Restoring the default attribute table

1. From your connector’s configuration page, select the Identity Management tab.
2. In the Export Attribute Mapping section, click Edit. The Optional Mappings table will open.
3. Scroll to the bottom of the table and select Restore Defaults.
4. Click:
   • Save and Sync and then Continue to initiate an immediate full sync of the updated attributes
   • Update to initiate the update during the next modification of the user group's record, like adding a space to the Description field

Removing the Integration

To deactivate the SCIM Integration

1. Log in to the JumpCloud Admin Portal.

2. Go to Access > SSO Applications.
3. Search for the application that you’d like to deactivate and click to open the configuration window. 
4. Click Actions > Deactivate IdM and then click confirm.

To deactivate the SSO Integration

1. Log in to the JumpCloud Admin Portal.
2. Go to Access > SSO Applications.
3. Search for the application that you’d like to deactivate and click to open its details panel. 
4. Select the SSO tab.
5. Scroll to the bottom of the configuration.
6. Click Deactivate SSO. 
7. Click Save. 
8. If successful, you will receive a confirmation message.

To delete the application

1. Log in to the JumpCloud Admin Portal.

2. Go to Access > SSO Applications.
3. Search for the application that you’d like to delete.
4. Check the box next to the application to select it.
5. Click Delete.
6. Enter the number of the applications you are deleting
7. Click Delete Application.
8. If successful, you will see an application deletion confirmation notification.