Creating an extended integration for VMware Workspace ONE assets

Let Oomnitza be your single source of truth!

You'll get complete visibility of your assets as data from Workspace ONE is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Workspace ONE in minutes

• Configurable dashboards and list views of key asset information
• Configurable reports to share information about your assets with your colleagues and management
• Configurable workflows that you can easily create to automate tasks such as :
  • activating, updating, deleting, and installing applications on devices in Workspace ONE.
  • assigning and removing Smart Groups to applications on devices in Workspace ONE.

Navigation

Setting your Workspace ONE Subdomain as a global variable

Add credentials to the vault in Oomnitza

Integrate Workspace ONE with Oomnitza

Creating custom mappings

Creating a workflow

Activate Internal Application
Activate Public Application
Assign Smart Group to Internal Application 
Assign Smart Group to Public Application
Deactivate Internal Application
Deactivate Public Application
Delete Internal Application
Delete Public Application
Install Internal Application on Device
Install Public Application on Device
Install Purchased Application on Device
Internal Application Save
Remove Smart Group from Internal Application
Remove Smart Group from Public Application
Retire Internal Application
Uninstall Internal Application from Device
Uninstall Public Application from Device
Uninstall Purchased Application from Device
Unretire Internal Application 
Update Internal Application
Update Removal Logs 

Before you start

Best practice
For the integration with Oomnitza, create a dedicated user account.

Workspace ONE uses OAuth2.0 for Authentication, and requires a Client ID and Client Secret from Workspace ONE to activate in Oomnitza. You should note to the following when working with Workspace ONE OAuth2.0:

• When setting up a new client, ensure that you follow the steps in Create an OAuth Client to Use for API Commands.
• By default, OAuth access tokens remain valid for 3600 seconds (1 hour). Refer to the VMWare documentation for more information.
• As an organization owner, you can regenerate the app secret of an OAuth app in your organization. This is useful if the organization owner who created the OAuth app is no longer with your corporation and you want to continue running the app. Refer to the VMWare documentation for more information.
•  Only organization owners, or organization members with the Developer role, can create and manage OAuth devices. Refer to the VMWare documentation for more information. 

Setting your Workspace ONE Subdomain as a global variable

To save time when you create workflows, set your subdomain as a global variable:

1. From the menu, click Settings.
2. Click Global Settings.
3. Click Add new variable (+).
4. Add the WorkspaceONEUEM.Subdomain variable and its value. The value is the name of your Workspace ONE subdomain. If your Workspace ONE URL is https://mycompany.awmdm.comyour subdomain would be: mycompany.
5. Save your changes.

Add credentials to the vault in Oomnitza

To authorize connections between Oomnitza and Workspace ONE, complete these steps:

1. In Oomnitza, click Settings > Credentials.
2. Click Add new credential (+).
3. Add the information details.
4. Click the AUTHORIZATION tab.
5. Select VMware Workspace ONE UEMVMware Workspace ONE OAuth 2.0 from the SaaS dropdown.
6. Enter the Client ID and Client Secret obtained above. 
7. Enter the Api Region. Refer to Table 1: Workspace ONE API Regions.
8. Save your changes.

You use the credentials that you added to create and customize your Workspace ONE integration with Oomnitza.

Table 1: Workspace ONE API Regions

Region	Workspace ONE UEM SaaS Data Center Location	API Region
Ohio (United States)	All UAT environment	uat
Virginia (United States)	United States	na
Virginia (United States)	Canada	na
Frankfurt (Germany)	United Kingdom	emea
Frankfurt (Germany)	Germany	emea
Tokyo (Japan)	India	apac
Tokyo (Japan)	Japan	apac
Tokyo (Japan)	Singapore	apac
Tokyo (Japan)	Australia	apac
Tokyo (Japan)	Hong Kong	apac

Integrate Workspace ONE with Oomnitza

To configure the integration for Workspace ONE assets, complete the following steps:

1. In Oomnitza, click Settings > Integrations.
2. Click Integrations List View .
3. On the Integrations page, scroll down to the Extended section for Assets.
4. Click NEW INTEGRATION.
5. In the New Asset Integration sidebar, click VMWare Workspace ONE.
6. To integrate Oomnitza with the VMWare Workspace ONE Asset Load, click APPLY and then click NEXT twice.

