How do I set up Meraki Webhooks to raise events in Entuity EMS?

Prerequisites to setting up Meraki Webhooks in Entuity

To set up Meraki Webhooks in Entuity

To enable or disable a webhook

From ENA v17.0 P08 upwards, Entuity provides support for customer-defined events within the Entuity Event Management System (EMS) with the Meraki Webhook. This enables Meraki Cloud Controllers to send you alerts using webhooks.

Prerequisites to setting up Meraki Webhooks in Entuity:

The following are mandatory prerequisites to setting up Meraki Webhooks in Entuity:

1. You must configure the Entuity server for SSL operation.
2. The Entuity server must be reachable from the internet.
3. An inbound rule on the firewall must be configured to allow inbound traffic on port 443 from the Meraki dashboard to the Entuity server.

To set up Meraki Webhooks in Entuity:

1. Add a Meraki cloud controller device as a managed device. See this article for more information on how to add a Meraki cloud controller.
2. Navigate to the Webhooks page (Main Menu > Administration > Webhooks).
   1. In the table on this page, select the Meraki cloud controller that you added in Step 1.
   2. Click Generate Key. 
      This generates a secret key for this Meraki cloud controller.

3. Navigate to https://meraki.cisco.com/ and sign in to your Meraki web portal.
   
   
   
    

   This takes you to your Meraki Dashboard. 

4. Navigate to the Alerts configuration page.
   
   
    
5. Scroll down to the Webhooks section of the Alerts page. 
6. Click Add an HTTP server to open a new line in the table, and enter the Name, URL (click Copy URL on the Entuity Webhooks page to copy the URL of the Meraki cloud controller on the Entuity server) and Shared secret (Copy Key on the Entuity Webhooks page).
   
   If the Entuity server is known by a different hostname/IP address from the cloud controller's perspective, you can manually edit the URL field to reflect this.
   
   
    
7. Scroll up to the Default recipients field and specify the webhook to which notifications will be sent. 
   For example, if your webhook had the name 'test1', then in the Default recipients field you would type 'test1'.
8. Specify the types of alerts that you want to raise by selecting the appropriate checkboxes in the Network-wide, Wireless and Switch sections.
9. Click Save. Otherwise, click Cancel. Allow one-two minutes for your changes to take effect.

To enable or disable a webhook:

1. Navigate to the Meraki Webhooks page.
2. Select the webhook that you want to enable or disable.
3. Click Enable/Disable at the top of the table (or from the right-click Context Menu or from the table's Overflow Menu).
   The Enable/Disable Webhooks form is displayed. 
4. Click the switch to either 'Enabled' or 'Disabled', and then click Done to save your changes. Otherwise, click Cancel.