VMware Workspace ONE (AirWatch)

VMWare Workspace ONE (formerly AirWatch) provides enterprise mobility management (EMM) software and standalone management systems for content, applications, and email.

Types of Assets Fetched

This adapter fetches the following types of assets:

• Devices
• Users
  
  

Parameters

1. AirWatch Domain - The hostname or IP address of the VMWare Workspace ONE server.

2. Authentication Method - Select an authentication method, either OAuth or User Credentials. If you select User Credentials, then User Name and Password are displayed. If you select OAuth, then Client ID, Client Secret and Access Token Domain are displayed
   User Credentials
   

3. User Name and Password - The credentials for a user account that has the permissions to fetch assets.

   Note:

   If a user name is a dedicated user created solely for the adapter usage, you must first login as that user to create the recovery key. Once completed, connection with the adapter should be successful.

4. API Key - API key for the REST API, created in the admin panel. For more details, see Creating an API Key for the VMware Workspace ONE (AirWatch).

OAuth

5. Client ID and Client Secret - When you choose OAuth as the authentication method, specify the Client ID and Client Secret to be used to authenticate the request. For more information about obtaining a Client ID and Client Secret refer to How to Use REST API in Workspace ONE UEM .

6. Access Token Domain - The Token Issuer domain. Refer to Access Token URLs for information about the Access Token URL. The optional Access Token Domains are 'apac', 'emea', 'na' or 'uat'.

7. API Rate Limit (Calls per Minute) (optional) - Specify a rate limit for the number of requests per minute to be sent to VMware. If left empty, the number of requests initiated by the connection for this adapter won't be limited.

8. Verify SSL - Select whether to verify the SSL certificate offered by the value supplied in AirWatch Domain. For more details, see SSL Trust & CA Settings.

9. HTTPS Proxy (optional) - A proxy to use when connecting to the value supplied in AirWatch Domain.

10. HTTPS Proxy User Name (optional) - The user name to use when connecting to the value supplied in AirWatch Domain via the value supplied in HTTPS Proxy.

11. HTTPS Proxy Password (optional) - The password to use when connecting to the value supplied in AirWatch Domain via the value supplied in HTTPS Proxy.

12. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Advanced Settings

1. Fetch extended information *(required, default: true) - Select whether to fetch additional information for each device, such as the Security Patch Date field.
   • If enabled, all connections for this adapter will also fetch additional information for each device.
   • If disabled, all connections for this adapter will not fetch additional information for each device.
2. Fetch device apps (required, default: true) - Select whether to fetch additional information for each device application from VMWare Workspace ONE server.
   • If enabled, all connections for this adapter will also fetch applications associated with the fetched devices.
   • If disabled, all connections for this adapter will not fetch application data.
3. Fetch device networks (required, default: true) - Select whether to fetch device networks from VMWare Workspace ONE server.
   • If enabled, all connections for this adapter will also fetch networks data associated with the fetched devices.
   • If disabled, all connections for this adapter will not fetch networks data.
4. Fetch device notes (required, default: true) - Select whether to fetch device notes from VMWare Workspace ONE server.
   • If enabled, all connections for this adapter will also fetch notes associated with the fetched devices.
   • If disabled, all connections for this adapter will not fetch notes.
5. Fetch device tags (required, default: true) - Select whether to fetch device tags from VMWare Workspace ONE server.
   • If enabled, all connections for this adapter will also fetch tags associated with the fetched devices.
   • If disabled, all connections for this adapter will not fetch tags.
6. Fetch device profiles (required, default: true) - Select whether to fetch device profiles from VMWare Workspace ONE server.
   • If enabled, all connections for this adapter will also fetch profiles associated with the fetched devices.
   • If disabled, all connections for this adapter will not fetch profiles.
7. Only fetch installed software (optional, default: false) - Select whether to only fetch installed software.
   • If selected, only software with a Status of '2' (Installed) will be included in the fetch.
   • If disabled, all software listed under devices will be fetched, regardless of status.
8. Fetch device compliance data (required, default: true) - Select to query the compliance API. If this option is clear, the device compliance API is not queried and related data is not fetched.
9. Fetch device sensors information - Select this option to fetch device sensor information.
10. Fetch security search information - Select this option to fetch security information for a device.
11. Fetch extensive search - Select this option to search results containing the devices and their product assignment information and fetch that data.
12. Fetch users (default: true) - Select this option to fetch users (if you clear this option, users are not fetched).
13. Fetch Smart Groups - Select this option to fetch Smart Groups.

Creating an API Key for the VMware Workspace ONE (AirWatch) API

To create an API key for the VMware Workspace ONE (AirWatch) API:

1. Go to the admin panel, click on Groups & Setting and then click on All Settings:
   

2. After clicking, you will see a screen with new options to your left.
   Click: System → Advanced → API → REST API. You will see this screen:

   

3. Click add to create a new API key, add an indicative service name, set it to admin Account Type , copy the API key and save it to a secure location (you will need it later on when configuring the adapter).