Difference between revisions of "Internet Filter"

From GroovixWiki
Jump to: navigation, search
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__TOC__
 
__TOC__
 
!!UnderConstruction!!
 
  
 
By default, Groovix does not filter internet traffic, but has the capability to do so. The Groovix filtering system uses a modified version of [http://dansguardian.org/ DansGuardian] software. DansGuardian software is open source but uses a [http://dansguardian.org/?page=copyright2 non-standard license that is not free for commercial use]. Groovix is a licensed DansGuardian solution provider.  
 
By default, Groovix does not filter internet traffic, but has the capability to do so. The Groovix filtering system uses a modified version of [http://dansguardian.org/ DansGuardian] software. DansGuardian software is open source but uses a [http://dansguardian.org/?page=copyright2 non-standard license that is not free for commercial use]. Groovix is a licensed DansGuardian solution provider.  
Line 15: Line 13:
  
 
== Installing the filter ==
 
== Installing the filter ==
After consulting with Groovix staff you will use different workstation "types" to determine whether or not a workstation will be filtered.  For example, adding <font class="code">adult-filtered</font> to <font class="code">/etc/groovix/type2</font> could trigger the download and installation of the internet filter the next time [[Groovix_NetCustomization]] is run.  
+
After consulting with Groovix staff you will use different workstation "types" to determine whether or not a workstation will be filtered.  For example, adding <font class="code">filtered</font> to <font class="code">/etc/groovix/type2</font> could trigger the download and installation of the internet filter the next time [[Groovix_NetCustomization]] is run.  
 +
 
  
 
== Filter Customization ==
 
== Filter Customization ==
 
* DansGuardian configuration files are installed in <font class="code">/etc/dansguardian/</font>
 
* DansGuardian configuration files are installed in <font class="code">/etc/dansguardian/</font>
* The configuration files for DansGuardian are located in <font class="code">/etc/dansguardian/dansguardian.conf</font>
+
* The main configuration files for DansGuardian are located at <font class="code">/etc/dansguardian/dansguardianf1.conf</font> and <font class="code">/etc/dansguardian/dansguardian.conf</font>
 
* The lists used by DansGuardian are located in <font class="code">/etc/dansguardian/lists/</font><br /><br />
 
* The lists used by DansGuardian are located in <font class="code">/etc/dansguardian/lists/</font><br /><br />
  
Line 25: Line 24:
  
 
== Toggling the Filter ==
 
== Toggling the Filter ==
If you have decided to allow your staff to enable/disable filtering per workstation on demand, that can be done through the [[PACMon]] interface on the [[Groovix Dashboard]]. First, click on the machine you want to toggle the filter on. In the new window that pops up, click the link titled, filter. In this page the top line states whether the filter is currently active or inactive. Click on the button indicating whether you want to enable or disable the filter; it can take up to one minute for this action to take effect.<br /><br />
+
If you have decided to allow your staff to enable/disable filtering per workstation on demand, that can be done through the [[PACMon]] interface on the [[Groovix Dashboard]]. First, click on the machine you want to toggle the filter on. In the new window that pops up, click the link titled, filtering.
 +
 
 +
<div style="float: left;">
 +
[[File:Groovix-Filtering-1.jpg|frame| PACMon web filter access]]
 +
</div><div style="clear: left;"></div>
 +
 
 +
In this page the top line states whether the filter is currently active or inactive, click on the button indicating whether you want to enable or disable the filter; it can take up to one minute for this action to take effect.<br /><br />
 +
 
 +
<div style="float: left;">
 +
[[File:Groovix-Filtering-2.jpg|frame| Web filter buttons]]
 +
</div><div style="clear: left;"></div>
 +
 
 +
<div class="dashed-box">Note: disabling the filter can be done while a user is logged in and will remain disabled for the duration of their session (unless disabled manually). Groovix will automatically re-enable the filter once the user has ended their session; it is not necessary for staff to keep track and enable it for the next user.</div>
 +
 
  
<div class="dashed-box">Note: disabling the filter can be done while a user is logged in and will remain disabled for the duration of their session (unless disabled manually). Groovix will automatically re-enable the filter once the user has ended their session; it is not necessary for staff to enable it for the next user.</div>
+
== Filter Performance ==
 +
Once the filter is active, web browsing speed can be reduced significantly if your local DNS server is not capable of handling the extra lookup requests made by DansGuardian; workstations running internet filtering have '''at least''' one additional name lookup for nearly every web request. This issue can be resolved by creating a DNS cache of visited sites that the web browser will query instead of the local DNS server. Steps on how to perform this fix are located on the [[Filter Performance Fix]] page of the [[Administrators Guide]].
  
  

Latest revision as of 21:32, 14 April 2012

By default, Groovix does not filter internet traffic, but has the capability to do so. The Groovix filtering system uses a modified version of DansGuardian software. DansGuardian software is open source but uses a non-standard license that is not free for commercial use. Groovix is a licensed DansGuardian solution provider.

DansGuardian uses various lists to determine which pages are blocked and why to report back to the user why the requested page was blocked.

  • the whitelist will allow pages or whole domains regardless of their content
  • the blacklist will block pages or whole domains regardless of their content
  • the phraselist searches for phrases in page content based on separate categories

The phraselist contains a list of phrases in multiple categories on which each page is subjected to. Each phrase has a numerical value assigned to it that adds to a total for that category each time the phrase is found on a page. Each category has a threshold of how high the total phrase values found can reach before a page is considered blocked. When a page is blocked, GroovixGuardian will generate a page that reports to the user why which category triggered it.


Installing the filter

After consulting with Groovix staff you will use different workstation "types" to determine whether or not a workstation will be filtered. For example, adding filtered to /etc/groovix/type2 could trigger the download and installation of the internet filter the next time Groovix_NetCustomization is run.


Filter Customization

  • DansGuardian configuration files are installed in /etc/dansguardian/
  • The main configuration files for DansGuardian are located at /etc/dansguardian/dansguardianf1.conf and /etc/dansguardian/dansguardian.conf
  • The lists used by DansGuardian are located in /etc/dansguardian/lists/

All configuration files and lists used by DansGuardian are fully editable. The values in the configuration files and phraselists can be fully customized to fit any specific use, including which categories are active and customized values for all phrases. Include statements are frequently used to allow hierarchy and reuse.

Toggling the Filter

If you have decided to allow your staff to enable/disable filtering per workstation on demand, that can be done through the PACMon interface on the Groovix Dashboard. First, click on the machine you want to toggle the filter on. In the new window that pops up, click the link titled, filtering.

PACMon web filter access

In this page the top line states whether the filter is currently active or inactive, click on the button indicating whether you want to enable or disable the filter; it can take up to one minute for this action to take effect.

Web filter buttons
Note: disabling the filter can be done while a user is logged in and will remain disabled for the duration of their session (unless disabled manually). Groovix will automatically re-enable the filter once the user has ended their session; it is not necessary for staff to keep track and enable it for the next user.


Filter Performance

Once the filter is active, web browsing speed can be reduced significantly if your local DNS server is not capable of handling the extra lookup requests made by DansGuardian; workstations running internet filtering have at least one additional name lookup for nearly every web request. This issue can be resolved by creating a DNS cache of visited sites that the web browser will query instead of the local DNS server. Steps on how to perform this fix are located on the Filter Performance Fix page of the Administrators Guide.


See Also