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.
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.
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]
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]
| Permission | Access | Why |
|---|---|---|
| ZIA API roleURL lookup, security policy, user management read, and audit reports. Add policy activation only if agents should push changes.[1][3] | Read | URL lookup, security policy, user management read, and audit reports. Add policy activation only if agents should push changes.[1][3] |
| ZPA, ZDX, and ZCC API rolesRead roles for the other products you use. ZPA tools also need your ZPA customer ID.[1][3] | Read | Read roles for the other products you use. ZPA tools also need your ZPA customer ID.[1][3] |
| ZCC write roleOnly for removing Client Connector devices.[1][3] | Write | Only for removing Client Connector devices.[1][3] |
How Cotool works with Zscaler
FAQ
Sources
- Zscaler integration (Cotool docs) · accessed November 16, 2026
- Respond to every signal (Cotool Respond) · accessed November 16, 2026
- Adding an API client or AI agent (Zscaler Help) · accessed November 16, 2026
- About Cloud NSS feeds (Zscaler Help) · accessed November 16, 2026
