Miradore MDM

View as Markdown

Community Platform

runZero integrates with Miradore mobile device management (MDM) to give you visibility into your mobile assets. The integration imports data from the Miradore API to enrich your asset inventory, so you can see each device’s hardware, OS version, associated user, and more. It imports all enrolled devices.

Getting started

To set up the Miradore integration:

  1. Sign in to your Miradore web portal and create a new API key.
  2. Add the Miradore credential to runZero, which includes the endpoint hostname and API key.
  3. Choose whether to run the integration as a scan probe or connector task.
  4. Activate the Miradore integration to sync your data with runZero.

Requirements

Before you set up the Miradore integration:

  • Make sure you have administrator access to the Miradore MDM portal.

Step 1: Create a Miradore API key

  1. Sign in to your Miradore portal as an administrator.
  2. Click System > Infrastructure diagram in the left-side navigation.
  3. Scroll down to the API node in the diagram. Click it and choose Create API key.
  4. Name the new key and copy the secret value.

Step 2: Add the Miradore credential to runZero

  1. Go to the Credentials page in runZero and click Add Credential.
  2. Provide a name for the credential, like Miradore MDM.
  3. Choose Miradore MDM API Key from the list of credential types.
  4. Provide the following information:
    • Name: A unique name for this credential (for example, Miradore)
    • Miradore endpoint hostname: The URL for your Miradore portal.
    • Miradore API key: The API key you created in step 1.
  5. Save the credential.

Step 3: Choose how to configure the Miradore integration

You can run the Miradore integration as either a scan probe or a connector task. A scan probe gathers integration data during a scan task. A connector task runs on its own, from the cloud or from one of your Explorers, and performs only the integration sync.

Step 4: Set up and activate the Miradore MDM integration to sync data

With your Miradore credential saved, set up a connector task or a scan probe to sync your data.

Step 4a: Configure the Miradore integration as a connector task

A connection needs a schedule and a site. The schedule sets when the sync runs, and the site is where runZero creates any new Miradore-only assets.

  1. Activate a connection to Miradore. You can reach every third-party connection from the integrations page, your inventory, or the tasks page.
  2. Choose the credential you added earlier. If it isn’t listed, make sure it has access to the organization you’re currently in.
  3. Enter a name for the task, like Miradore sync.
  4. Schedule the sync to run once or on a recurring schedule. The schedule starts on the date and time you set.
  5. Under Task configuration, choose the site to add your assets to. runZero stores all newly discovered assets in this site.
  6. To leave out assets that runZero has not scanned, switch the Exclude unknown assets toggle to Yes. By default, the integration includes them.
  7. Activate the connection. The sync runs on the schedule you defined, and the Scheduled tasks page shows when the next sync will occur.

Step 4b: Configure the Miradore integration as a scan probe

  1. Create a new scan task or select a future or recurring scan task from your Tasks page.
  2. Add or update the scan parameters to fit any additional requirements.
  3. On the Probes and SNMP tab, choose any additional probes to include, set the Miradore toggle to Yes, and change any default options as needed.
  4. On the Credentials tab, set the Miradore toggle to Yes for the credential you want to use.
  5. Click Initialize scan to save the scan task. It runs immediately or at the scheduled time.

Step 5: View Miradore assets

After a successful sync, go to your inventory to view your Miradore assets. They show a Miradore icon in the Source column.

To filter for Miradore assets, try this query:

Click into an asset to see the attributes the Miradore API returned. To write your own queries, start with the search query syntax.

Troubleshooting

If the integration isn’t working, start with these checks.

Why is the Miradore integration unable to connect?

  1. Check whether the Miradore integration is returning any data.
    • Query the inventory rather than the task details to review all the data available from this integration.
    • In some cases, an integration’s configuration limits how much data reaches the runZero console.
  2. Some integrations require specific actions that are easy to overlook. If you miss a step during setup, the integration may not work correctly. Review this page and follow the steps exactly.
  3. If the Miradore integration can’t connect, check the task log for errors. Common errors include:
    • 500: server error, unable to connect to the endpoint
    • 404: hitting an unknown endpoint on the server
    • 403: not authorized, likely a credential issue
  4. If Miradore is on-premises, verify that the integration task runs from an Explorer with access to the Miradore host.
Updated