Skip to main content
Sign in

Creating an extended integration for ManageEngine computers

  • May 28, 2026 16:20
  • Updated

Sync ManageEngine computers with Oomnitza to gain complete visibility of assets.

ManageEngine Computers: This integration provides detailed information about inventoried devices, including hardware, software, asset, disk , and OS information.

See ManageEngine API Documentation: Inventory Computer - Detail Summary.

Depending on the credentials that you want to use to connect to ManageEngine's API, you can select one of the following integrations:

  • ManageEngine Computers (OAuth)
  • ManageEngine Computers (Session based)
  • ManageEngine Computers (AD Session based)

ManageEngine Computers - List Call: This integration provides a list of inventoried computers.

See  ManageEngine API Documentation: Inventory Scan Computers.

Depending on the credentials that you want to use to connect to ManageEngine's API, you can select one of the following integrations:

  • ManageEngine Computers - List Call (OAuth)
  • ManageEngine Computers - List Call (Session based)
  • ManageEngine Computers - List Call (AD Session based)

Before you start

To easily find the records that are uploaded to Oomnitza, it's best practice to create a dedicated user account for each integration. This will make it easier for you to retrieve the records that are uploaded to Oomnitza from the vendor application. 

small_blue_link.svg Creating integration users 

To connect to ManageEngine, you must provide the following information: 

ManageEngine server URLs. See List of ManageEngine server URLs. 

Data Center Location ManageEngine Server URL
USA https://desktopcentral.manageengine.com
Europe https://desktopcentral.manageengine.eu
India https://desktopcentral.manageengine.in
China https://desktopcentral.manageengine.cn
Australia https://desktopcentral.manageengine.com.au

ManageEngine API version. The current API version is 1.4.

Adding credentials

You can add credentials before you create the integration or you can add credentials when you create the integration. Adding credentials requires you to retrieve additional information from the vendor application. So, make life easier and add your credentials to Oomnitza before you create the integration. 

Tip
To add OAuth credentials, see Adding your ManageEngine credentials to Oomnitza.

Adding session based credentials

  1. Click Configuration > Security > Credentials.
  2. Click Add new credential add_grey_circle_black_plus.svg.
  3. Depending on the integration that you want to add, choose one of the following options:
    1. ManageEngine Computers Asset Load (Session Based)
    2. ManageEngine Computers Asset Load - List Call (Session Based)
    3. Click the right arrow right-arrow-icon-grey.svg.
  4. Enter your ManageEngine username, password, and server URL.
  5. Click CREATE.

Adding AD session based credentials

  1. Click Configuration > Security > Credentials.
  2. Click Add new credential add_grey_circle_black_plus.svg.
  3. Depending on the integration that you want to add, choose one of the following options:
    1. ManageEngine Computers Asset Load (AD Session Based)
    2. ManageEngine Computers Asset Load - List Call ( AD Session Based)
    3. Click the right arrow right-arrow-icon-grey.svg.
  4. Enter your ManageEngine username, password, server URL, and domain name.
  5. Click CREATE.

ManageEngine domains

Location of Data Center Accounts Server URL
USA accounts.zoho.com
Europe accounts.zoho.eu
India accounts.zoho.in
China accounts.zoho.com.cn
Australia acounts.zoho.com.au

Creating the integration

  1. In Oomnitza, click Configuration> Integrations> Overview.
  2. Click Block view block_view.PNG
  3. Scroll down to the Extended section for asset integrations.
  4. Click NEW INTEGRATION.
  5. Select the integration in the sidebar.
  6. Click ADD.

Integration details overview

More information is provided about the following fields to help you complete the integration:

Software data

Depending on the asset integration, an option might be available to ingest desktop software information such as the name and version of the software installed on an asset. To view the software information in Oomnitza, you must have the software module. 

Installation types

  • Cloud. Store credentials in the Oomnitza cloud.
  • Local. Store credentials locally. If you want to sync Oomnitza with vendor applications that require AWS or OAUTH authentication, select cloud as the type of installation. Local installations don't support AWS and OAuth authentication. 