On the connect page, complete the following steps to connect the integration:

1. Enter a descriptive name for the integration such as VMWare Workspace One Assets. This name will be displayed on the Integrations page once the setup is complete.
2. Select Cloud as the installation type.
3. From the Integration Preferences list, select Create & Update. 
4. Enter the name of the user of the integration.
5. Enter the Workspace ONE URL, for example:https://cn123.awmdm.com
6. Click Next.

Creating custom mappings

Map the Workspace ONE fields to Oomnitza fields and create custom mappings to get the user information that you need.

Complete these actions:

1. Create custom mappings to map any other field that you want to add to Oomnitza:
   1. Click the down arrow on the field that you want to map.
   2. Select Add new Oomnitza assets field.
   3. Change the name of the field.
   4. Click CREATE. 
2. Assign a sync key.
3. Click NEXT. 

Custom mappings

AC Line Status
Asset Number
Compliance Status
Compromised Status
Device Current Mobile Country Code
Device Friendly Name
Device SIM Mobile Country Code
Enrollment Status
ID
IMEI
Is Supervised
Last Compliance Check On
Last Compromised Check On
Last Enrolled On
Last Seen
Location Group ID
Location Group Name
Mac Address
Model
Model ID
Operating System
Ownership
Phone Number
Platform
Platform ID
Platform Name
Serial Number
UDID
User Email Address
User ID
User Name
Virtual Memory

 Learn more about mapping

When you've completed mapping Workspace ONE fields to Oomnitza fields, click NEXT.   

Schedule

By default, data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

1. Configure your schedule.
2. Click FINISH.

Result

A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see what information is collected now, click the tile on the Integrations page and click RUN NOW.

If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings.

 

Tip:
To view the information that is collected about your mobile assets, click Assets. 

Creating a workflow

Creating asset workflows with the API block

To reduce your workload and automate complex and repetitive tasks, you can create workflows with the API block by following the steps in Creating asset workflows with the API block. When creating the asset workflows with the API block for Workspace ONE, the following specific configuration is required:

To locate the available presets, enter VMware Workspace ONE in the Select Preset search field. Select your preset of choice and for every preset enter the following information in the Configure section:

1. Your correct Workspace ONE Credentials that you created in Add credentials to the vault in Oomnitza.
2. Your Subdomain should be derived from the variable created in Setting your Workspace ONE Subdomain as a global variable or entered manually. 

For information on the specific requirements for each preset, click one of the links below:

Activate Internal Application
Activate Public Application
Assign Smart Group to Internal Application 
Assign Smart Group to Public Application
Deactivate Internal Application
Deactivate Public Application
Delete Internal Application
Delete Public Application
Install Internal Application on Device
Install Public Application on Device
Install Purchased Application on Device
Internal Application Save
Remove Smart Group from Internal Application
Remove Smart Group from Public Application
Retire Internal Application
Uninstall Internal Application from Device
Uninstall Public Application from Device
Uninstall Purchased Application from Device
Unretire Internal Application 
Update Internal Application
Update Removal Logs 

For further information on creating workflows in Oomnitza see:

 Understanding workflows

 Workflow block overview

Using the VMware Workspace ONE UEM Activate Internal Application preset

The VMware Workspace ONE UEM Activate Internal Application preset enables administrators to activate an internal mobile application in Workspace ONE. If the application is already active, the workflow will proceed down the negative/exit path. When constructing a workflow that uses this preset, an Application ID must be specified to indicate the internal application to be activated.

Using the VMware Workspace ONE UEM Activate Public Application preset

The VMware Workspace ONE UEM Activate Public Application preset enables administrators to activate a public mobile application in Workspace ONE. If the application is already active, the workflow will proceed down the negative/exit path. When constructing a workflow that uses this preset, an Application ID must be specified to indicate the public application to be activated.

Using the VMware Workspace ONE UEM Assign Smart Group to Internal Application preset

The VMware Workspace ONE UEM Assign Smart Group to Internal Application preset enables administrators to assign a Smart Group to an internal mobile application in Workspace ONE. Devices that belong to the designated Smart Group are automatically provisioned over-the-air with the specified application. When constructing a workflow that uses this preset, the following information is required:

