12.2 URLCensor

URLCensor generates URL categorizations based on information retrieved in real time from DNS Blacklist facilities.

URLCensor can perform both traditional IP lookups (DNSBL) and domain name lookups (SURBL) as specified in the configuration file.

URLCensor requires the ability to perform DNS lookups for Internet sites from the computer and account used by WebMarshal.

Information 

Note: Delays in URLCensor lookups can noticeably affect user browsing experience. You can configure the timeout for these lookups. See Knowledge Base article Q12716.

 

You can configure the DNS lists used by URLCensor using the config.xml file found in the subfolder \ArrayManager\Policy\FilteringLists\UrlCensor\ of the WebMarshal install path.

A sample entry in the file is as follows:

<category id="1" name="Spamhaus SBL"
      zone="sbl.spamhaus.org" enabled="1" type="ip">
 <description>Checks for domains in the Spamhaus SBL list.
      </description>
 <match>127.0.0.2</match>

</category>

where:

id is a unique integer that WebMarshal will use to record results of URLCensor categorization.

name is the friendly name for the source as it will display in WebMarshal interfaces and reports.

zone is the domain to query for the information

enabled indicates that this category should be used (1) or not used (0)

type indicates what type of lookup this source supports:

ip indicates a DNSBL lookup. The domain name associated with the Web request is converted to an IP address before being passed to the blacklist query.

url indicates a SURBL lookup. The domain name associated with the Web request is passed directly to the blacklist query.

description is a verbose description for documentation in this file only

match indicates the return value that is considered a match. This value can be a single dotted quad value, or a range expressed in the format x.x.x.x/nn  

Information 

Note: To apply URLCensor configuration changes, restart the WebMarshal Node Controller service on each node (using the WebMarshal Server Tool or the Windows Services control panel).

 

WebMarshal User Guide October 2023
< Previous Section   |   Next Section >
Full document: see WebMarshal Documentation.