Guide

Blocking IPs with an External Dynamic List (EDL) in Palo Alto PAN-OS

Creating the EDL, certificate profiles, security policy order, CLI verification commands, and capacity limits.

IP-DB Team 4 min read 43 reads 0 comments
Palo Alto Networks PAN-OS

PAN-OS can fetch an address list from an external URL on a schedule and turn it into an object you can use in security policy. That object is an External Dynamic List (EDL). Its biggest advantage is that you don't need a commit every time the list changes: the object is defined once, and its contents refresh in the background.

Prerequisites

  • A firewall or Panorama running a current PAN-OS release
  • Outbound 443/TCP and working DNS from whichever interface fetches the list
  • A IP-DB.com API key
  • A correct system clock — HTTPS certificate validation depends on it

1. The source URL

The pool is served as plain text, one CIDR per line:

https://api.ip-db.com/v1/feed.txt?key=YOUR_API_KEY

To reduce it to one threat type, append &category=: botnet_c2, malware_c2, attack_source, ssh_brute_force, compromised_host, hijacked_network, tor_exit, aggregated_high_confidence. Narrowing is also the simplest way to protect your platform's EDL capacity.

2. Create the EDL object

Go to Objects → External Dynamic Lists → Add and fill in the fields:

  • Name: ipdb-blacklist
  • Type: IP List
  • Source: the URL above
  • Certificate Profile: a profile to validate the HTTPS certificate; if none exists in your environment, create one first under Device → Certificate Management
  • Check for updates: Hourly

Before saving, press Test Source URL in the dialog. It tells you immediately whether the firewall can reach the URL at all, and catches most problems right there. Then commit the change.

3. Service route

PAN-OS downloads external lists over the management interface by default. If your management network has no internet access, redirect the External Dynamic Lists service to a suitable dataplane interface under Device → Setup → Services → Service Route Configuration. Skip this step and the EDL stays silently empty while your policy blocks nothing.

4. Use it in security policy

The EDL is selectable like an ordinary address object in a rule's source or destination field. Recommended setup:

  • A deny rule with the EDL as source, placed above your allow rules — PAN-OS stops at the first match, and in the wrong order the rule never fires.
  • Enable logging on the rule (log at session end) so you can report on what was blocked.
  • Create a second EDL scoped to botnet_c2 and malware_c2 and use it as the destination on outbound traffic; that cuts an internal machine's path to its command-and-control server.

5. Verification

From the CLI you can confirm the object actually filled:

# show the list's current contents request system external-list show type ip name ipdb-blacklist # refresh now instead of waiting for the schedule request system external-list refresh type ip name ipdb-blacklist

In the GUI, the List Entries And Exceptions view on the EDL row gives the same information. If the count is zero, check the service route, the certificate profile, and the API key, in that order.

6. Common failures

  • Empty EDL with no error: nearly always the service route — the firewall cannot reach the URL.
  • Certificate validation fails: the clock has drifted, or the certificate profile doesn't recognize the root certificate.
  • The rule never fires: the deny rule sits below a broad allow rule. Check rule order.
  • Intermittent download errors: the same API key across many devices exceeds 120 requests per hour; issue one key per device.

Frequently asked questions

How many IP addresses can an EDL hold?

The limit depends on the platform and is shared across all EDL objects: tens of thousands on smaller appliances, hundreds of thousands on large chassis. Scope the feed with the category parameter and delete EDL objects you no longer use.

Which interface does the firewall fetch the list from?

PAN-OS downloads external lists over the management interface by default. If that interface has no internet access, redirect the External Dynamic Lists service to a dataplane interface under Device → Setup → Services → Service Route Configuration.

How often should it refresh?

Because the pool is rebuilt every 30 minutes, an hourly check is enough. A five-minute interval fetches no new data and burns through the 120 requests per hour your API key allows.

Does every update need a commit?

Creating the EDL object and referencing it in a policy require a commit. The contents of the list, however, update through the scheduled fetches without one — you do not need to commit for new addresses to take effect.

The FortiGate equivalent is in our FortiGate threat feed guide, other platforms are on the integrations page, and endpoint details in the API documentation.

Share

Comments 0

Share a question, your experience or a correction. You can comment as a registered user or anonymously.

No comments yet. Be the first.

Plain text; links are not accepted. Comments appear at once and may be moderated. Sign in to comment as a member