Summary

With the current list of available supported integration list, Zscaler integration is not one of them.
This article aims at providing 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 to Administration > Webhooks > Add New Webhook.
3. Enter the following information:
   1. Name: Enter the name of the webhook for OpsGenie.
   2. Status: Select Enabled.

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

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

      For ZDX Integration, ?isOpsGenie=true must be appended to the URL. The final URL to enter the ZDX UI is then https://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=true at the end of your URL to integrate with ZDX.

   4. Authentication Type: Select Token.
   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: Select Webhook. Email is optional.
      4. Click Next.
   2. On the Review tab, click Submit to save the Alert Rule configuration.

6. Click Save and activate the changes.

   The Alert Title might not display all the characters if the character size exceeds 130 characters. If this happens, the fields are displayed within the description.