Skip to main content
Sign in

Creating an extended integration for Cisco Meraki assets

  • July 19, 2024 16:37
  • Updated

Let Oomnitza be your single source of truth!

Choose from four Cisco Meraki asset integrations in Oomnitza to gain complete visibility of your assets as data from Cisco Meraki is automatically transformed into consumable information and actionable insights.

Cisco Meraki Inventory Asset Load: Returns the device inventory for an organization. An organization id is required to run this integration. For further information, refer to the Meraki API Documentation: Get Organization Inventory Devices.

Cisco Meraki Network Devices Asset Load: Returns the devices in a network. A network id is required to run this integration. For further information, refer to the Meraki API Documentation: Get Network Devices.

Cisco Meraki SM Devices Asset Load: Returns the devices enrolled in an SM network. A network id is required to run this integration. For further information, refer to the Meraki API Documentation: Get Network Sm Devices.

Cisco Meraki Asset Load: Created as a replacement for the Cisco Meraki basic integration. This means it contains all the functionality of the basic integration, such as retrieving a list of organization networks, network devices, as well as inventory devices. An organization id is required to run this integration.

Connect Oomnitza and Cisco Meraki in minutes

Get the information and 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 asset information
  • Configurable reports to share information about your assets  with your colleagues and management
  • Configurable workflows that you can easily create to automate tasks such as:
    • Workflows for claiming devices
    • Workflows for removing devices
    • Workflows retrieving network device and network inventory details

Navigation

  1. Before you start
    1. Obtain your Cisco Meraki API key
    2. Add your Cisco Meraki API key to Oomnitza
    3. Obtain your Cisco Meraki Organization ID and Network ID
    4. Add your Cisco Meraki Organization ID to the global settings
  2. Create the asset integration
  3. Create workflows

Before you start

Obtain your Cisco Meraki API key

Best practice
For the integration with Oomnitza, instead of using an existing user account, create a dedicated user account with its own credentials.

The Cisco Meraki API uses API Key authentication and requires your API key to be added to Oomnitza. 

To obtain your API key, complete the following steps:

  1. Log in or sign-up for a Meraki account here
  2. Go to Organization>Settings > Dashboard API access
  3. Select the Enable access to the Cisco Meraki Dashboard API checkbox
  4. Select My Profile from your user profile in the upper right of the window.
  5. In the API access section, click Generate new API key
  6. Copy your API key immediately for use in Oomnitza. 

Add your Cisco Meraki API key to Oomnitza

To authorize connections between Oomnitza and Cisco Meraki, complete these steps:

  1. In Oomnitza, click Configuration > Security > Credentials.
  2. Click Add new credential (+).
  3. Search for the integration, and then click the forward button > to select the integration.
  4. Add your API key.
  5. Click Create.

Integration not in the list? Click Advanced Mode and complete these steps:

  1. Add the information details.
  2. Click the AUTHORIZATION tab.
  3. Ensure that API Key is selected as the Authorization type.
  4. Ensure that the Token Name is X-Cisco-Meraki-API-Key
  5. Enter the API Key. 
  6. In the Add to field, ensure that Header is selected.
  7. Click Authenticate. 
  8. Click CREATE. 

Useful links

blue_link.svg Authorization: Get your Meraki API Key

blue_link.svg Find your Meraki network ID

blue_link.svgGet organization networks

Obtain your Cisco Meraki Organization ID and Network ID

To get started with Cisco Meraki and Oomnitza, you need your Meraki Organization ID and Network ID. To retrieve this:

  1. Log into Meraki
  2. Go to https://dashboard.meraki.com/api/v0/organizations and get the Organization ID of your organization. Your id is returned in the id, for example [{"id":"1234567"}].
  3. Go to https://dashboard.meraki.com/api/v0/organizations/{organization_id}/networks, entering the Organization ID you just retrieved, and get the desired Network ID

Add your Cisco Meraki Organization ID to the global settings

To save time entering information when you create workflows, you can add your Cisco Meraki Organization ID as a global variable in Oomnitza.

  1. In Oomnitza, click Configuration > General > Global Settings.
  2. Click Add new variable (+). 
  3. Enter Meraki.Organization Id as the variable name.
  4. Enter your organization ID.
  5. Click SAVE.

Create the asset integration

To create an asset integration, complete the following steps:

  1. In Oomnitza, click Configuration> Integrations> Overview.
  2. Click Block view block_view.PNG
  3. Scroll down to the Extended section for asset integrations.
  4. Click NEW INTEGRATION.
  5. Select the integration in the sidebar.
  6. Click ADD.

Integration Overview

