# VMware MDM AirWatch

## Connection Requirements

{% stepper %}
{% step %}

### IP or Hostname

IP address or Hostname of Vmware MDM Airwatch host.
{% endstep %}

{% step %}

### Username

The username which is going to be used by OctoXLabs CSAM PLATFORM Asset to fetch data from VMWare MDM AirWatch. The user must have read permission on the VMWare MDM AirWatch to read device data.
{% endstep %}

{% step %}

### Password

Password of the username provided.
{% endstep %}

{% step %}

### Tenant ID / API Key

API Key to generate for a user with permissions to retrieve their assets.

To generate an API Key:

* Admin panel login, all settings from settings,
* On the left panel, click System → Advanced → API → REST API .
* Click Add to generate the API key, add a name, set it as admin type, copy the API key and save.

{% hint style="info" %}
🔵 Enable AirWatch REST APIs\
To enable API access in the AirWatch Console: Log into the AirWatch Console. Navigate to Groups & Settings → All Settings → System → Advanced → API → REST API. Configure the General, Authentication, and the Advanced tab. Enable API Access – Select Enabled to generate the API authentication key. Add – Select to generate multiple the API key for one or multiple servers. Then, configure the related settings.
{% endhint %}
{% endstep %}

{% step %}

### Port

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

{% step %}

### SSL

Use SSL for connection (optional, default: Encrypted).
{% endstep %}

{% step %}

### Fetch Applications?

Fetch Applications in VMWare MDM AirWatch (optional, default: True).
{% endstep %}

{% step %}

### Use Mac Aggregation

Adapter will use aggregation based on mac address field (default: False).
{% endstep %}

{% step %}

### Timeout

Time to return API call (default: 30).
{% endstep %}

{% step %}

### Version

Version of the VMWare MDM AirWatch.
{% 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.octoxlabs.com/adapters/adapters/vmware-mdm-airwatch.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.