> For the complete documentation index, see [llms.txt](https://docs.octoxlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.octoxlabs.com/adapters/adapters/manageengine-mdm.md).

# ManageEngine MDM

## Connection Requirements

{% stepper %}
{% step %}

### IP

IP address of the ManageEngine MDM host. (default: mdm.managenegine.com)
{% endstep %}

{% step %}

### Port

Port number (optional, default: 443).
{% endstep %}

{% step %}

### API Key (Use only on-Prem)

* On the MDM server, click on Admin tab from the top menu and select API Key Generation, present under Integrations.
* Follow the on-screen instructions to generate an API key.

{% hint style="info" %}
scope\
Rest of the options are for the cloud the users. If you're on-Prem, you may leave them blank. In order to use the API, you have to obtain a Grant Token from ManageEngine MDM service. Redirect to the following authorization URL with the , client\_id , response\_type(you may use "code" in here) , redirect\_uri options. <https://accounts.zoho.com/oauth/v2/auth>?
{% endhint %}

{% hint style="info" %}
Request Example

```
https://accounts.zoho.com/oauth/v2/auth?scope=MDMOnDemand.MDMInventory.CREATE, MDMOnDemand.MDMInventory.READ&client_id=1000.0SRSZSY37WMZ69405H3TMYI2239V& state=testing&response_type=code&redirect_uri=http://www.mdm.manageengine.com& access_type=offline
```

* On this request, you will be shown with a "user consent page".
* Upon clicking “Accept”, Zoho will redirect to the given redirect\_uri with code and state param. This code value is mandatory to get the access token in the next step and this code is valid for 60 seconds.
* On clicking “Deny”, the server returns an error and you will not be able to use API
  {% endhint %}
  {% endstep %}

{% step %}

### Code

Obtained in above step.
{% endstep %}

{% step %}

### Client ID

Client ID obtained during Client Registration
{% endstep %}

{% step %}

### Client Secret

Client secret obtained during Client Registration
{% endstep %}

{% step %}

### Redirect URI

This param should be same redirect url mentioned while adding Client
{% endstep %}

{% step %}

### SSL

Use SSL for connection (optional, default: True).

Device Based Information: MDMOnDemand.MDMInventory.READ, MDMOnDemand.MDMInventory.READ\
User Based Information: MDMOnDemand.MDMUser.READ
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Attention\
Please perform a **connection test** to ensure there is a valid connection to the host.\
When the discovery operation is finalized, you will be able to see the details on the **Assets** page.
{% endhint %}