Cisco Meraki

Cisco Meraki

Starting IP Fabric version 3.5.0, IP Fabric supports API-based discovery for Cisco Meraki.

Meraki requires the following settings to be applied:

  • API key - Generated in Meraki dashboard

  • Organizations ID - You can specify which organization will be included in the discovery process. If you do not specify, all available IDs will be used

  • Version - Meraki currently provides only a v0 version of their API. This version has a lot of limitations (Meraki known issues)

  • Base URL - URL is supported in the following format https://nXYZ.meraki.com/api. Be aware that the dashboard can redirect communication to a different URL

Management IP for Cisco Meraki

For the CLI (SSH/Telnet) discovery, the Management IP represents the login IP address that the platform used to discover the device. Cisco Meraki is discovered via API and therefore different logic is used to create management IP parameters for Meraki devices

1 2 3 4 5 6 7 8 LAN IP is considered to have the highest priority setIps('lanIp'); wan1Ip has the 2nd highest priority setIps('wan1Ip'); wan2Ip has the 3rd highest priority setIps('wan2Ip'); publicIp has the lowest priority setIps('publicIp');

PublicIP parameter can be duplicit as more devices can be accessed via the same public IP address. It can also be inaccurate (e.g. when WAN circuit fails over to secondary it can take quite longe until the device public IP is refreshed in dashboard. PublicIp property is currently not provided by organizationsDevices.

To understand what is being sent from Meraki’s Dashboard, we need to look into the Discovery Snapshot and download the Tasker information:

The Tasker file contains complete communication between IP Fabric and Meraki Dashboard. We can use the device hostname to locate the JSON source:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 { "name":"mx01-dl1", "serial":"Q2QN-Q6EY-NP7J", "mac":"0c:8d:db:b0:c2:dc", "networkId":"L_783626335162466320", "model":"MX65", "address":"", "lat":37.4180951010362, "lng":-122.098531723022, "notes":"", "tags":"", "wan1Ip":"192.168.128.4", "wan2Ip":null, "configurationUpdatedAt":"2022-03-05T15:07:48Z", "firmware":"wired-15-44", "url":"https://XXX.meraki.com/DevNetLab-applia/n/xaNlkcig/manage/nodes/new_list/456789654858" }