Difference between revisions of "Internet Filter"
Line 3: | Line 3: | ||
!!UnderConstruction!! | !!UnderConstruction!! | ||
− | By default, Groovix does not filter internet traffic, but has the capability to do so. Groovix PAC software | + | By default, Groovix does not filter internet traffic, but has the capability to do so. Groovix PAC software uses [http://dansguardian.org/ DansGuardian] software for filtering internet traffic. [licence info]. |
+ | |||
+ | 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, DansGuradian will generate a page that reports to the user why which category triggered it. These lists can be fully customized to fit any specific use, including which categories are active and customized values for all phrases; the location of these lists can be found in more detail under the Filter Customization section of this page. | ||
+ | |||
== Installing the filter == | == Installing the filter == | ||
− | Adding <font class="code">adult-filtered</font> to /etc/groovix/type2 will trigger the download and installation of the | + | Adding <font class="code">adult-filtered</font> to <font class="code">/etc/groovix/type2</font> will trigger the download and installation of the internet filter the next time [[Groovix_NetCustomization]] is run. |
+ | |||
??Mike?? confirm type2 and adult-filtered are universal for all deployments ??Mike?? | ??Mike?? confirm type2 and adult-filtered are universal for all deployments ??Mike?? | ||
− | == Filter | + | |
− | + | == Filter Customization == | |
+ | * DansGuardian is 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 lists used by DansGuardian are located in <font class="code">/etc/dansguardian/lists/</font> | ||
== Toggling the Filter == | == Toggling the Filter == | ||
− | + | Enabling and disabling the filter is 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. | ||
+ | |||
+ | <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> | ||
== See Also == | == See Also == | ||
* [[PACMon]] | * [[PACMon]] | ||
− | * [[ | + | * [[Groovix NetCustomization]] |
− | * [[ | + | * [[Groovix Configuration]] |
Revision as of 23:01, 29 March 2011
!!UnderConstruction!!
By default, Groovix does not filter internet traffic, but has the capability to do so. Groovix PAC software uses DansGuardian software for filtering internet traffic. [licence info].
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, DansGuradian will generate a page that reports to the user why which category triggered it. These lists can be fully customized to fit any specific use, including which categories are active and customized values for all phrases; the location of these lists can be found in more detail under the Filter Customization section of this page.
Installing the filter
Adding adult-filtered to /etc/groovix/type2 will trigger the download and installation of the internet filter the next time Groovix_NetCustomization is run.
??Mike?? confirm type2 and adult-filtered are universal for all deployments ??Mike??
Filter Customization
- DansGuardian is installed in /etc/dansguardian/
- The configuration files for DansGuardian are located in /etc/dansguardian/dansguardian.conf
- The lists used by DansGuardian are located in /etc/dansguardian/lists/
Toggling the Filter
Enabling and disabling the filter is 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.