Any block page in the Web Gateway can be modified to suit a customer's needs. The Web Gateway's template editor will allow you to modify any element of the page from changing the company logo, color, or text to adding useful debugging data. This document will describe some of the recommended changes to help an Adminstrator troubleshoot issues as well as assist on some common modifications in order to help you get the most out of your block pages.
The Template Editor will be used to modify anything related to the Block Page templates. To get to the Template Editor, go to:
Policy > Settings > Actions > Block > (Default) > Language and Template Settings - Edit the "Default Schema" Collection.
The template editor consists of three different viewing panes Templates > HTML Editor > File System:
This view provides all the templates belonging to a collection. Each template contains the following:
This is the pane that you'll be using most of the time to navigate the Template Editor.
Displays the content of the template that is currently selected on the Templates or File System pane. You'll use this pane any time you want to edit the contents of a particular file.
Provides a tree structure for completing general tasks, such as adding, renaming, deleting template files and images. You'll see examples of how to upload an image in some of our Common Modification examples below.
Every Web Gateway block page can be broken into three different components. (Header, Footer, and the Block Template)
|Name||Location (in editor)||Description|
|Header/Footer||Default Schema > [Language] > HTML|
-Items that will appear at the top and bottom of every Block page.
-Great if you want something to appear on every block page. (see Common Modification Example 'Header/Footer' and 'Add Logo')
|Individual Block Templates||Default Schema > [Language] > [TemplateName].HTML|
-Sits between the Header/Footer on the Block Page. This is the .html file that displays the description or reason for your block.
-An example would be the 'VirusFound.html' or 'URLBlocked.html' file.
-Modify this if you want to change something specific about this individual template. (see Common Modification Example 'Adding Properties to individual block template')
|CSS||File System Pane: /default/stylesheet.css|
-This is what formats the look and feel of the block page.
-You can modify the style sheet to change colors, etc on the block page.
-See Common Example 'Changing Text Color' below.
Below is the default version of the URLBlocked.html template. We've highlighted some of the items that we will be helping you modify in this article. This should also help familiarize you with the different components of the block page.
Whether you plan on making one or several changes to your block pages, the very first thing you should do is make a backup of the default templates. You can back-up your templates in the MWG UI:
As mentioned earlier, the Header/Footer will appear at the top and bottom of every block page. You'll want to modify this when there is something to add that you'd like to appear on every block page. A best practice we recommend is to add additional debugging properties to your block page's footer. Adding these additional properties to your block pages can save an Administrator a lot of time when troubleshooting. The properties we recommend adding to the footer are:
System.Hostname - the Web Gateway hostname of the appliance that handled the web request.
Proxy.IP - the Web Gateway's IP of the appliance that handled the web request,
Client.IP - the Client IP address that made the request.
Rules.CurrentRule.Name - the name of last evaluated Rule in your policy.
Rules.CurrentRuleSet.Name - the name of last evaluated Rule Set in your policy.
The advantage of adding these debugging properties to the footer is that they are placed in a discrete place and more importantly are added to every block page. Therefore one does not have to edit each and every block template individually.
***It is recommended that only basic information be displayed here. If you want you display username, user group, or destination IP address, then it is recommended you add those properties to specific block pages only as the Web Gateway must perform lookups to fill those properties. If these properties are on every block page then far too many lookups are being conducted, consuming resources on the Web Gateway. To add a property to just an individual block template, please see the example "Adding Properties to Individual Block Templates" below.
Open the template editor to edit the index.html file. Under the Templates section, expand the language you are using (en in this example) and click on html. Notice that in the File System section (lower left corner) index.html is automatically highlighted. This is the file we are now editing. The highlighted section below shows the default footer section that we are looking to modify.
To modify your block pages to contain the recommended properties, simply copy/paste the following into the highlighted area above:
generated at $<propertyInstance useMostRecentConfiguration="false" propertyId="com.scur.engine.datetimefilter.datetime.toisostring"/>$ by $<propertyInstance useMostRecentConfiguration="false" propertyId="com.scur.engine.system.hostname"/>$ ($<propertyInstance useMostRecentConfiguration="false" propertyId="com.scur.engine.system.proxy.ip"/>$)<br />
Client IP Address: $<propertyInstance useMostRecentConfiguration="false" propertyId="com.scur.engine.system.client.ip"/>$<br />
Rule Name: $<propertyInstance useMostRecentConfiguration="false" propertyId="com.scur.engine.system.rules.currentrulename"/>$ ($<propertyInstance useMostRecentConfiguration="false" propertyId="com.scur.engine.system.rules.currentrulesetname"/>$)
After pasting the text in, your updated page should look like this:
Updated block page (with new footer):
As mentioned above, it's a best practice to limit the amount of properties you add into the header/footer of the index.html page--especially those properties that require lookups (username, usergroup names, or destination IP address) which will consume resources. These properties should be added to individual block pages as needed.
The screenshot above is an example of putting debugging info on the "URL Blocked" page. Here we have URL, URL Category, Reputation & Media Type displayed on this block page. Lets say you wanted this page to also show the current username. Here are the steps to take:
1. Duplicate the following line: <b>Media Type: </b>$MediaType.EnsuredTypes$<br /> beneath the existing one.
2. Rename <b>Media Type:</b> to <b>User:</b>
3. Place the cursor at the end of "$MediaType.EnsuredTypes$" and hit the backspace button, deleting that property.
4. Without moving the cursor, click on the Add button at the top of the page. From the drop-down select Property - the 'Choose Property' window appears
5. From the Property drop-down select Authentication.UserName and click OK
6. Now you should see this property in the HTML version of your block page:
Before saving changes, use the Preview button in the lower right corner to see what the block page will actually look like.
Updated block page (with added property):
Another common modification to block pages is removing the default McAfee logo in the upper left corner and replacing it with your company's logo. All images are stored in the img folder of the File System View.
Note: If you'd like to use a logo the same size as the default, the dimensions of the default logo is 252x75.
1. Open the Template Editor. In the File System section, make a copy of the default logo_mwg.png and rename it to logo_mwg.png-bak
2. Highlight the img folder, then click Add and from the drop-down. Select Existing file or Directory and select your image file.
3. Re-name your uploaded file to logo_mwg.png
Note: The Default Schema > en > html (index.html) references the logo_mwg.png. If for some reason you did not change the filename of your logo, you would need to update this file to reference the correct file name. See the screenshot below for reference.
4. 'Use the preview button and then Save Changes.
Updated block page (with new Logo):
The background navigation bars are the red strips at the top and bottom of your default block page. Note: If you'd like the navigation bars to be the same size as the default, the dimensions are 20x32.
The most straight forward way for changing the colors of the navigation bars (/img/bg_navbar.jpg) is to:
1. Open the Template Editor. In the File System section, make a copy of the file bg_navbar.jpg and rename it to bg_navbar.jpg-bak
2. Create a custom image (20x32) with the color of your choosing.
3. Highlight the img folder, then click Add and from the drop-down. Select Existing file or Directory and select your image file.
4. Re-name your uploaded file to bg_navbar.jpg
5. 'Use the preview button and then Save Changes.
Updated block page (with new navigation bar):
The stylesheet.css is the file that formats the block page and this file is found in the file system area of the template editor. Below we've highlighted certain areas of the stylesheet that you may be interested in modifying. In this example, we've decided to change the colors of the text-headings, divider bar, and text for the Company Acceptable Use Policy.
Updated block page (text heading and border color changes):