Skip to main content

ManageEngine Endpoint Central

Visualize Manage Engine computers, patches and remote offices in the JupiterOne graph. Our guide provides step-by-step instructions on setting up the integration gaining visibility to your ManageEngine Endpoint Central environment.

Installation

To install this integration, you will need to configure settings both within ManageEngine Endpoint Central and on JupiterOne. Before enabling in JupiterOne, ensure that you complete the setup within your ManageEngine Endpoint Central's account.

Configuration on ManageEngine Endpoint Central

First, follow the table in the ManageEngine Endpoint Central documentation to get correct Zoho Account and Endpoint Central API URLs, as well link to the Zoho Developer Console necessary to the next steps.

ManageEngine Integration Setup Guide

This guide provides detailed, step-by-step instructions to set up an integration with ManageEngine Desktop Central. There are two integration options available: On-Premises and Cloud. Follow the instructions below to ensure your integration is configured correctly.

Table of Contents

  1. Prerequisites
  2. On-Premises Integration Setup
  3. Cloud Integration Setup
  4. Troubleshooting
  5. Support

Prerequisites

Before you begin, ensure you have:

  • An active ManageEngine Desktop Central subscription.
  • API access enabled and necessary credentials obtained.
  • Basic knowledge of REST APIs and your current environment setup.
  • Network/firewall settings that allow outbound API requests.

On-Premises Integration Setup

ManageEngine offers two methods for on-premises integration depending on your authentication method:

API Token Authentication

  1. Access the On-Premises API Documentation
    Familiarize yourself with the available endpoints and guidelines in the ManageEngine On-Premises API Documentation.

  2. Generate an API Token

    • Log in to your Desktop Central instance.
    • Navigate to AdminIntegrationsAPI Key Management.
    • Create or regenerate your API token.
    • If two factor is enabled make sure to complete the steps providing the OTP.
    • Note: Ensure that this token remains confidential.
  3. Configure Your Integration

    • Update your JupiterOne integration settings. Select On-Premise Token Authentication.
    • Input your Server URL and API Token.

Username/Password Authentication (No Two-Factor)

If you are not using two-factor authentication, you can also integrate using your username and password.

  1. Review Authentication Requirements

  2. Configure Your Integration

    • Update your JupiterOne integration settings. Select On-Premise AD Authentication or On-Premise Local Authentication depending on your setup.
    • Input your Server URL, username, password and domain if needed.

Cloud Integration Setup

Familiarize yourself with the cloud API by referring to the ManageEngine Cloud API Documentation.

Steps:

  1. Log in to Zoho Developer Console
    Access the Zoho Developer Console with your credentials.

  2. Create a "Self Client" Client Type
    Create a new client of type "Self Client".

  3. Retrieve Client Credentials

    • Navigate to the "Client Secret" tab.
    • Copy the "Client ID" and "Client Secret" and save them somewhere secure.
  4. Generate an Authorization Code

    • Go to the "Generate Code" tab within your "Self Client" application.
    • Set the Scope to:
      DesktopCentralCloud.Common.READ,DesktopCentralCloud.SOM.READ,DesktopCentralCloud.Inventory.READ,DesktopCentralCloud.PatchMgmt.READ
    • Optionally, set the Time Duration to 10 minutes.
    • Provide a Scope Description (e.g., "JupiterOne Integration").
    • Click Create to generate an authorization code.
  5. Obtain the Refresh Token

    • Use the generated code in the following curl command (replace <code>, <client_id>, and <client_secret> with your actual values):

      curl -X POST -H "Content-Type: application/x-www-form-urlencoded" \
      -d "code=<code>&client_id=<client_id>&client_secret=<client_secret>&redirect_uri=https://www.zoho.com" \
      https://accounts.zoho.com/oauth/v2/token
    • The response will include a JSON with the refresh token.

  6. Save the Credentials
    Store the "refresh token", along with your "Client ID" and "Client Secret", securely. These credentials will be needed later when configuring JupiterOne.

Support

For more details and assistance, refer to the official documentation: