Integrations

Cisco Meraki

Perch’s integration with Cisco Meraki allows you to store, search, and visualize data generated by your Meraki devices within Perch.

  1. Enable Dashboard API access and generate a Meraki API Dashboard Key
  2. Navigate to Settings > Cisco Meraki to install and configure the integration
  3. Test the connection
  4. Enjoy

Generate Cisco Meraki API Dashboard Key

In order for Perch to access your Meraki logs, you must provide Perch with an API token you generate within the Meraki Web dashboard. First, allow access to the API within Meraki’s dashboard and then generate the key.

Note:

The API key is associated with a Dashboard administrator account. You can generate, revoke, and regenerate your API key on your profile.
  • Login to the Meraki Console as an Admin
  • Navigate to Organization > Settings

  • Near the bottom of the page, locate and check the box for Enable access to the Cisco Meraki Dashboard API

  • Generate the API key. Click on your Username within the top navigation bar and click My Profile

  • Click on Generate a New API Token and copy it to your clipboard. (You’ll need it for the next step.) Don’t exit from the Meraki Portal as we will return for one final step.

Set up the integration in Perch

  • Login to the Perch app
  • Navigate to the Settings page
  • Scroll until you see the Cisco Meraki integration
  • Click Install
  • In the Perch Meraki authentication panel, paste your API Token

  • You need to Generate a new shared secret and copy to your clipboard, we recommend letting a password manager do this for you to ensure it is a unique and random password.

  • Paste the newly generated secret in the Cisco Meraki Shared Secret section of the Perch app.

  • Return to the Meraki Portal and navigate to Network-Wide > Alerts

  • Scroll to the bottom of the page to the Webhooks section and Create an HTTP Server

  • Provide a relevant name, paste in the Shared Secret, and return to the Perch app
  • Finally, copy the URL from the Perch settings page and paste it into the URL prompt on the Meraki Portal

  • Save all changes and test the integration

Enable log ingestion

Like all Perch integrations, you can enable or disable log ingestion at any time by toggling the switch from “OFF” ( gray ) to “ON” ( purple ), or vice versa.

Once you enable the log ingestion, you’ll receive a success message which you can toggle to see the health status of your integration.