• App ID. The unique internal application identifier.
• Smart Group ID. Smart group id to be assigned to the application.

Using the VMware Workspace ONE UEM Assign Smart Group to Public Application preset

The VMware Workspace ONE UEM Assign Smart Group to Public Application preset enables administrators to assign a Smart Group to a public mobile application in Workspace ONE. Devices that belong to the designated Smart Group are automatically provisioned over-the-air with the specified application. When constructing a workflow that uses this preset, the following information is required:

• App ID. The unique internal application identifier.
• Smart Group ID. Smart group id to be assigned to the application.

Using the VMware Workspace ONE UEM Deactivate Internal Application preset

The VMware Workspace ONE UEM Deactivate Internal Application preset enables administrators to deactivate an internal mobile application in Workspace ONE. When constructing a workflow that uses this preset, an Application ID must be specified to indicate the internal application to be deactivated.

Using the VMware Workspace ONE UEM Deactivate Public Application preset

The VMware Workspace ONE UEM Deactivate Public Application preset enables administrators to deactivate a public mobile application in Workspace ONE. When constructing a workflow that uses this preset, an Application ID must be specified to indicate the public application to be deactivated.

Using the VMware Workspace ONE UEM Delete Internal Application preset

The VMware Workspace ONE UEM Delete Internal Application preset enables administrators to delete an internal mobile application from Workspace ONE. When constructing a workflow that uses this preset, an Application ID must be specified to indicate the internal application to be deleted.

Using the VMware Workspace ONE UEM Delete Public Application preset

The VMware Workspace ONE UEM Delete Public Application preset enables administrators to delete a public mobile application from Workspace ONE. When constructing a workflow that uses this preset, an Application ID must be specified to indicate the public application to be deleted.

Using the VMware Workspace ONE UEM Install Internal Application on Device preset

The VMware Workspace ONE UEM Install Internal Application preset enables administrators to install an internal mobile application on a device in Workspace ONE. When constructing a workflow that uses this preset, an Application ID and Serial Number must be specified to indicate the device and application to be installed.

By default, the Serial Number is used to identify the device. To use a different identifier for the device:

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Body tab. Update the Serial Number to any of the following device identifiers in the request body: Device Id, UDID, Mac Address.

Using the VMware Workspace ONE UEM Install Public Application on Device preset

The VMware Workspace ONE UEM Install Public Application on Device preset enables administrators to install a public mobile application on a device in Workspace ONE. When constructing a workflow that uses this preset, an Application ID and Serial Number must be specified to indicate the device and application to be installed.

By default, the Serial Number is used to identify the device. To use a different identifier for the device:

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Body tab. Update the Serial Number to any of the following device identifiers in the request body: Device Id, UDID, Mac Address.

Using the VMware Workspace ONE UEM Install Purchased Application on Device preset

The VMware Workspace ONE UEM Install Purchased Application on Device preset enables administrators to install a purchased mobile application on a device in Workspace ONE. When constructing a workflow that uses this preset, an Application ID and Serial Number must be specified to indicate the device and application to be installed.

By default, the Serial Number is used to identify the device. To use a different identifier for the device:

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Body tab. Update the Serial Number to any of the following device identifiers in the request body: Device Id, UDID, Mac Address.

Using the VMware Workspace ONE UEM Internal Application Save preset

The VMware Workspace ONE UEM Internal Application Save preset enables administrators to save a new internal mobile application in Workspace ONE. Once saved, an application can be associated to a device by assigning the application to a Smart Group. The following details are required when saving the new application:

• Blob Id. Prior to this API call, you should have obtained a Blob Id as a result of POSTing a binary file to /api/mam/blobs/uploadblob. 
• App Name. The desired application name.
• Developer Email. The email address of the developer.
• App Version. The version of the application.
• File Name. The name of the binary file (including extension) posted to /api/mam/blobs/uploadblob. 

Using the VMware Workspace ONE UEM Remove Smart Group from Internal Application preset

The VMware Workspace ONE UEM Remove Smart Group from Internal Application preset enables administrators to remove a Smart Group from an internal mobile application in Workspace ONE. When constructing a workflow that uses this preset, an Application ID and Smart Group ID must be specified to indicate which items are to be disassociated.

Using the VMware Workspace ONE UEM Remove Smart Group from Public Application preset

