Cisco Meraki Dashboard

View as Markdown

Community Platform

runZero imports Cisco Meraki Dashboard data through the Cisco Meraki Dashboard API. With your Meraki devices and network clients in runZero, you get better visibility of your network.

Getting started with Meraki

To set up the Meraki integration, you’ll need to:

  1. Generate an API key for your Cisco Meraki Dashboard administrator account.
  2. Add the Meraki credential to runZero.
  3. Choose whether to run the integration as a scan probe or connector task.
  4. Activate the integration to pull your data into runZero.

Requirements

Before you set up the Meraki integration:

  • Make sure you have administrator access to the Meraki Dashboard.

Step 1: Generate an API key in Cisco Meraki Dashboard

  1. Sign in to Cisco Meraki Dashboard with an administrator account.
  2. Check that access to the Cisco Meraki Dashboard API is enabled. Each organization you want to sync needs API access enabled.
    1. Go to Organization > Settings and enable API access under Dashboard API access.
  3. Go to My profile and generate an API key. The key inherits the permissions of the account that created it.

Step 2: Add the Meraki API key to runZero

  1. Go to the Credentials page in runZero.
  2. Choose Meraki API Key from the list of credential types.
  3. Give the credential a name, like Meraki.
  4. Fill in the connection details:
    • For Meraki API URL, enter the API endpoint URL for the Cisco Meraki Dashboard API.
    • For Meraki API key, enter the API key for the Cisco Meraki Dashboard administrator account.
  5. To let other organizations use this credential, select Make this a global credential. Otherwise, you can configure access per organization.
  6. Save the credential.

Step 3: Choose how to configure the Meraki integration

You can run the Meraki 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 integration to sync data

After you add your Meraki credential, set up the sync that pulls your data from Meraki.

Step 4a: Configure the Meraki 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 Meraki-only assets.

  1. Activate a connection to Meraki. You can reach every available third-party connection from the integrations page, your inventory, or the tasks page.
  2. Choose the credentials you added earlier. If they aren’t listed, check that they have access to the organization you’re currently in.
  3. Optionally, list the organization IDs or names to include in the import, separated by commas. runZero imports data only for the organizations you list.
  4. Optionally, list the network IDs or names to include in the import, separated by commas. runZero imports data only for the networks you list.
  5. Optionally, list the VLANs to exclude from the import, separated by commas. runZero skips devices associated with those VLANs.
  6. To exclude assets that have no VLAN, set the Exclude clients with no VLAN option to Yes.
  7. Optionally, list the SSIDs to exclude from the import, separated by commas. runZero skips devices connected on those SSIDs.
  8. Enter a name for the task, like Meraki Sync (optional).
  9. Choose the Explorer that runs this connector task (optional).
  10. Choose the site for your assets. runZero stores all newly discovered assets in this site.
  11. Enter a description for the task (optional).
  12. To leave out assets that runZero has not scanned, switch the Exclude unknown assets toggle to Yes. By default, the integration includes assets runZero has not scanned.
  13. Schedule the sync to run once or on a recurring schedule. It starts on the date and time you set.
  14. Activate the connection when you’re done. The sync runs on the schedule you defined, and Scheduled tasks shows when the next sync will occur.

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

When you run the Meraki integration as a scan probe, the runZero Explorer pulls your Meraki assets into the runZero Console.

In a new or existing scan configuration:

  • Set the MERAKI option to Yes in the Probes and SNMP tab and change any default options if needed.
  • Set the correct MERAKI credential to Yes in the Credentials tab.

Step 5: View Meraki assets

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

To filter for Meraki assets, run this query:

Click into any asset to see the attributes runZero gathered from Meraki. To narrow the results further, use the asset inventory search keywords.

Updated