More information is provided about the following fields to help you complete the integration:

  • Integration preferences:  By default, the option Create & Update is selected, which allows for editing existing asset records and adding new ones. If your goal is only to edit existing asset records, choose Update Only. On the other hand, if you only want to add new records, select Create Only.

Integration details

To review or update the integrations details, click the pencil:

  1. Update the integration name if necessary. 
  2. For installation type decide whether you want to store the credentials locally or in Oomnitza:
    1. Select Local if you want to store credentials locally. This mode does not support OAuth or AWS authentication.
    2. Select Cloud if you want to store credentials in your Oomnitza instance.
  3. For integration preferences, select an option.
  4. Enter the name of the integration user.

Credential details

Choose one of the following options:

  • Select the credentials that were created for the integration.
  • Edit the credentials that were created for the integration.
  • Create new credentials

Schedule

By default, user data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

  1. Click the pencil.
  2. Configure your schedule.
  3. Click Update.

Mappings

To map the fields to Oomnitza, click the pencil.

Create custom mappings

Map Meraki fields to Oomnitza fields to get the asset information that you need. For the field mapping, it is recommended to follow these steps:

  1. Click Smart Mapping to automatically detect appropriate mapping fields. Values from the integration can also be dragged to the appropriate field on the Oomnitza side, or selected from the integration field dropdown.
  2. Create a custom mapping for the Network Id field. To create a custom mapping, do the following:
    1. Click the down arrow on the Network Id field.
    2. Select Add new Oomnitza assets field.
    3. Change the name of the field to Meraki Network ID.
    4. Click CREATE. 
  3. Map and assign a sync key to the Serial Number field.
  4. Click UPDATE.

Cisco Meraki Inventory to Oomnitza mappings

Claimed At
Connector Sync Time
Device Name
License Expiration Date
MAC Address
Model
Network Id
Order Number
Product Type
Serial Number
Tags List

Cisco Meraki Network to Oomnitza mappings

Address
Beacon Id Params Major
Beacon Id Params Minor
Beacon Id Params Uuid
Connector Sync Time
Firmware
Floor Plan Id
Lan Ip
Lat
Lng
Mac
Model
Name
Network Id
Notes
Serial Number
Tags List
Url
Wan1 Ip
Wan2 Ip

Cisco Meraki SM Devices to Oomnitza mappings

Connector Sync Time
IMEI
Last User
Location
MEID
Name
OS
Owner Email
Phone Number
Public IP Address
SSID
Serial Number
System Model
System Type
Wifi MAC Address

Cisco Meraki Asset Load to Oomnitza mappings

Address
Beacon Id Params Major
Beacon Id Params Minor
Beacon Id Params Uuid
Connect: Credentials
Connect: Organization Id
Connector Sync Time
Firmware
Floor Plan Id
Lan Ip
Lat
Lng
Mac
Model
Name
Network Id
Notes
Serial Number
Tags List
Url
Wan1 Ip
Wan2 Ip

Did you know? 
You can define rules for your integration by selecting Edit integration edit_integration.svg on the mapping page. For example, you may only want to run the integration if a certain contact or region exists. See Filtering integration results.  

You can add new fields to your integration by selecting Add new field  add_grey_rectangel_icon.svg on the mapping page. All you need to do is specify the property name. See Creating custom API fields. 

Launching the integration

Your integration is in Draft mode until all the required mandatory fields are added. Once you have added all of the required fields, select Launch to activate your integration. 

small_blue_link.svg If you selected Cloud as the installation type when creating the integration, refer to Running an extended integration

small_blue_link.svg If you selected Local as the installation type when creating the integration, refer to Running an extended integration locally.

Getting your results
To view the information that is collected about your assets, click Assets. To view the information about software, click the Software tab.  
To view the information that is collected about your users, click People. If you selected User plus SaaS User when running the user integration, you can also find a list of users in the Software > SaaS menu

Related Links

Use API presets to create network asset workflows

To add a preset to a workflow, complete these steps:

  1. Click Configuration > Workflows 
  2. Click Add (+) and select Assets from the list.
  3. Drag and drop the API block onto the Sandbox.
  4. Click Edit on the API block.
  5. Enter Meraki to search for the presets.
  6. Select a preset:
    • Cisco Meraki Claim Network Information
    • Cisco Meraki Claim Network Device
    • Cisco Meraki Remove Network Device
    • Cisco Meraki Inventory Device Details
    • Cisco Meraki Network Device Details
  7. Configure and save your changes. 
  8. Edit the Begin block to set the trigger for the workflow.
  9. Connect the three blocks together.
  10. Save, validate, and activate your workflow.

blue_link.svg Understanding workflows

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
  • Configure workflows for automating complex and repetitive tasks

blue_link.svg See Getting started

Related articles

Comments

0 comments

Please sign in to leave a comment.