Skip to main content
Clarion receives Zscaler Internet Access (ZIA) Security and UEBA alerts over a webhook, turning each one into an issue for agent triage.
Estimated time: 10 minutes. You will need admin access to the ZIA Admin Portal to configure a webhook destination.

Prerequisites

  • A Zscaler Internet Access tenant
  • Admin rights to configure alert webhooks in the ZIA Admin Portal

Step 1 — Create the monitor in Clarion

  1. In Clarion, open Integrations and find Zscaler.
  2. Click Connect and add a monitor.
  3. Clarion generates a webhook URL and a shared secret, shown once.
The secret is per monitor and stored encrypted. It authenticates the webhook — it travels in the request, never in the URL. Copy it when it is shown.

Step 2 — Configure the webhook in Zscaler

  1. In the ZIA Admin Portal, open the alert or webhook configuration for Security and UEBA alerts.
  2. Add Clarion’s webhook URL as the destination.
  3. Configure the shared secret so Clarion can verify each delivery.
  4. Send a test alert to confirm delivery.
Clarion rejects deliveries that fail verification, so a misconfigured secret shows up immediately rather than silently dropping alerts.

What Clarion ingests

ZIA Security alerts (policy blocks, malware and threat detections, risky destinations) and UEBA alerts (anomalous user behaviour). Each becomes an issue with severity mapped from the Zscaler payload.

Triaging Zscaler alerts

Zscaler alerts route well to the identity and endpoint skill domains — a UEBA anomaly is usually best pursued through the user’s identity provider and their device, both of which Clarion can reach if those integrations are connected.

Optional — let agents block indicators in ZIA

With a ZIA API client, an agent can add a confirmed-malicious URL, domain or IP address to the Advanced Threat Protection denylist, for example after it triages a threat intelligence item. File hashes are not supported.
  1. In the ZIdentity Admin Portal, open Integration → API Clients and add an API client. Give it a ZIA role that can read and edit Advanced Threat Protection policy and activate changes.
  2. In Clarion, open the Zscaler integration’s Configuration tab.
  3. Enter the vanity domain (acme in acme.zslogin.net), the client ID and the client secret, then click Save. Clarion verifies the client before it stores it.
  4. Reference the Zscaler tools in the skill of the agent that should use them.
ZIA blocks nothing until the change is activated. Activation applies every pending change in the tenant, including changes that other administrators staged. Check the pending changes in the ZIA Admin Portal before you approve an activation.

Disconnect

Click Disconnect on the integration page, and remove the webhook destination from the ZIA Admin Portal.