Creating a basic integration for Cisco Meraki Network assets

Let Oomnitza be your single source of truth!

You'll get visibility of all the network devices in your organization as data from Cisco Meraki is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Cisco Meraki in minutes

Get the information and the insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key information for network devices
• Configurable reports to share information about network devices with your colleagues and management
• Configurable workflows for getting inventory and device details 

Extended connector integration for Cisco Meraki
Basic integration will continue to work and is fully supported for existing users. For new users, it is recommended that you use extended integrations as your integration of choice. Extended connector integrations provide enhanced capability. While the basic integration retrieves key information about all the network devices in your organization, the extended connector integration retrieves information about all the devices in a network. Extended connector integrations are also significantly easier to setup and maintain. Refer to Extended connector integration for Cisco Meraki Network Devices for further information. 

Before you start

To stream asset data from Cisco Meraki to Oomnitza, you must complete these tasks:

• Download the source code for the Oomnitza connector
• Generate a configuration file
• Edit the configuration file

Download the source code for the Oomnitza connector

1. Log into Oomnitza.
2. Click Settings > Integrations.
3. In the Basic section for Asset Integrations, click the Cisco Meraki Network Devices tile.
4. Download the source code.    

Learn more
On the Info page, click READ DOCUMENTATION and scroll down and click Getting started. 

Generate a configuration file for the Oomnitza connector

To find out how to generate the configuration file, read the Connector Configs section in the Getting started document.

Edit the configuration file

You must modify the following sections in the configuration file:

• The Oomnitza section
• The Cisco Meraki network devices section

Before you edit the configuration file, you must retrieve the following information:   

Your Oomnitza token

Your Cisco Meraki API key

Your Organization ID

1. Open the configuration file that you generated in edit mode.
2. In the Oomnitza section, enter the URL of your Oomnitza instance and enter the API token that you generated in Oomnitza. 
   

   Oomnitza configuration settings 
   [oomnitza]
url= https://<name_of_instance>.oomnitza.com line
api token = <my_Oomnitza_token> 

3. In the Meraki network devices section, make the following changes:
   • Set enable to True.
   • Enter your Meraki API key
   • Enter your Meraki Organization ID

   Meraki network device settings 
   [meraki_network_devices]
enable = True
meraki_api_key = <my_Meraki_key>
org_id = <my_Meraki_organization_id 

4. Save your changes.

Map Cisco Meraki fields to Oomnitza fields

To get the information that you need to manage your network devices, complete these actions:

1. Click Settings > Integrations.
2. In the Basic section for Asset Integrations, click the Cisco Meraki Network Devices tile.
3. Click Mappings.
4. Map the Cisco Meraki fields to the Oomnitza fields.  
5. Select the Serial Number as the sync key, which will synchronize the data that is streamed from Cisco Meraki to Oomnitza.
6. Click FINISH.

Custom Cisco Meraki mappings

You can map the following fields to Oomnitza:

• Device Network ID
• MAC Address
• Model
• Serial Number

Want to map more Cisco Meraki fields to Oomnitza?
Contact Support, or see Mapping extended connectors.

Run the Cisco Meraki network devices connector

To upload the network device information to Oomnitza, run the connector.

Run the connector in test mode to ensure that the mapped information is uploaded to Oomnitza:

python connector.py upload meraki_network_devices --testmode

When you are confident that you are uploading the information that you mapped, run the connector again in normal mode:

python connector.py upload meraki_network_devices

1. Click Settings > Integrations.
2. In the Basic section for Asset Integrations, click the Cisco Meraki Network Devices tile.
3. Click SYNC SESSIONS.
4. Go to the Assets page and review the information that is uploaded.

Schedule
To find out how to schedule the Cisco Meraki integration, contact Support.

Use API presets to create asset workflows

Add the workflow blocks

1. Click Software > Workflow.
2. Click Add (+). A Begin and End block is automatically added to the workspace.
3. Enter a name and description. 
4. Click the Blocks tab.
5. In the Integrations section, drag and drop the API block into the workspace.

Edit the API block

1. Click Edit on the API block.
2. Enter Cisco Meraki to search for the presets.
3. Select a preset:
   • Cisco Meraki Inventory Device Details   
   • Cisco Meraki Network Device Details

Configure the workflows

To create the workflows for these presets, you must complete these steps:

1. Click Advanced Mode.
2. Click the RESPONSE tab. Create a response field to retrieve information from Cisco Meraki. Before you paste this code into the response field, replace the variable names <field.name>, with the IDs of the Cisco Meraki fields:{% if response and response.<field_name>%}{{ response.<field_name> }}{% else %}{% endif %}. You can create multiple response fields, which you can map to Oomnitza fields.
3. Map the response field or fields to Oomnitza fields. 
4. Save your changes.

Set the workflow trigger, and test and save the workflow  

1. Edit the Begin block to schedule and trigger the workflow.

2. Connect the blocks.
3. Validate, launch, and save your workflow.

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards for your assets
• Configure custom reports about your assets 

See Getting started.