Skip to main content
Sign in

Creating an extended integration for MobileIron assets

  • November 10, 2024 13:07
  • Updated

Let Oomnitza be your single source of truth!

Choose from two MobileIron asset integrations in Oomnitza to gain complete visibility of your assets as data from MobileIron is automatically transformed into consumable information and actionable insights.

1. MobileIron Cloud Asset Load
This integration gets a list of devices by Partition ID. The integration uses Version 1 of the /api/v1/deviceendpoint to fetch Android, iOS, OS X,  Windows, and user-related device information.

2. MobileIron Asset Load
This integration serves as a replacement for the MobileIron basic integration, encompassing all its essential features. It supports retrieving a list of devices by partition name and last check-in time, and is compatible with both version 1 and 2 of the endpoint.

Filter name Description
Include Check-In Devices only?  Select to include only devices that have been checked in.
Last Check-In Threshold: 

Specify a time-period in seconds to search for last checked-in devices. The threshold needs to be in seconds e.g. 604800 is 7 days in seconds. If an input is not provided, it will be set to 129600 (which is equivalent to 36 hours in seconds).

Important
You must enable Include Check-In Devices only? to search by Last Check-In Threshold
Partitions

The Partition Name, such as["Drivers"] or ["PartOne", "PartTwo"]. Required for API v1 and ignored for API v2.

For information on retrieving a partition name see Requesting the Partition Details.
API Version
 		Available options are 1 and 2. The cloud instances use version 1 by default. The CORE instances (on-premise installations) use version 2.

BlueLink.svgMobileIron Device Management API Version 2

BlueLink.svgMobileIron Device Management API Version 1

Information

When you create the integration with Oomnitza, you need to add your MobileIron credentials to Oomnitza. 

BlueLink.svgAdding your MobileIron credentials to Oomnitza

When you create the MobileIron Cloud Asset Load in Oomnitza, you need to supply your MobileIron Partition Id. For the MobileIron Asset Load, you need to supply the Partition Name.

For information on retrieving your Partition ID and name, see BlueLink.svgRequesting your MobileIron Partition ID

To save you time when creating multiple integrations and workflows, follow the steps in Adding global settings and add the URL as a global variable in Oomnitza:

For the MobileIron Cloud Asset Load:

  1. Add the following variable as the key: MobileIron.Cloud Url 
  2. Enter your MobileIron URL as the value without the leadinghttps:// prefix or .com suffix. If your URL is https://n2a.mobileiron.com, enter n2a.mobileiron. 

For the MobileIron Asset Load:

  1. Add the following variable as the key: MobileIron.URL
  2. Enter your full MobileIron URL as the value. You must include the leading https:// prefix and .com suffix. For example,  https://n2a.mobileiron.com.

Create the asset integration

  1. In Oomnitza, click Configuration> Integrations> Overview.
  2. Click Block view block_view.PNG
  3. Scroll down to the Extended section for asset integrations.
  4. Click NEW INTEGRATION.
  5. Select the integration in the sidebar.
  6. Click ADD.

Integration details overview

More information is provided about the following fields to help you complete the integration:

Installation type

Select Cloud if you want to store credentials in the Oomnitza cloud.

Select Local if you want to store credentials locally. Local extended integrations do not support AWS and OAuth authentication. If you want to sync Oomnitza with vendor applications that require AWS or OAUTH authentication, select Cloud.

Integration preferences

By default, the option Create & Update option is selected. Select this option  when you want to edit records and add new records. If you want to edit records and not add new records, select Update Only. If you only want to add new records, select Create Only.

Integration details

To review or update the integrations details, click Edit edit_black_pencil_icon.svg.

  1. Update the integration name if necessary. 
  2. Select an installation type.
  3. For integration preferences, select an option.
  4. Enter the name of the integration user.

Credential details

If you selected Cloud as the installation type, choose one of the following options:

  • Select the credentials that were created for the integration.
  • Edit the credentials that were created for the integration.
  • Create new credentials

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. Click the Edit edit_black_pencil_icon.svg.
  2. Configure your schedule.
  3. Click Update.

Mappings

To map the fields to Oomnitza, click Edit edit_black_pencil_icon.svg.

TipBulb_Icon_small.svgYou can define rules for your integration by selecting Edit integration edit_integration.svg on the mapping page. For example, you may only want to run the integration if a certain contact or region exists. See Filtering integration results.  
You can add new fields to your integration by selecting Add new field  add_grey_rectangel_icon.svg on the mapping page. All you need to do is specify the property name. See Creating custom API fields. 

MobileIron Cloud Asset Load mappings

Map MobileIron Cloud Asset Load fields to Oomnitza fields to get the asset information that you need. For the field mapping, it is recommended to follow these steps:

  1. Click SMART MAPPING. The Serial Number field is automatically mapped. 
  2. Create a custom mapping for the MobileIron Id. To do this, complete the following steps:
    1. Select the down arrow on the Id field that you want to map.
    2. Select Add new Oomnitza assets field.
    3. Change the name of the field to MobileIron Device Id.
    4. Click CREATE. 
  3. Create a custom mapping for the MobileIron Platform Type by following the steps above.
  4. Create a custom mapping for the MobileIron Windows Device Type by following the steps above. 
  5. You have the option to create custom mappings to map any other field that you want to add to Oomnitza.
  6. Map and assign a sync key to the MobileIron Device Id field.
  7. Click UPDATE.

MobileIron Cloud Asset Load Mappings

