Opsgenie Zscaler Integration

Summary

With the current list of available supported integrations list, Zscaler integration is not one of them.

This article aims to provide a solution to integrate Zscaler with Opsgenie via Opsgenie API integration and Zscaler Webhook.

Environment

Opsgenie

Solution

Here are the detailed steps to integrate Opsgenie with Zscaler:

Add an API Integration in Opsgenie.

1. Go to Settings → Integrations. Search for API and select Add. 

2. Specify who is notified for the alerts using the Responders field. Refer to Alert Notifications Flow.

3. Check the modify configuration settings option to allow the integration to manageusers, schedules, escalations, etc.

4. Click Save Integration.

5. An API Key is generated for the integration, copy the API Key and use it in your API requests.

Setting Up Alert Webhooks on ZDX

1. Log in to your ZDX Admin account.

2. Go toAdministration>Webhooks>Add New Webhook.

3. Enter the following information:

   1. Name: Enter the name of the webhook for OpsGenie.

   2. Status: SelectEnabled.

   3. URL: Enter your OpsGenie URL. It is normallyhttps://api.opsgenie.com/v2/alerts?isOpsGenie=true.

      The generic OpsGenie URL ishttps://api.opsgenie.com/v2/alerts.

      For ZDX Integration,?isOpsGenie=truemust be appended to the URL. The final URL to enter the ZDX UI is thenhttps://api.opsgenie.com/v2/alerts?isOpsGenie=true.

      The URL might be different when using an enterprise setup. If there is a specific URL for your organization, you still need to append?isOpsGenie=trueat the end of your URL to integrate with ZDX.

   4. Authentication Type: SelectToken.

   5. Bearer Token: Enter your Bearer Token with the API Key from OpsGenie (also known as GenieKey) in the following format.

      GenieKey <API Key generated from Step 5 in the previous section>

   6. Click Save.

4. Go to Alerts > Rules > Add New Alert Rule.

5. Configure the Alert Rule settings as needed based on your organization's needs. To learn more, see Configuring an Alert Rule.

   1. On the Action tab and under the Action section, the following fields are required to integrate with OpsGenie:

      1. Muted: Disable this setting.

      2. Webhooks: Select the Ops Webhook that you created from Step 3.

      3. Alert Delivery Method: SelectWebhook. Email is optional.

      4. ClickNext.

   2. On the Review tab, click Submit to save the Alert Rule configuration.

6. Click Save and activate the changes.