Overview

The ManageEngine Endpoint Central connector enables your Leena AI Agents to integrate with your organization's ManageEngine Endpoint Central platform, facilitating automated endpoint management, inventory tracking, patch management, and vulnerability assessment workflows.

ManageEngine Endpoint Central is a unified endpoint management solution that allows organizations to manage and secure their endpoints from a central location. The ManageEngine Endpoint Central connector allows Leena AI to automate inventory management, patch deployment, vulnerability scanning, and interact with endpoint data seamlessly.

API Details

Leena AI integrates with ManageEngine Endpoint Central via REST APIs.

Documentation link: https://www.manageengine.com/products/desktop-central/api/

Setup

The ManageEngine Endpoint Central connector uses OAuth 2.0 authentication with the authorization code grant type.

Prerequisites

Before setting up the ManageEngine Endpoint Central connector, ensure you have:

• Access to Zoho API Console (https://api-console.zoho.in/)
• ManageEngine Endpoint Central administrator privileges
• Ability to create OAuth 2.0 applications in Zoho
• Access to your Leena AI workspace with connector management permissions

Get credentials

Here is how to create an OAuth client in Zoho API Console:

1. Log in to Zoho API Console at https://api-console.zoho.in/
2. Create OAuth Application:
   1. Click on Add Client button
   2. Choose Server based Applications
3. Configure Application Details:
   1. Fill in the required form fields
   2. Click Create button
4. Save and Note Credentials:
   1. Note the Client ID displayed
   2. Note the Client Secret displayed
   3. These credentials are displayed only once during creation
5. Generate Sign In URL and Authorization Code:
   1. Generate the Sign In URL using the format: https://accounts.zoho.com/oauth/v2/auth?response_type=code&client_id=<clientId>&scope=<scope>&access_type=offline&redirect_uri=<redirect_uri>
   2. Open the URL in a browser and login
   3. The response will contain:
      • code: Authorization code
      • location: Region to use for API calls
      • accounts-server: Server URL

Add connection

Here is how to add a connection on Leena AI:

1. Log in to your Leena AI workspace
2. Navigate to Settings > Integrations
3. Click on Add Connector
4. Search for "ManageEngine Endpoint Central" and select it from the list
5. Start configuring the connector:
   1. Client ID: OAuth application client ID from Zoho API Console
   2. Client Secret: OAuth application client secret from Zoho API Console
   3. Authorization Code: Authorization code obtained from the Sign In URL process
   4. Location: Region from authorization response (e.g., in for India)
   5. Redirect URI: The callback URL as configured in your OAuth app
   6. Base URL: Defaults to https://endpointcentral.manageengine.in
   7. API Version: Defaults to 1.4
   8. Scope: Required permissions (Pre-filled with necessary scopes):
      • DesktopCentralCloud.Common.READ
      • DesktopCentralCloud.Inventory.READ
      • DesktopCentralCloud.Inventory.UPDATE
      • DesktopCentralCloud.PatchMgmt.READ
      • DesktopCentralCloud.PatchMgmt.UPDATE
      • DesktopCentralCloud.VulnerabilityMgmt.READ
6. Test Connection:
   1. After entering all required fields, click Test Connection
   2. If successful, you'll see a green confirmation message
   3. If the test fails, verify your credentials and OAuth configuration
7. Save Configuration:
   1. Once the connection test passes, click Save
   2. The connector will be saved and ready to use

Actions

The following actions are supported for the ManageEngine Endpoint Central connector:

Get Software List

Retrieves list of installed software with various filtering options.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

None

Optional

Required scope at connector level: DesktopCentralCloud.Inventory.READ

Here is a sample JSON input:

{
  "Domain Filter": "company.local",
  "License type Filter": "Commercial",
  "Access type Filter": "Allowed",
  "Page": 1,
  "Page limit": 50,
  "Search type": "contains",
  "Search column": "software_name",
  "Search value": "Microsoft"
}

Response

Get Hardware List

Retrieves list of hardware components.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

None

Optional

Required Connector Scope: DesktopCentralCloud.Inventory.READ

Here is a sample JSON input:

{
  "Domain Filter": "company.local",
  "Page": 1,
  "Page limit": 50,
  "Search type": "contains",
  "Search column": "hardware_type",
  "Search value": "Processor"
}

Response

Get hardware installed computer list

Retrieves list of computers with particular hardware installed.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Optional

Scope: DesktopCentralCloud.Inventory.READ

Here is a sample JSON input:

{
  "Hardware ID": "hw_12345",
  "Domain filter": "company.local",
  "Branch Office filter": "HQ",
  "Custom Group filter": "Engineering Dept"
}

Response

Get detailed summary for a computer

Retrieves detailed summary of a specific computer.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Optional

None

Scope: DesktopCentralCloud.Inventory.READ

Here is a sample JSON input:

{
  "Resource ID": "comp_67890"
}

Response

Get Software/s installed on a Computer

Retrieves software/s installed on a specific computer in the eco-system.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Optional

Scope: DesktopCentralCloud.Inventory.READ

Here is a sample JSON input:

{
  "Resource ID": "comp_67890",
  "License type Filter": "Commercial",
  "Access type Filter": "Allowed",
  "Compliance status Filter": "In Compliance",
  "OS compatibility": "64-bit"
}

Response

Get Associated Licenses with the software

Retrieves licenses associated with specific software. This action can be used to fetch the available license and types for the software.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Optional

Scope: DesktopCentralCloud.Inventory.READ

Here is a sample JSON input:

{
  "Software Id": "sw_12345",
  "page": 1,
  "Page limit": 20
}

Response

Perform patch scan on specific systems

Initiates a patch scan for specific systems. Basis the output of this action further actions to update the patches can be triggered.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Optional

None

Scope: DesktopCentralCloud.PatchMgmt.UPDATE

Here is a sample JSON input:

{
  "resource IDs": [12345, 67890, 11223]
}

Response

Approve/Decline a patch for deployment

This action approves or declines a patch for deployment. This action can be used to take system admin's inputs on a patch deployment and basis input approve/decline the same.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

Optional

None

Scope: DesktopCentralCloud.PatchMgmt.UPDATE

Here is a sample JSON input:

{
  "Patch ID": "patch_98765"
}

Response

Get system misconfigurations

Retrieves all system misconfigurations across all the systems.

Input Parameters

Here are the input parameters required to set up this action:

Mandatory

None

Optional

Scope: DesktopCentralCloud.VulnerabilityMgmt.READ

Here is a sample JSON input:

{
  "Domain Filter": "company.local",
  "Page": 1,
  "Page limit": 50,
  "Severity filter": "High"
}

Response