Action Exception Codes
Client Last Check In
Client Version
Compliance State
Country
Current Carrier Network
Current Mobile Country Code
Current Mobile Network Code
Device Model
Display Name
Email Address
First Name
ICCID
ID
IMEI
Kiosk State
Last Captured Location
Last Check In
Last Name
Last Registration Time
Latitude
Locale
Location Status Detail
Longitude
Manufacturer
Owner Id
Ownership Type
Phone Number
Platform Type
Platform Version
Policy Violation Count
Pretty Model
Registration State
Roaming
Serial Number*
Subscriber Carrier Network
Subscriber Mobile Country Code
Subscriber Mobile Network Code
Supervised
Support Lock Message
UDID
UID
Wifi Mac Address
Windows Device Type**

*The serial number is a non-unique value and can be blank in relation to Windows devices.

**This field determines if the device is a Windows device or not (it is blank for all devices except for Windows), which is important when running the Get Asset Details Workflow.

MobileIron Asset Load mappings

Map MobileIron Asset Load fields to Oomnitza fields to get the asset information that you need. For the field mapping, it is recommended to follow these steps:

  1. Click SMART MAPPING. The Serial Number field is automatically mapped. 
  2. Map and assign a sync key to the Serial Number field.
  3. Click UPDATE.

MobileIron Asset Load Mappings

Action Exception Codes
Client Last Check In
Client Version
Compliance State
Connect: Credentials
Connect: Include Check-In Devices only?
Connect: Last Check-In Threshold
Connect: Partitions
Connect: URL
Connector Sync Time
Country
Current Carrier Network
Current Mobile Country Code
Current Mobile Network Code
Device Model
Display Name
Email Address
First Name
ICCID
ID
IMEI
Kiosk State
Last Captured Location
Last Check In
Last Name
Last Registration Time
Latitude
Locale
Location Status Detail
Longitude
Manufacturer
Owner Id
Ownership Type
Phone Number
Platform Type
Platform Version
Policy Violation Count
Pretty Model
Primary HDD Size
Primary Memory Capacity
Primary Processor Cores
Primary Processor Name
Registration State
Roaming
Serial Number
Subscriber Carrier Network
Subscriber Mobile Country Code
Subscriber Mobile Network Code
Supervised
Support Lock Message
UDID
UID
Wifi Mac Address
Windows Device Type

Launching the integration

Your integration is in Draft mode until the required mandatory fields are added. When added, click Launch to activate your integration. 

small_blue_link.svg If you selected Cloud as the installation type when creating the integration, see Running an extended integration

small_blue_link.svg If you selected Local as the installation type when creating the integration, see Running an extended integration locally.

Viewing data ingested by Oomnitza

Viewing ingested asset data

For asset integrations, click Hardware. If the asset integration also ingests software data, click Software.

Viewing ingested user data

For user integrations, click People. If you chose the option to ingest User and SaaS user data, click Software > SaaS, click the SaaS app, and then click the Users tab. 

Related Links

Creating workflows

Oomnitza also offers the ability to retrieve additional asset details for Windows devices in MobileIron using a API Presets.

Warning
Use the Get Asset Details preset only for Windows devices! If you run this preset on devices other than Windows devices, it might degrade existing asset data in Oomnitza. Running the preset on Apple devices, might remove the serial numbers of the devices.

Get Asset Details Workflow

The MobileIron Get Asset Details workflow is an asset workflow that captures additional information about assets from MobileIron's API to help fill out your asset details. 

To utilize this workflow, you must have your MobileIron Device ID. This ID is returned when you run the MobileIron Cloud Asset Load.

  1. From the menu, you can select Configuration > Workflows > Assets to create an asset workflow. 
  2. Click Add (+). The Begin and End blocks are automatically added to the sandbox.
  3. Enter the name and a description of the workflow. 
  4. Edit the Begin block by adding the rules that will trigger the workflow. It is recommended that you:
    • Set the workflow to run for new records or on a schedule.
    • Enter the following Rule Criteria: Windows Device Type is not Empty, MobileIron Device Id is not Empty, Serial Number is Empty.
  5. Click the Blocks tab, and drag and drop the API block onto the canvas.
  6. Click the Edit icon.
  7. Enter Mobileiron in the Select Preset search field and choose the MobileIron Cloud Windows Hardware Inventory preset.
  8. Click the right arrow > to select your preset.
  9. In the Configure section, select the Credentials that you created in Adding your MobileIron credentials. Enter your MobileIron Cloud URL. Do not include https:// prefix or .com suffix when supplying your URL. If your URL is https://n2a.mobileiron.com, enter n2a.mobileiron.
  10. Click the Advanced Mode button located in the upper right of the window.
  11. Select the Information tab. The MobileIron device id is assumed to be stored in the variable{{mobileiron_device_id}}. If this is not correct, you can replace the variable {{mobileiron_device_id}} in the URL field with the correct id. 
  12. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. For information on creating custom fields, see Creating Custom Fields in Oomnitza. Once you have the entire response, you can then map individual JSON values to custom fields, as per the example below. For further information, refer to the Enhanced API Block.
  13. Connect the blocks.
  14. Save, validate, and activate your workflow.

Figure 1: Mapping the entire API response to individual Oomnitza fields using Jinja2 templating.

mobile_iron_response.png

Response field Description
{% set temp = response['result']['computerSystemProduct']%}{%if temp%}{{temp['identifyingNumber']}}{% endif %} Gets the System Identifying Number.

{% set temp = response['result']['processor']%}{%if temp%}{{temp[0]['name']}}{% endif %}

 Gets the Primary Processor Name.
{% set temp = response['result']['physicalMemory']%}{%if temp%}{{temp[0]['capacity']/1000000}}{% endif %} Gets the Primary Ram/Physical Memory
{% set temp = response['result']['hardDrive']%}{%if temp%}{{temp[0]['size']/1000000}}{% endif %} Gets the Primary Hard Drive name

articles_icon.svg Reference articles for workflows

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.

Related articles

Comments

0 comments

Please sign in to leave a comment.