URL Filtering Response Page Objects
Focus
Focus
Advanced URL Filtering

URL Filtering Response Page Objects

Table of Contents

URL Filtering Response Page Objects

Refer to this list of response page variables and references you can use to customize URL filtering response pages.
Where can I use this?What do I need?
  • Prisma Access (Managed by Strata Cloud Manager)
  • Prisma Access (Managed by Panorama)
  • NGFW (Managed by Strata Cloud Manager)
  • NGFW (Managed by PAN-OS or Panorama)
Notes:
  • Legacy URL filtering licenses are discontinued, but active legacy licenses are still supported.
  • Prisma Access licenses include Advanced URL Filtering capabilities.
Use the variables and references described in the following sections to customize URL filtering response pages. The response page variables display different information about URL requests. For example, the firewall replaces the <category/> variable in the HTML code for the response pages with the URL categories of a requested URL. Response page references enable you to add external images, sounds, style sheets, and links.

Response Page Variables

The following table lists response page variables and the information or object that the system substitutes each variable with during a block event. Each URL filtering response page uses the following variables by default: user, url, and category. However, response pages are customizable. For example, you can modify the order of the variables or add different messages for specific URL categories.
Variable
Usage
<user/>
The firewall replaces the variable with the username (if available via User-ID) or IP address of the user when displaying the response page.
<url/>
The firewall replaces the variable with the requested URL when displaying the response page.
<category/>
The firewall replaces the variable with the URL filtering category of the blocked request.
<pan_form/>
HTML code for displaying the Continue button on the URL Filtering Continue and Override page.
You can also add code that triggers the firewall to display different messages depending on what URL category the user is attempting to access. For example, the following code snippet from a response page specifies to display Message 1 if the URL category is games, Message 2 if the category is travel, or Message 3 if the category is kids:
var cat = "<category/>"; 
switch(cat) 
{ 
 case 'games': 
 document.getElementById("warningText").innerHTML = "Message 1"; 
 break; 
 case 'travel': 
 document.getElementById("warningText").innerHTML = "Message 2"; 
 break; 
 case 'kids': 
 document.getElementById("warningText").innerHTML = "Message 3"; 
 break; 
} 

Response Page References

Only a single HTML page can be loaded into each virtual system for each type of block page. However, other resources such as images, sounds, and cascading style sheets (CSS files) can be loaded from other servers at the time the response page is displayed in the browser. All references must include a fully qualified URL.
Reference Type
Example HTML Code
Image
<img src="http://virginiadot.org/images/Stop-Sign-gif.gif">
Sound
<embed src="http://simplythebest.net/sounds/WAV/WAV_files/ movie_WAV_files/ do_not_go.wav" volume="100" hidden="true" autostart="true">
Style Sheet
<link href="http://example.com/style.css" rel="stylesheet" type="text/css" />
Hyperlink
<a href="http://en.wikipedia.org/wiki/Acceptable_use_policy">View Corporate 
Policy</a>