KB Article | Forcepoint Support

Problem Description

During troubleshooting, its sometimes necessary to determine the category for a particular URL. While this can be done by browsing to the site, and then reporting on your activity, there is a faster and easier way to find this information for individual sites: the WebsensePing utility.

This utility provides the category under which the site is currently being filtered. Typically, this is the category assigned by Forcepoint in the Master Database. However, if you have re-categorized the site in Forcepoint Security Manager, WebsensePing shows the new category.

Additionally, WebsensePing displays the filtering action (disposition) assigned in the Global policy.

Resolution

  1. Go to the command line and navigate to the appropriate directory for your operating system:
    • Windows: Websense\Web Security\bin
    • Linux: /opt/Websense/bin
  2. Enter the command appropriate to your operating system:
    • Windows: websenseping –m 2 –url <url>
    • Linux: ./WebsensePing –p –m2 –url <url>
where <url> is replaced by the URL of the site. For example, to find the category for Google, enter one of the following, according to your operating system:
  • Windows: websenseping –m 2 –url www.google.com
  • Linux:./WebsensePing -p –m 2 –url www.google.com
  1. Notice that the protocol was omitted from this command. When there is no protocol, WebsensePing assumes HTTP.
  2. If you need the category for a URL with a different protocol, be sure to include the protocol in the command.
  1. Review the response to find the lines for Category and Disposition. Depending on your Global policy settings, the response might be similar to the one below.
------------------------------------
 Sending URL_LOOKUP_REQUEST_EX…
------------------------------------
URL = http://www.google.com
User Name = Source IP = <ip-address>
Destination IP = <ip-address>
Disposition = CATEGORY_NOT_BLOCKED
Lookup Code = WISP_URL_OK
Category = Search Engines and Portals
Elapsed Time = 1 ms
AVG TIME PER REQUEST = 1 ms

 
       4.  If the category and disposition are not what you expect, use Forcepoint Security Manager to re-categorize the site or to change the Global policy.

The WebsensePing utility offers a variety of other options for testing internal Forcepoint processes. For more information, see Using WebsensePing to determine the category or filtering disposition for a URL.

 

Article Feedback



Thank you for the feedback and comments.