Skip to main content

Cotool + Zscaler

Connect Zscaler to Cotool so agents check URL and Sandbox verdicts, inspect ZIA and ZPA policy, manage blocklists, sync detection rules, and respond to alerts.

Network
Updated

The short answer

The Zscaler integration gives Cotool agents access to ZIA, ZPA, ZDX, and Client Connector through Zscaler's OneAPI, syncs Zscaler policy and alert rules into Cotool's detection-rule repository weekly, and accepts alerts pushed from Zscaler to start response agents.[1]

How it connects: Cotool connects with a ZIdentity OneAPI client using client-credentials OAuth. Zscaler's Authentication Service issues access tokens to API clients, and each client can hold one API resource, or role, per Zscaler service.[1][3]

What Cotool uses from Zscaler

URL and Sandbox verdicts
Agents classify URLs and pull Sandbox verdicts for files seen in an alert.[1]
Policy and audit
Agents inspect ZIA and ZPA policy, the user directory, and admin audit logs to explain why traffic was allowed or blocked and who changed a rule.[1]
ZDX and Client Connector
Agents read ZDX alerts and device health and look up Client Connector devices. ZDX alerts have no webhook, so they are pulled by an agent tool.[1]

Response actions

These change state in Zscaler, so they are the steps teams usually gate behind approval.

Manage the threat blocklist
Agents add or remove entries on the ZIA threat blocklist and activate configuration changes.[1]
Remove a Client Connector device
With the write role for Client Connector, agents can remove a device.[1]

Detections, hunts, and triage

Zscaler rules in your detection inventoryDetection
A weekly job syncs ZIA policy rules (URL filtering, firewall, DNS, IPS, Sandbox, DLP, and SSL inspection), ZIA Security and UEBA alert rules, and ZPA AppProtection profiles into Cotool's detection-rule repository. Rule types the tenant is not licensed for are skipped.[1]
Respond to Zscaler alertsResponse
A Zscaler trigger on a response agent receives alerts pushed from a Cloud NSS feed or a ZIA alert-rule webhook, creates a Cotool alert for each, and links it to the synced Zscaler rule by name.[1][4]
Check a URL from a phishing reportTriage
During phishing triage, an agent classifies the reported URL in Zscaler and checks whether any user reached it before deciding whether to block it.[1][2]

Setup and permissions

Add an API role in each Zscaler service first; roles sync to Authentication Service and appear as resources on the API client. Then create the client with the Client Credentials grant and copy its secret, which is shown only once.[1][3]

PermissionAccess
ZIA API roleURL lookup, security policy, user management read, and audit reports. Add policy activation only if agents should push changes.[1][3]Read
ZPA, ZDX, and ZCC API rolesRead roles for the other products you use. ZPA tools also need your ZPA customer ID.[1][3]Read
ZCC write roleOnly for removing Client Connector devices.[1][3]Write
  • Client secrets last between 30 and 365 days, and access tokens between 1 minute and 24 hours.[3]
  • A Cloud NSS feed retries a failed batch for up to one hour and drops batches the receiver rejects as unparseable.[4]

How Cotool works with Zscaler

  • Tenants that have not migrated to ZIdentity are not supported. Cotool validates the credentials against Zscaler before saving them.[1]
  • ZPA has no alert channel; its session logs stream only to a self-hosted LSS collector, so ZPA coverage comes from tools and rule sync.[1]

FAQ

Which Zscaler alert channel should I use?
Cotool's docs recommend a Cloud NSS alert feed with JSON output pointed at the trigger's webhook URL. Cloud NSS is separately licensed; ZIA alert-rule webhooks are the alternative.[1][4]

Sources

  1. Zscaler integration (Cotool docs) · accessed November 16, 2026
  2. Respond to every signal (Cotool Respond) · accessed November 16, 2026
  3. Adding an API client or AI agent (Zscaler Help) · accessed November 16, 2026
  4. About Cloud NSS feeds (Zscaler Help) · accessed November 16, 2026

Related integrations

All integrations

Use cases with Zscaler

Attackers are scaling with tokens

Cotool helps defenders operate at machine speed. See how security teams are scaling Detection & Response.

Book a demo