Add JumpCloud to Zoho One | Admin Guide - Zoho One

Add JumpCloud to Zoho One

Prerequisites:

Roles required in Zoho One:

  • Organization Owner

  • Organization Admin

 

Roles required in JumpCloud:

  • Admin

 

Plan dependency in Zoho One:

  • Free plan

 

Using API
Using SCIM
Using API
To add JumpCloud as a store in Zoho One using API integration, generate the API key from your JumpCloud administrator account. In Zoho One, add the JumpCloud Directory Store and use the API key to authenticate the integration.

In JumpCloud: Generate your API key

  1. Sign in to the JumpCloud Admin Console.
  2. Click Settings in the left menu.
  3. Click Administrators, then click the name of the admin who will be performing this integration.
  4. In the Edit Administrator pop-up, below the Role field, select Enable API access.
  5. Click Save.
  6. Click the User Profile icon in the top-right corner, and then click My API Key.
  7. In the API Key pop-up, click Generate New API Key and note down the API key. You will need it later during Zoho One configuration.
    If any error message is thrown instead of the API Key pop-up, refresh the screen once and repeat the 6th and 7th steps.
    Notes
    API key will be displayed only during the time of generation. To view or copy the API key again, repeat the 7th and 8th steps.

In Zoho One: Add and configure directory store

  1. Sign in to Zoho One, then click Directory in the left menu.
  2. Go to Directory Stores, then click Add Directory.
  3. Click Add next to JumpCloud.
  4. Under API INTEGRATION, paste the API key copied from Jumpcloud.
  5. Click Next.
  6. Map the fields available in Zoho One to the fields available in JumpCloud. If you'd like all users synced from JumpCloud to have the same value for a field, map that field with a hard-coded value. For example, if you want the value for the field 'Country' to be 'India', then you can type India as a value for the Hard-coded Value.
  7. To map a hard-coded value with a field:
    1. Hover near the relevant field and click Edit.
    2. Enter the value you need in the Hard-coded Value field.
    3. Click OK.
  8. To map a custom attribute field created in JumpCloud to a field in Zoho One:
    1. Hover near the relevant field and click Edit.
    2. Enter the required Attribute Name in the Custom JumpCloud Attribute field.
    3. Click OK.
      Info
      In JumpCloud, Attribute Name is displayed under the Custom Attributes section of the user details page.
  9. Click Next.
  10. Under SETTINGS, choose your preferences for Password Notification, Status Sync, Sync Criteria, and Scheduled Sync.
    Notes
    Password Notification setting is only applicable to users' whose email address has a verified domain name.
  11. Click Save and Close.

Using SCIM
To add JumpCloud as a store in Zoho One using SCIM integration, you must add the JumpCloud store in Zoho One and note down the Sync Endpoint and SCIM token. Using these tokens, configure identity management in JumpCloud and authorize the integration to complete the configuration.

In Zoho One: Generate auth tokens

  1. Sign in to Zoho One, then click Directory in the left menu.
  2. Go to Directory Stores, then click Add Directory.
  3. Click Add next to JumpCloud.
  4. Under API INTEGRATION, note down the Sync endpoint and SCIM token. Later, you'll need to provide this information in JumpCloud to enable sync.
  5. Click Next.
  6. Map the fields available in Zoho One to the fields available in JumpCloud. If you'd like all users synced from JumpCloud to have the same value for a field, map that field with a hard-coded value. For example, if you want the value for the field 'Country' to be 'India', then you can type India as a value for the Hard-coded Value.
    To map a hard-coded value with a field:
    1. Click Edit next to a field.
    2. Enter the value you need in the Hard-coded Value field.
    3. Click Ok.
  7. Click Next.
  8. Under SETTINGS, choose your preferences for Password Notification, Status Sync, Sync Criteria, and Scheduled Sync.
    Notes
    Password Notification setting is only applicable to users' whose email address has a verified domain name.
  9. Click Save and Close.

In JumpCloud: Configure custom app and test connection

  1. Sign in to the JumpCloud Admin Console.
  2. Select SSO Applications in the left menu.
  3. Click Add New Application.
  4. Select Custom Application.
  5. Click Next. Select the following features:
    1. Manage Single Sign-On(SSO)
    2. Import users from this app (Identity Management)
    3. Export users to this app (Identity Management)
    4. Enable Identity Management (and SSO, if you want)
      Then click Next.
  6. Enter general info listed on the page, and click Save Application.
  7. Click Configure Application. You can set up SSO here, if you want.
  8. For provisioning, navigate to Identity Management tab.
  9. In the Base URL field, paste the Sync endpoint copied from Zoho One, and in the Token Key field, enter the SCIM token that you generated in Zoho One.
  10. For Test User Email, enter any dummy user email or email domain that is not a part of Zoho One.
  11. Once done, click Test Connection. Ensure the Enable management of User Groups and Group membership in this application checkbox is selected.
  12. Click Activate.
  13. Navigate to the User Groups tab and select the checkbox next to each user group you want to sync to Zoho One.
    Notes
    JumpCloud syncs only groups of users and not individual users; hence, only the users present under the selected group will be synced to Zoho One.
  14. Click Save.
    Info
    The sync will take place immediately on Zoho One side.
  15. Once done, navigate to the Members tab in JumpCloud on Zoho One side to view all of the users synced with Zoho One.

    Notes
    In case of attribute mappings in JumpCloud side, if you want to sync a few information, say, for example, Location, Employee ID, and Job Title, you'll have to manually add each attribute to get it reflected on Zoho One side.

 ​