Skip to main content



Cisco Defense Orchestrator

Onboard Meraki MX to Defense Orchestrator

Note: CDO silently converts invalid CIDR prefix notation IP addresses and IP address ranges to valid form by zeroing all bits associated with the host.

MX devices can be managed by both Cisco Defense Orchestrator (CDO) and the Meraki dashboard. Note that CDO deploys configuration changes to the Meraki dashboard, which in turn deploys the configuration securely to the device.  See How Does CDO Communicate With Meraki for more information. 

To onboard a MX device to CDO, you must first register a device in the Meraki dashboard. Without having access to the Meraki dashboard, your organization will not be recognized by the Meraki cloud and you will not be able to generate an API token to onboard your device. Onboarding a device requires two steps:

  1. Generate and retrieve a Meraki API key. When you onboard a Meraki MX device, you must generate a Meraki API key. The key authenticates the dashboard and allows you to securely onboard a device.
  2. Onboard a Meraki Device to CDO using the key.

Generate and Retrieve Meraki API Key

Use this procedure to enable CDO access to the Meraki dashboard with API access:

  1. Log into the Meraki dashboard.
  2. In the navigation panel click Organization > Settings.
  3. Under Dashboard API Access, check Enable access to the Cisco Meraki Dashboard API. Without this option, you cannot generate API keys to onboard MX devices to CDO.
  4. Click Save changes
  5. On the Meraki dashboard, click on your username in the upper right corner of the screen and then click My Profile
  6. Locate the API access header and click Generate new API key. Copy this API key. We recommend temporarily pasting it into a note until you are ready to use it. If you close the copy source before you paste the API key, you lose the copied API key. 

Note: You only need one API key per device. You can re-onboard a Meraki device without generating a new key.

Onboard an MX Device to CDO

Use this procedure to onboard a Cisco Meraki device:

  1. In the navigation pane, click Devices & Services
  2. Click the blue plus button blue_cross_button.png and click the Meraki tile. 
  3. Select the Secure Device Connector (SDC) that this device will communicate with. The default SDC is displayed but you can change it by clicking the SDC name.
  4. Paste the API access key you copied. If the key is incomplete or incorrect, you will not be able to onboard the device. Click Connect. 
  5. Use the drop-down menu to select the correct Organization. The generated list of organizations are retrieved from the Meraki dashboard and includes devices and templates. Select the desired device and click Select.
  6. Use the drop-down menu to select the correct Network. The generated list of networks are retrieved from the Meraki network. Click Select.
  7. Optionally, you can add unique Labels for the device. You can later filter your list of devices by this label.
  8. Click Continue. The device begins the onboarding process. Once completed, CDO redirects you to Devices & Services

Note: MX devices do not have to be connected to the Meraki Cloud in order to be managed by CDO. If a MX device has never connected to the cloud, the device connectivity is listed as unreachable. This is normal, and does not affect your ability to manage or deploy policies to this device. 

Related Articles

  • Was this article helpful?