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
- In Clarion, open Integrations and find Zscaler.
- Click Connect and add a monitor.
- Clarion generates a webhook URL and a shared secret, shown once.
Step 2 — Configure the webhook in Zscaler
- In the ZIA Admin Portal, open the alert or webhook configuration for Security and UEBA alerts.
- Add Clarion’s webhook URL as the destination.
- Configure the shared secret so Clarion can verify each delivery.
- Send a test alert to confirm delivery.
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.- 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.
- In Clarion, open the Zscaler integration’s Configuration tab.
- Enter the vanity domain (
acmeinacme.zslogin.net), the client ID and the client secret, then click Save. Clarion verifies the client before it stores it. - Reference the Zscaler tools in the skill of the agent that should use them.