Skip to main content

Mosyle Asset MDM - Configuring Settings

Mosyle Asset MDM - Configuring Settings

Accessing App Management

You can edit installation information using the management options.

  1. Go to the Apps Management page by selecting Incident IQ Apps > Manage on the left navigation bar.

  2. Locate your desired MDM application and select Manage to the right.



Overview Tab

Use this tab to review sync performance.

  • View Detailed Log: Opens the history of the last scheduled sync.

  • Start Full Sync: Manually trigger a new sync.

  • Re-Run Last Sync: Repeat the most recent sync process.

  • Push Data: Send data directly to the MDM integration

Please note that Incident IQ uses the owner's email field when looking up the user in Mosyle.



General Settings Tab

This tab controls automatic sync triggers, field mappings, and integration behaviors.

Authentication Section

View and manage authentication credentials:

  • Username

  • Password

  • Access Token

Mapping Section

  • Create Asset: Automatically creates an iiQ asset for every new device discovered during a sync.

  • Update Asset: Automatically updates existing iiQ assets based on new data discovered during a sync.

  • Update Custom Fields: Updates only new custom field data during a sync.

Import Options Section

  • Create Rooms Option: Enabling this will automatically create rooms for assets found in the integration if they do not already exist in iiQ.

Matching Rules Section

This section controls how devices are matched. These rules are read-only for customers (editable by iiQ Admin Employees):

  • Use the serial number as the primary matching identifier.

  • Prefer the serial number over the asset tag.

  • Skip creation if the Google asset lacks a serial number.

  • Allow only one asset per serial number.

  • Restore deleted assets if a match is found.

Map Custom Values Section

Map additional values to default or custom fields in iiQ:

Click ‘Add’ located near the end of the section.

Please note that there may be pre-configured mappings that cannot be changed.

  1. Select the custom value.

  2. Set Map Direction:

    • MDM to Incident IQ

    • Incident IQ to MDM

    • Both directions (Data pushes from iiQ to the MDM first)

    • Note: The fields asset tag, tags, device name, lock message, and user ID are currently supported only for syncing from iiQ to Intune.

  3. Select iiQ Field: Map to a default or custom field. (Custom fields require a field name, type [text/number/date], and searchability settings).

    • Updating Owner Data: Districts can map the "Owner" of devices from iiQ to the "userid" field in Mosyle. This allows for automatic updates of Owner data through nightly syncs or manual push syncs whenever an asset is assigned or unassigned. If an asset is unassigned, the "userid" field in Mosyle will be cleared.

Please note that Incident IQ uses the owner's email field when looking up the user in Mosyle.

MDM Options Section

Control how iiQ updates the owner field using the following drop-down options:

  • Don’t automatically update asset owner in iiQ: Disables owner field synchronization.

  • Automatically update owner in iiQ based on User ID: Updates device ownership based on the User ID field in Mosyle.

  • Automatically update owner in iiQ based on User Name: Updates device ownership based on the User Name field in Mosyle.

Additional Owner Options (if either automatic update is selected):

  • Remove existing owner in iiQ if the MDM field is empty.

  • Remove existing owner in iiQ if the MDM field cannot be matched to a valid user.

Perform Actions on Devices Section

Manage whether authorized users can remotely manage devices:

  • Enable remove device actions in MDM integration: Allows users with permission to perform remote device actions.



Location Mappings Tab

Manage how locations sync between Incident IQ and the integration.

Location is required for an asset to be created in iiQ.

Default Mapping Section

Set or change the default location for assets with no specific location mapped.

Custom Mapping Options

  • Auto-Map Location Names: Automatically matches location names between the two systems.

  • Manual Selection: Manually search for and select specific location assignments if necessary.

  • Map by Location Name: This feature automatically assigns an asset to its owner's location.



Models Mappings Tab

Select or modify model mappings to ensure devices are correctly categorized in iiQ.

Unmapped models will not be imported into iiQ.

  • Auto-Map Models: Attempts to match device models from your list with existing models in iiQ.

  • Manual Mapping: Use the drop-down menus next to each device to select the correct model.

  • Create New Model: If a device does not auto-map and isn't in the drop-down list, click this button to automatically create and activate the model during the next data sync.



Sync History Tab

Provides a historical log of every synchronization attempt between iiQ and the integration.

  • Sync Details: Clicking any entry in the list displays a breakdown of the sync, including which devices were updated, created, deleted, or skipped.

  • Audit Filtering: Use the filter options at the top of the list to narrow your review by status or time.



Asset History Tab

Searchable database of basic device information found in the integration.

  • Search: Enter a valid serial number to retrieve specific device information.

  • Available Metadata:

    • External ID

    • Model

    • Owner Email

    • Organizational Unit

    • Serial Number

    • Location Name

  • Action Log: View a history of actions applied to the device during recent system syncs.



Remote Device Actions

Found within the General Settings tab at the bottom of the page, you can enable remote device management, allowing authorized administrators and agents with the correct permissions to interact with devices directly from the asset’s details page in Incident IQ.

Available Actions

  • Wipe Device

  • Restart Device

  • Shutdown Device

  • Set Lost-Mode Options

  • Clear Commands

You can perform actions on the asset details page.

Configuration & Permissions Notes:

  • Default Access: Administrators are granted full access to all remote feature permissions by default.

  • Granular Control: Each remote feature listed above is controlled by an individual permission, allowing for customized access levels per agent.

  • Permission Management: Configure these settings under the App Specific section on the policies and individual user permissions pages.

Did this answer your question?