The VMware Workspace ONE UEM Remove Smart Group from Public Application preset enables administrators to remove a Smart Group from a public mobile application in Workspace ONE. When constructing a workflow that uses this preset, an Application ID and Smart Group ID must be specified to indicate which items are to be disassociated.

Using the VMware Workspace ONE UEM Retire Internal Application preset

The VMware Workspace ONE UEM Retire Internal Application preset enables administrators to retire an internal mobile application within Workspace ONE. If the application is already retired, the workflow will proceed down the negative/exit path. When constructing a workflow that uses this preset, an Application ID must be specified to indicate the internal application to be retired.

Using the VMware Workspace ONE UEM Uninstall Internal Application from Device preset

The VMware Workspace ONE UEM Uninstall Internal Application from Device preset enables administrators to uninstall an internal mobile application from a device in Workspace ONE. When constructing a workflow that uses this preset, an Application ID and Serial Number must be specified to indicate the device and application to be uninstalled.

By default, the Serial Number is used to identify the device. To use a different identifier for the device:

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Body tab. Update the Serial Number to any of the following device identifiers in the request body: Device Id, UDID, Mac Address.

Using the VMware Workspace ONE UEM Uninstall Public Application from Device preset

The  VMware Workspace ONE UEM Uninstall Public Application from Device preset preset enables administrators to uninstall a public mobile application from a device in Workspace ONE. When constructing a workflow that uses this preset, an Application ID and Serial Number must be specified to indicate the device and application to be uninstalled.

By default, the Serial Number is used to identify the device. To use a different identifier for the device:

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Body tab. Update the Serial Number to any of the following device identifiers in the request body: Device Id, UDID, Mac Address.

Using the VMware Workspace ONE UEM Uninstall Purchased Application from Device preset

The VMware Workspace ONE UEM Uninstall Purchased Application from Device preset enables administrators to uninstall a purchased mobile application from a device in Workspace ONE. When constructing a workflow that uses this preset, an Application ID and Serial Number must be specified to indicate the device and application to be uninstalled.

By default, the Serial Number is used to identify the device. To use a different identifier for the device:

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Body tab. Update the Serial Number to any of the following device identifiers in the request body: Device Id, UDID, Mac Address.

Using the VMware Workspace ONE UEM Unretire Internal Application preset

The VMware Workspace ONE UEM Unretire Internal Application preset enables administrators to unretire an internal mobile application within Workspace ONE. If the application is already unretired, the workflow will proceed down the negative/exit path. When constructing a workflow that uses this preset, an Application ID must be specified to indicate the internal application to be unretired.

Using the VMware Workspace ONE UEM Update Internal Application preset

The VMware Workspace ONE UEM Update Internal Application preset enables administrators to update an internal mobile application's details within Workspace ONE. The following details are required when updating the application:

• App ID. The unique internal application identifier to be updated.
• App Rank. The application rank.
• App Name. The desired application name.
• Auto Update Version. Defines if the application can be updated automatically. Boolean/False.
• Build Number. The build version of the file.
• Major Version. The major version of the file.
• Minor Version. The minor version of the file.
• Developer Email. The email address of the developer.
• Developer Phone. The phone number of the developer.
• Enable Provisioning. The provisioning status. Supported value is Boolean/False.
• Patch Type. The type of the uploaded patch. 
• Push Mode. The deployment mode for the applications. The values are 'auto' and 'ondemand’.
• Support Email. User defined email address of support.
• Support Phone. User defined phone number of support.

Using the VMware Workspace ONE UEM Update Removal Logs preset

The VMware Workspace ONE UEM Update Removal Logs preset enables administrators to update the removal logs in Workspace ONE. The following details are required when updating the logs:

• Threshold Id. The identifier for the log record.
• New Threshold Status. The action taken or to be taken by the administrator on the
  held commands. The values can be:
  • Held for admin approval
  • Commands released to devices
  • Commands dismissed from the queue.
• Organization Group ID. The unique identifier of the Organization Group.

Tip:
While not directly related to Workspace ONE APIs, the VMware AirWatch REST API Guide is a useful guide to refer to for additional information on the above presets.

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards for your users and software
• Configure custom reports about your users and software
• Create workflows to automate tasks

See  Getting started for more information.