Integration preferences

  • Create & Update. Add and update records.
  • Create only. Add records.
  • Update only. Update records.

Integration details

To review or update the integrations details, click Edit edit_black_pencil_icon.svg.

TipBulb_Icon_small.svg When you edit the Integration details section, you can select the name or names of integration contacts.  Integration contacts will receive an in-app notification and an email, when the integration fails, when the integration fails to complete within 24 hours, or when the scheduled integration fails to run.

  1. Update the integration name.
  2. Select an installation type.
  3. For integration preferences, select an option.
  4. Enter the name of the integration user.  

Credential details

If you selected Cloud as the installation type, choose one of the following options:

  • Select the credentials that were created for the integration.
  • Edit the credentials that were created for the integration.
  • Create new credentials

Scheduling the integration

By default, data is synced once every day. Change the interval or the time so that the data is streamed when your system isn't busy.

  1. Click Edit edit_black_pencil_icon.svg.
  2. Make and save your changes.

Mapping fields to Oomnitza

To map the fields to Oomnitza, click Edit edit_black_pencil_icon.svg.

 cog_red_dot_small_icon.svg Select Edit integration to add rules for syncing data. small_blue_link.svg Filtering integration results.  

Click SMART MAPPING.

You can add new fields to your integration by selecting Add new field  add_grey_rectangel_icon.svg on the mapping page. 
small_blue_link.svg Creating custom API fields. 

Creating custom mappings

Map ManageEngine fields to Oomnitza fields to get the user information that you need. For the field mapping, it is recommended to follow these steps:

  1. Click Smart Mapping to automatically detect appropriate mapping fields. Values from the integration can also be dragged to the appropriate field on the Oomnitza side, or selected from the integration field dropdown.
  2. Create a custom mapping for any other fields that you want to map that do not exist on the Oomnitza side.
    1. Click the down arrow on the field you want to map.
    2. Select Add new Oomnitza assets field.
    3. Update the Name field to a suitable name.
    4. Click CREATE. 
  3. Map and assign a sync key to a unique field, such as the Serial Number, or Resource ID

Tracking information for asset loads 

When the integration is run, you can track the name of the credentials that were used and the source of the data. To do this, you map the following fields to Oomnitza:   

  • Connect: Credentials
  • Connect: ManageEngine Server Url
  • Connect: Version

Mappable fields for Computer Assets

Computer Name
Domain Name
Primary Owner
Commercial Software
Connector Sync Time
Device Manufacturer
Disk Free Space
Disk Percent Free
Disk Percent Used
Disk Total Size
Disk Used Space
Hardware Device Model
Hardware Device Type
Hardware Memory
Hardware Processor
Hardware Product Number
Hardware Shipping Date
Hardware Warranty Expiry Date
Non-Commercial Software
Os Cd Key
Os Name
Os Version
Product Id
Prohibited Software
Registered To
**Serial Number
Total Hardware
Total Software

**Suggested sync key

Mappable fields for Computer Assets - List Call

Agent Installed Dir
Agent Logged On User
Agent Version
Branch Office Name
Build Number
Connector Sync Time
Description
Domain Netbios Name
Error Kb Url
Fqdn Name
Ip Address
Last Sync Time
Mac Address
Os Version
**Resource Id
Resource Id String
Resource Name
Scan Remarks
Service Pack
Software Name
Status Label

**Suggested sync key

Launching the integration

Your integration is in Draft mode until the required mandatory fields are added. When added, click Launch to activate your integration. 

small_blue_link.svg If you selected Cloud as the installation type when creating the integration, see Running an extended integration

small_blue_link.svg If you selected Local as the installation type when creating the integration, see Running an extended integration locally.

Viewing data ingested by Oomnitza

Viewing ingested asset data

For asset integrations, click Hardware. If the asset integration also ingests software data, click Software.

Viewing ingested user data

For user integrations, click People. If you chose the option to ingest User and SaaS user data, click Software > SaaS, click the SaaS app, and then click the Users tab. 

Related Links

Related articles

Comments

0 comments

Please sign in to leave a comment.