Integrate with Mosyle MDM

If your district uses Mosyle, you can integrate it to sync your assets.

Users with the Manage Users and Permissions user permission can set up the integration.

Important: Because of the technical knowledge required, your district’s IT administrator (or someone with a similar role) should perform this procedure to integrate Mosyle.

Notes:

  • The Mosyle Devices integration will auto-sync every 24 hours.
  • Once a Mosyle device is synced, mapped fields on the asset record CANNOT be edited. Otherwise, most fields on the asset record are still editable.

  • The integration does the following in regards to asset creation:

    • Uses the serial number of the Mosyle device to uniquely identify it.
    • If it finds a matching serial number, it updates the existing IT Asset Manager asset record with the Mosyle information; if not, it creates a new asset record.
    • Brings over devices based on device model.

This is a two-step process:

  1. Obtain credentials from Mosyle.
  2. In IT Asset Manager, set up the Mosyle integration by completing the following tabs:

Obtain credentials from Mosyle

You will need the following credentials from Mosyle to complete the integration:

  1. Administrator email
  2. Password

    Note: If you need to change your Mosyle password, make sure the password is updated in IT Asset Manager on the Connection tab.

  3. Access token
    1. Select My School > Integrations > Mosyle API Integrations > Add New Token.
    2. Enter a Profile Name, such as IT Asset Manager.
    3. Ensure the Access Method is Public.
    4. Click Save.

Set up the Mosyle integration

Select Settings > Integrations > Mosyle Integration.

Step 1: Connection tab

Mosyle integration Connection tab.

The Connection tab requires you to have information from Mosyle to set up the link. Contact Mosyle support or refer to the Mosyle help documentation to obtain the needed information.

To set up a link to Mosyle:

  1. Enter your Administrator Email Address used to log in to your Mosyle account.
  2. Enter your administrator Password used to log in to your Mosyle account.
  3. Generate an Access Token from your Mosyle account.
  4. Click Save.
  5. To test the connection with your credentials, click Test.

    Note: Once the Mosyle integration is active, a green banner message appears at the top-left.

  6. Click Next to go to the Field Mapping tab.

Note: If you need to change your Mosyle login password, you must update the password on the Connection tab to match your latest Mosyle password.

Step 2: Field Mapping tab

Mosyle integration, Field Mapping tab.

The Serial # and Model fields are automatically mapped.

Note: If the Serial # field matches in both systems, the existing asset is updated. Otherwise, a new asset record is created.

Select the Mosyle field you want to map to the Asset Name and Barcode fields. The following fields are options:

  • Serial #
  • Asset tag
  • Mobile device name

Click Next to go to the Sync Rules tab.

Step 3: Sync Rules tab

Mosyle integration, Sync Rules tab.

Use this tab to customize the sync rules of how to update Mosyle when something happens in IT Asset Manager.

To set up the sync rules:

  1. Select/deselect the If Follett changes the Status to Lost > Set the item's Status in Mosyle to checkbox to enable/disable from syncing. From the drop-down, select one of the following:
    • Don't Change
    • Locked
    • Lost
    • Wiped
  2. To set up Mosyle-specific options based on what you selected in the drop-down, click Configure Options.
  3. From the and Move the item to Unmapped Mosyle Building drop-down, select Don't Move or the applicable building.
  4. Select/deselect the If Follett changes the Status to Stolen > Set the item's Status in Mosyle to checkbox to enable/disable from syncing. From the drop-down, select one of the following:
    • Don't Change
    • Locked
    • Lost
    • Wiped
  5. To set up Mosyle-specific options based on what you selected in the drop-down, click Configure Options.
  6. From the and Move the item to Unmapped Mosyle Building drop-down, select Don't Move or the applicable building.
  7. Select/deselect theIf Follett changes the Status To Available > Set the item's Status in Mosyle to Active and, if needed, Move the item to the mapped Mosyle Building checkbox to enable/disable from syncing.

  8. Select/deselect the If Follett changes the Building and/or Space > Move the item in Mosyle to the Mapped Mosyle Building checkbox to enable/disable from syncing. From the drop-down, select one of the following:

    • Don't Change
    • Locked
    • Lost
    • Wiped
  9. Select/deselect the If Follett deletes an asset > Set the item's Status in Mosyle to checkbox to enable/disable from syncing. From the drop-down, select one of the following:
    • Don't Change
    • Locked
    • Lost
    • Wiped
  10. From the and Move the item to Unmapped Mosyle Building drop-down, select Don't Move or the applicable building.Click Save Rules.
  11. Click Next to go to the Sync Data tab.

Step 4: Sync Data tab

Mosyle integration, Sync Data tab.

Use the Sync Data tab to add device groups. The sync brings in devices tagged to a group added on this tab.

Note: Follett recommends you create a single group, and put all devices you want to sync into IT Asset Manager into that group. This way, you only need to add one group.

To add a group, and sync your Apple devices:

  1. Click + Add Group.
  2. Select the group from the Mosyle Group Name drop-down.
  3. Select a Building and Space.
  4. Click Save.
  5. Click OK.
  6. To initiate a sync for the group, click Sync data icon..
  7. When the sync is complete, a pop-up shows the total number of devices, total updated, total added, and total not synced. Click OK.

Note: New devices and updates to existing assets from the MDM sync nightly, while sync rule actions are processed every 30 minutes.

Assets that are synced from Mosyle will show an Apple icon next to their name. You can click the Apple icon to open a window with all available Mosyle device fields.