Category Lookup Overview

Category Lookup allows you to check the Categories assigned to URLs in the lookup process and provides you with additional information regarding how it is processed. 

Category Definitions

The Category Definitions contains official definitions of what type of content a URL must contain to be included into each of the available Categories. Additionally, if you create a new category, it will also show up in Category Definitions in the WebAdmin. You can sort the definitions by name, number, or group. If you are looking for a category, you can search the list by keyword.  There are two views in this window: The Classic view which is like previous releases and the ‘Hierarchy View’.

Please see the Category Definitions documentation for more information.

Add or Remove Columns

You can add or remove columns using the Settings button.

Tile and Table View

Click the Tile View button to view the output in Tile view.

Import/ Export Category Lookup

You can Import a set of URLS to lookup or Export the results of the lookup. All input fields are available.

URL

Enter one or more URLs on each line of the URL field and click the Lookup button. Additionally, you can enter a Destination IP, Referrer, and User Agent delimited by space for each line. You can use '-' to provide an empty value.

Example of a URL entry

http://example.com 1.1.1.1 https://referrer.com MSIE Internet Explorer

Categories Mismatch Detected

This warning indicates that one or more servers returned different results than another. This may occur if changes have not been applied to a server or a server configuration was done improperly.

Details

By default, the 'Details' column is disabled. When enabled, it displays the full results for a URL including multiple Policy Servers and each step in which the URL is processed. The information displayed includes the server, category assigned, the Processing Step, and the URL/Keyword that was applied.

Show / Hide Advanced

User Agent

Use this field to specify the application that is performing the request for all Category Lookups. I For example, Firefox, Chrome, and Internet Explorer have their own User Agent.

User Agent Example

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36

Try All IP Addresses:

If this is checked, the 'Detail' column will display the different destination IP addresses, such as, one for IPv4 and another one for IPv6. It then sends all commands to the policy servers, gets results and merges them. If some lookup steps produce the same result for all IPs, it is shown only once. If some step results are different, they are merged in the list.

Show All Steps

The 'Show All Steps' checkbox option shows all policy processing steps for a request until processing stops. It will show all steps that were tried even if the step did not apply to the specified URL.

This window can also be accessed from the Actions dropdown in the 'Request Logs' window.

Table Bar and Menu Options

• Refresh reloads the URL result

• Reset empties the URL history from the CNS Cache.

• Override adds the URL to the database. The 'Override' option must be enabled in 'WebAdmin Settings' for it to display.

Enabling Override Option

The 'Override' option in 'Category Lookup' is disabled by default, it must be enabled in ‘WebAdmin Settings’ for it to display. Go to System Administration > Configuration and click WebAdmin Settings. Scroll down to the ‘Override URL Settings’ section. You can enable this option for Admins, SysOps, or Users. See ‘Override URL Settings’ in ‘WebAdmin System Configuration Reference’ for more information about this feature.

Select Override from the Actions dropdown menu.

The Override URL is added.

Category Lookup in Reviewed Categorized List

A 'Category Lookup' button displays in the 'Review List' and 'Edit Entry' window. This button is only shown if the 'Entry Type' is URL and the 'Action' is Categorize.