Creating a basic integration for VMware Workspace ONE Assets

Let Oomnitza be your single source of truth!

You'll get visibility of all the network devices in your organization as data from Workspace ONE is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Workspace One in minutes

Get the information and the insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key information for network devices
• Configurable reports to share information about network devices with your colleagues and management

Extended integration for Workspace ONE
The basic integration retrieves key information about all the network devices in your organization. For further information see Workspace ONE UEM API Explorer.

Before you start

To stream asset data from Workspace ONE to Oomnitza, you must complete these tasks:

• Download the source code for the Oomnitza connector
• Generate a configuration file
• Edit the configuration file

Download the source code for the Oomnitza connector

1. Log into Oomnitza.
2. Click Configuration > Integrations and then click Integration List View .
3. In the Basic section for Asset Integrations, click the Workspace One tile.
4. Download the source code.    

Learn more
On the Info page, click READ DOCUMENTATION and scroll down and click Getting started. 

Generate a configuration file for the Oomnitza connector

To find out how to generate the configuration file, read the Connector Configs section in the Getting started document.

Edit the configuration file

You must modify the following sections in the configuration file:

• The Oomnitza section
• The Workspace ONE settings

Before you edit the configuration file, you must retrieve the following information:   

Your Oomnitza token

1. Open the configuration file that you generated in edit mode.
2. In the Oomnitza section, enter the URL of your Oomnitza instance and enter the API token that you generated in Oomnitza. For information on how to generate an API key in Oomnitza, refer to Creating an API Token.
   

   Oomnitza configuration settings 
   [oomnitza]
url= https://<name_of_instance>.oomnitza.com line
api token = <my_Oomnitza_token> 

3. In the Workspace ONE section, make the following changes:
   • Set enable to True.
   • Enter the below details relating to your Workspace ONE account.

   Workspace ONE settings 
   [workspaceone_devicesoftware]
   enabled = True
 subdomain = techp
 client_id = ***
 client_secret= ***
 region = na

4. Delete the remaining information in the configuration file, as this relates to other vendors.
5. Save your changes

Map Workspace ONE fields to Oomnitza fields

To get the information that you need to manage your network devices, complete these actions:

1. Click Configuration > Integrations.
2. In the Basic section for Asset Integrations, click the Workspace ONE tile.
3. Click Mappings.
4. Map the Workspace ONE fields to the Oomnitza fields.  
5. Select a unique identifier such as the Serial Number as the sync key, which will synchronize the data that is streamed from Workspace ONE to Oomnitza.
6. Click FINISH.

Custom Workspace ONE mappings

You can map the following fields to Oomnitza:

Available Device Capacity
Compliance Status
Compromised Status
Device Capacity
Device Friendly Name
Device ID
Device Reported Name
Enrollment Status
Is Supervised
Last Compliance Check On
Last Compromised Check On
MAC Address
Model
Serial Number
Udid

Want to map more fields to Oomnitza?
Contact Support, or see Mapping extended connectors.

Run the Workspace ONE connector

To upload the network device information to Oomnitza, run the connector.

Run the connector in test mode to ensure that the mapped information is uploaded to Oomnitza:

python connector.py upload workspaceone_devicesoftware --testmode

When you are confident that you are uploading the information that you mapped, run the connector again in normal mode:

python connector.py upload workspaceone_devicesoftware

1. Click Configuration > Integrations.
2. In the Basic section for Asset Integrations, click the Workspace ONE tile.
3. Click SYNC SESSIONS and review the information that is uploaded.

Schedule
To find out how to schedule the Workspace ONE integration, contact Support.

Unleash the power of Oomnitza

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

• Configure dashboards for your assets
• Configure custom reports about your assets 

See Getting started.