zia-investigate-url-category

ZIA: Investigate URL Category

Keywords

url category, where is category used, url filtering, category lookup, url policy, category impact, url rules, which rules use category, url category audit, policy investigation

Overview

Investigate where a specific URL or URL category is referenced across all ZIA security policies. This skill queries URL filtering rules, DLP web rules, SSL inspection rules, and cloud firewall rules to build a complete picture of how the category affects traffic and users.

Use this skill when: An administrator wants to understand the policy impact of a URL category, check which rules reference a specific category, or determine what happens when a user tries to access a URL in that category.

---

Workflow

Follow this 5-step process to investigate a URL category.

Step 1: Identify the URL Category

Determine whether the admin is asking about a specific URL or a named category.

If given a URL, look it up first:

zia_url_lookup(urls=["example.com"])
```text

This returns the URL's category classification (e.g., "SOCIAL_NETWORKING", "STREAMING_MEDIA").

**If given a category name**, list categories to find the exact ID. Narrow the
request — unfiltered, this returns every category in the tenant:

```text
zia_list_url_categories(custom_only=True, search="partner")
```text

`custom_only=True` is a real API filter and the right first move whenever the
admin is asking about a category they created. `search` matches the configured
name; if it comes back empty, drop it and match on the `id` instead.

Find the category in the results and note its `id` (e.g., "CUSTOM_01",
"SOCIAL_NETWORKING"). By default the listing reports how many URLs each category
holds, not the URLs themselves.

To see the URLs, `superCategory` and the rest of the definition, fetch the
category itself:

```text
zia_get_url_category(category_id="<category_id>")
```text

#### Present Initial Findings

```text
URL Category Identified:

**Category:** Social Networking
- ID: SOCIAL_NETWORKING
- Super Category: Entertainment & Recreation
- Type: Built-in

Now searching across all policy rule types...
```text