Professional Documents
Culture Documents
Reporting Installation and Configuration: Websense Integration Service
Reporting Installation and Configuration: Websense Integration Service
Reporting Installation and Configuration: Websense Integration Service
Installation Guide 3
Contents
Recommended Reading
You may find it helpful to be familiar with the following documents before you begin your Websense
component installation.
For hardware and software requirements, read the Websense Enterprise Deployment Guide.
For detailed installation procedures, read the Websense Enterprise Installation Guide for use with
Universal Integrations and the Websense Enterprise Reporting Installation Guide.
For information about configuring roles for Report Administrators roles, read the Websense
Enterprise Administrators Guide and the Websense Enterprise Reporting Administrators Guide.
All Websense documents are available at http://www.websense.com/global/en/SupportAndKB/
ProductDocumentation/?Section=All.
System Requirements
Verify your system requirements before installing the Websense reporting products. For details, read
the Websense Enterprise Deployment Guide. This document is available at http://
www.websense.com/global/en/SupportAndKB/ProductDocumentation/?Section=All.
Third-Party Software
To install Websense reporting components for your integration, you need to have the following
software installed and running.
MSDE 2000 or SQL Server 2000. A database engine is necessary for reporting functions.
IIS or Apache. A Web server is necessary for Websense Enterprise Explorer, an easy-to-use,
Web-based reporting tool that provides drill-down access to data.
Acrobat Adobe. This is necessary if you want to download and read Websense documentation.
Internet Explorer v5.0 or higher. This is necessary for reporting functions and for online help
available in the Websense applications.
6 Websense Enterprise
Chapter 1: Getting Ready for Websense Reporting
NOTE
Be sure you download the installer specifically designed for your Blue Coat
appliance. If you select an installer for a different appliance, the installer will not
work correctly.
3. Unzip the files to run the Windows installer. Setup.exe automatically opens the installation
wizard to walk you through the installation.
4. Follow prompts within the installation program to install Websense components.
5. If the machine where you are running the installer has multiple IP addresses, you will be
prompted by the installer to select the IP address of the Websense Log Server.
6. When prompted by the installer, enter the port number that represents your Websense Integration
Service (not the Log Server). Your integration product will need this port number to
communicate with the Websense Integration Service.
7. For example, if you assign port number 55080 to the Websense Integration Service, enter 55080.
8. Continue following prompts to complete the installation.
Follow the steps below, in the order provided, to configure your Blue Coat appliance for Websense
communications, reporting, and logging functions.
NOTE
Once you download the Websense Master Database, future downloads
contain only changed or added data. The Force Full Update selection
provides a way that you can request a complete download once your
first download has been completed.
e. Accept the default enabled setting for the Use regular expression filters option.
f. To set up the Websense Integration Service, enter the following data.
Make sure the Enabled option is marked. When marked, the Integration Service Host
8 Websense Enterprise
Chapter 1: Getting Ready for Websense Reporting
NOTE
If for any reason, you want to temporarily stop Websense
logging, remove the checkmark to disable this feature. Your
selection does not immediately take affect.
If you want to immediately stop logging, select Access Logging > General, and then
change any applicable settings in the logging fields to None.
In the Integration Service Host field, enter the IP address of the machine where you
installed Websense components.
In the Port field, enter or verify the port number 55080.
4. Click Apply to save your settings.
NOTE
Disabling downloads of the Websense Master Database is not
recommended. If you do completely disable the database
download, the accuracy of your filtering policy will be
impacted because Internet sites can change rapidly.
b. Identify the days when the database download should or should not take place. Any days that
are check marked are the days when a download will occur, at the time you indicate in the
Download new filter list box.
4. Click Apply to save your changes.
10 Websense Enterprise
Chapter 1: Getting Ready for Websense Reporting
10. Accept the default values for the wait and keep-alive times for now. You can change the
values later if necessary.
NOTE
The keep-alive time identifies how frequently the Blue Coat proxy sends a
Keep-Alive packet to the Websense Log Server to maintain an open
connection. A value of zero (0) in the Keep-Alive field essentially disables the
connection if no further log records need to be transmitted within a certain time
frame. The next time logged information needs to be uploaded, Blue Coat
reestablishes the connection.
NOTE
Your Websense installation includes Websense Manager. Although the Websense
Manager includes policy configuration options, those settings do not impact an
embedded Blue Coat system.
4. If you want, you can check Websense categories by clicking View Categories. All Websense
categories are listed in an HTML format.
NOTE
If you try to view categories and the Websense Master Database has not been
downloaded or is in the process of downloading, messages inform you of the
current status.
5. If you want to test a URL against the Websense Master Database, use the Blue Coat test feature.
a. Enter a known URL in the URL field.
b. Click Test. An HTML page opens and identifies which database or databases is able to map
the URL, and for Websense, shows the category to which the URL is assigned.
For example, if you type www.playboy.com in the URL field, and then click Test, the HTML
page will show that www.playboy.com is in the Adult Content and Adult Material categories.
6. Click Apply to save your settings.
User Authentication
If you are setting user authentication for your Blue Coat appliance, check Blue Coat documentation
for details. If you need additional information, contact Blue Coat Technical Support.
Once you have configured the Blue Coat appliance for user authentication, you need to make sure the
same configuration is set in Websense Manager. For details, check the Websense Enterprise
Administrators Guide.
Policy Configuration
When you are ready to configure the Blue Coat policy, check Blue Coat documentation for details. If
you need additional information, contact Blue Coat Technical Support.
NOTE
Although Websense Manager includes options for configuring policies, those options
do not impact on-box Blue Coat configurations.
12 Websense Enterprise
CHAPTER 2
Configuring Websense Reporting
Options
Once you install Websense components for your Blue Coat appliance integration, you need to
configure Websense reporting options. There are three different ways you can set reporting options,
depending on your environment and on your Websense subscription.
Websense Reporter access. You can access Websense Reporter immediately after configuring
your Blue Coat appliance integration, as soon as data is available in the database. For details, read
Access Websense Reporter Immediately, page 13.
Websense Administrator access. The Websense Administrator access must be set to open
Websense Manager and to create Report Administrators. For details, read Define a Websense
Password, page 14.
Report administrator access. Report administration configuration is available in Websense
Manager. In addition to the Websense Administrator role, other staff members can be given
access rights to Websense Enterprise Explorer, and various views of the data in Explorer can be
assigned. For details, read Define Report Administrator Roles, page 14.
14 Websense Enterprise
Chapter 2: Configuring Websense Reporting Options
Check Save Favorite reports to allow staff in this role to create and save report criteria
for repeated use.
Check Log Database Manager to allow staff in this role to use Log Database Manager to
manage log database contents.
8. Click Save Changes (above the navigation tree) to save the configuration for this role
Anyone associated with a Report Administrator role can access Web Reporting Tools, based on the
report permissions configured for the role. To log on and use Web Reporting Tools, a user needs the
following.
The URL for the Web Reporting Tools
His or her own network user name as the user name for Web Reporting Tools
His or her own password, associated with the network user name, as the password for Web
Reporting Tools
16 Websense Enterprise
CHAPTER 3
Supporting Websense Installations
This chapter describes troubleshooting tips for your Blue Coat integration, uninstalling Websense
components, and where additional information is available.
Troubleshooting Tips
Check this topic for troubleshooting tips that may impact your ability to use Websense reporting
components.
Problem Solution
At some translation sites, when the This problem has been resolved by Blue
Websense option "Use regular Coat. The solution is included in SGOS SG
expression filters" is set to yes, the 3.2.5.1 and higher releases.
Websense filter was bypassed. This
occurred in situations where no
blocked category was found in the
database.
Group-based reports for NTLM This problem has been resolved by Blue
requests are not being generated as Coat. The solution is included in SGOS
expected. 3.2.4.x releases.
There is useless data showing up in This problem has been resolved by Blue
the Log Server database Coat. The solution is included in SGOS
USER_NAMES and INCOMING 3.2.4.x releases.
tables.
URLs that are marked as Blue Coat is addressing this issue.
Uncategorized Miscellaneous are
not properly tracked in reports.
Log requests are not being The Blue Coat appliance is not configured
generated. correctly to communicate with the Log
Server. Check and make sure the Log
Server IP address and port settings are
correct. For access, open the Blue Coat
Management console, and then click the
Upload Client tab to define logging
parameters.
The Blue Coat machine says that This problem has been resolved by Blue
CPU usage is at 100% after Coat. The problem was fixed in SGOS
downloading the Websense Master
Database. 3.2.3.x.
Problem Solution
Group-based reports for LDAP This problem has been resolved by Blue
requests are not being generated as Coat. The problem was fixed in SGOS
expected. 3.2.3.x.
Web Reporting Tools are not You have not logged on to Websense
accessible to anyone, including the Manager yet. See Define a Websense
administrator. Password.
Log requests are not being Blue Coat is not configured correctly to
generated.
communicate with Websense Log Server.
Make sure Blue Coat is using the correct
Log Server IP address and port settings.
There is no category information Blue Coat is not configured correctly for
listed in the reports. communications with the Websense
Integration Service. Check the Integration
Service IP address and port settings to
make sure they are correct.
18 Websense Enterprise
Chapter 3: Supporting Websense Installations
20 Websense Enterprise