Web solution block pages on the X10G security blade

The X10G security blade hosts a set of default block pages. These are displayed to end users each time a Web request is blocked.

Block pages are constructed from HTML and JavaScript files. By default, the block page has 3 main sections:

The header explains that the site is blocked.

The top frame contains a block message showing the requested URL and the category of the URL.

The bottom frame presents any options available to the user (go back to the previous page, continue to the site, use quota time to access the site, use different credentials to try to access the site).

If the site is blocked because it belongs to a category in the Security Risk class, a special version of the block page is displayed.

To verify the behavior and appearance of block pages, use the links at testdatabase.websense.com to attempt to access test sites in categories that your organization blocks.

Use the Administration > Toolbox page to determine whether to:

Use the block pages (both standard and security) provided with your Websense Web solution software (Default block page).

Edit the block page files to suit the needs of your organization (Custom block page).

Customizing block pages

When you select Custom block page, a copy of the default block page files is created in an editable directory on the security blade. The default block page files are neither moved nor deleted, so that you can revert to them at any time.

After selecting the custom block page option:

1.	Select the files you want to change, and then click Download File(s). The available files are:

 

File Name	Contents
block.html	Contains the text for the top frame of the block message, which explains that access is restricted, lists the requested site, and describes why the site is restricted.
blockFrame.html	Text and button (Go Back option) for sites in blocked categories.
blockStyle.css	Cascading style sheet containing most block page styles
continueFrame.html	Text and buttons for sites in categories to which the Confirm action is applied.
master.html	Constructs the information frame for the block page, and uses one of the following files to display appropriate options in the bottom frame.
messagefile.txt	Contains text strings used in block pages
moreInfo.html	Content for the page that appears when a user clicks the More information link on the block page.
webDLPPolicyViolation. html	Provides block page content when Websense Data Security components block content from being posted to or downloaded from the Web.
quotaFrame.html	Text and buttons for sites in categories to which the Quota action is applied.
security.js	JavaScript file used in construction of a security block page

When you select a single file, its details are displayed, including its default use, last modification date, and size.

If you select more than one file to download, the files are packaged into a single ZIP file.

2.	Make modifications locally.

 

Important  Do not change the default file names.

To replace the Websense logo with another image, see Changing the block page logo.

If the information that you want to display in the block message is longer than the space provided, see Changing the size of the message frame.

If you want to start again from the original, default set of block page files, see Starting over.

Additional information about customizing block pages can be found in the "Block Pages" section of the TRITON - Web Security Help.

3.	Click Upload File(s) to place the modified files and any supporting graphics files on the security blade.

The edited files can refer to custom graphics files (like logos). If you use custom graphics, be sure to upload these additional graphics files to the editable directory.

If you have more than 5 files to upload, select the first 5 files to be uploaded, and then click Add More Files. You can upload a maximum of 10 files at a time.

4.	Click Apply Changes. This restarts Filtering Service.

5.	To test the customized block pages, go to testdatabase.websense.com and try to access test sites in categories blocked by your organization's policies.

6.	Return to Step 2 if adjustments are needed.

Changing the block page logo

The master.html file includes the HTML code used to display a Websense logo on the block page. To display your organization's logo instead:

1.	Download the master.html file to a temporary directory.

2.	Locate an image file for your organization's logo, and copy it to the same location.

3.	Open master.html in a text editor, such as Notepad or vi (not an HTML editor), and edit the following line to replace the Websense logo with the image name for your organization's logo:

<img title="Websense" src="/Images/wslogo_block_page.png" ...>

Replace the value of the title parameter to reflect name of your organization.

Change the path to indicate that your image file is located in the Custom folder (not in the Images folder).

Replace wslogo_block_page.png with the name of the image file containing your organization's logo.

The result will look something like this:

<img title="ABC_Corporation" src="/en/Custom/myimage.png" ...>

Note that parameter and folder names are case-sensitive.

4.	Save and close the file.

5.	Upload both the image file (containing your logo) and the edited copy of master.html to your X10G security blade, and then click Apply Changes.

Changing the size of the message frame

Depending on what information you want to provide in the block message, the default width of the block message and height of the top frame may not be appropriate. To change these size parameters:

1.	Download the master.html file.

2.	Open the file in a text editor, such as Notepad or vi (not an HTML editor).

3.	To change the width of the message frame, edit the following line:

<div style="border: 1px solid #285EA6;width: 600px...">

Change the value of the width parameter as required.

4.	To cause the top frame of the message to scroll, in order to show additional information, edit the following line:

<iframe src="$*WS_BLOCKMESSAGE_PAGE*$*WS_SESSIONID*$" ...
scrolling="no" style="width:100%; height: 6em;">

Change the value of the scrolling parameter to auto to display a scroll bar when message text exceeds the height of the frame.

You can also change the value of the height parameter to change the frame height.

5.	Save and close the file.

6.	Upload the file to your X10G security blade, and then click Apply Changes.

Starting over

If you need to start over with a default block page file at any time, click the default files link under the Upload and Download buttons. This allows you to download a copy of the default block page files to your local machine.

Edit the files you want to change, and then upload the edited files to the security blade.