2,569
edits
Changes
Jump to navigation
Jump to search
mLine 1:
Line 1: − + − '''Author: Ray Mitchell - mitchellcpa_AT_yahoo_dot_com_dot_au'''+ − '''Howto Release Date & Version: 11 July 2007 - v7.3'''+ − '''sme server version supported: 7.1.3'''+ − + − − − Dungog.net sells a commercial implementation of Dansguardian for sme server which adds a server manager panel to allow GUI control of all Dansguardian functionality & settings.+ − + Line 29:
Line 27: − + − − − Line 47:
Line 42: − − Line 58:
Line 51: − + − + Line 134:
Line 127: − + Line 183:
Line 176: − + Line 214:
Line 207: − + Line 225:
Line 218: − + Line 241:
Line 234: − + Line 249:
Line 242: − + Line 275:
Line 268: + + + + + + + +
no edit summary
== Dansguardian web content filtering HOWTO install & configure on sme 7.x ==
== Dansguardian web content filtering ==
=== Description ===
Dansguardian Filters Web content, http://dansguardian.org
===Contributors===
Original Howto Author: Ray Mitchell - mitchellcpa_AT_yahoo_dot_com_dot_au
==='''Contributors'''===
Thanks to Stephen Noble at dungog.net for providing rpms & information generally. This HOWTO requires command line control to edit configuration files & restart the dansguardian service after configuration changes.
Thanks to Stephen Noble at dungog.net for providing rpms & information generally. This HOWTO requires command line control to edit configuration files & restart the dansguardian service after configuration changes.
http://www.dungog.net sells a commercial implementation of Dansguardian for sme server which adds a server manager panel to allow GUI control of all Dansguardian functionality & settings.
==='''Information'''===
===Information===
To have a proper understanding of how Dansguardian works and the importance of certain configuration settings you should read the detailed installation notes and Manual at the Dansguardian web site http://dansguardian.org
To have a proper understanding of how Dansguardian works and the importance of certain configuration settings you should read the detailed installation notes and Manual at the Dansguardian web site http://dansguardian.org
The information on the Dansguardian website is of a generic nature and some of it is NOT applicable to sme server installations, refer to the instructions in this HOWTO in preference.
The information on the Dansguardian website is of a generic nature and some of it is NOT applicable to sme server installations, refer to the instructions in this HOWTO in preference.
==='''Installation instructions'''===
===Installation instructions===
{{Warning box|Do not upgrade dansguardian v2.9 over previous v2.8 (or earlier) installations as there are substantial changes. (The recommendation from Dansguardian is to edit the new configuration files/lists rather than try to edit your old ones)}}
{{Warning box|Do not upgrade dansguardian v2.9 over previous v2.8 (or earlier) installations as there are substantial changes. (The recommendation from Dansguardian is to edit the new configuration files/lists rather than try to edit your old ones)}}
{{Note box|Please check the dungog.net web site for later versions http://sme.dungog.net/packages/smeserver/7.0/i386/html/index_dungog.html}}
{{Note box|Please check the dungog.net web site for later versions http://sme.dungog.net/packages/smeserver/7.0/i386/html/index_dungog.html}}
Download the required rpms into an empty folder on your sme server using the Linux wget command
Download the required rpms into an empty folder on your sme server using the Linux wget command
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/rmitchell/smeserver/contribs/dansguardian/rpms/2.9.8-2/dansguardian-2.9.8-2.noarch.rpm</nowiki>
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/rmitchell/smeserver/contribs/dansguardian/rpms/2.9.8-2/dansguardian-2.9.8-2.noarch.rpm</nowiki>
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/rmitchell/smeserver/contribs/dansguardian/rpms/2.9.8-2/smeserver-dansguardian-2.9-3.el4.sme.noarch.rpm</nowiki>
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/rmitchell/smeserver/contribs/dansguardian/rpms/2.9.8-2/smeserver-dansguardian-2.9-3.el4.sme.noarch.rpm</nowiki>
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/rmitchell/smeserver/contribs/dansguardian/rpms/2.8.0.6/dungog-blacklists-1.0-20061002.noarch.rpm</nowiki>
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/rmitchell/smeserver/contribs/dansguardian/rpms/2.8.0.6/dungog-blacklists-1.0-20061002.noarch.rpm</nowiki>
yum localinstall *.rpm
yum localinstall *.rpm
Alternatively you can add the dungog repository
Alternatively you can add the dungog repository
yum --enablerepo=dungog list updates
yum --enablerepo=dungog list updates
==='''Modifying Firewall and Proxy'''===
===Modifying Firewall and Proxy===
===='''Configuring your system to force Dansguardian usage & prevent bypassing'''====
====Configuring your system to force Dansguardian usage & prevent bypassing====
Dansguardian uses port 8080 for web proxy requests. If your browser does not use port 8080 then Dansguardian filtering will be bypassed. To force this usage & prevent users bypassing filtering you should do the following steps:
Dansguardian uses port 8080 for web proxy requests. If your browser does not use port 8080 then Dansguardian filtering will be bypassed. To force this usage & prevent users bypassing filtering you should do the following steps:
https://sourceforge.net/projects/retinascan
https://sourceforge.net/projects/retinascan
==='''Modifying Dansguardian configuration'''===
===Modifying Dansguardian configuration===
You need to manually modify configuration files /etc/dansguardian/dansguardian.conf and /etc/dansguardian/dansguardianf1.conf and /etc/dansguardian/dansguardianf2.conf and /etc/dansguardian/dansguardianf3.conf and so on depending on the number of filter groups you wish to have.
You need to manually modify configuration files /etc/dansguardian/dansguardian.conf and /etc/dansguardian/dansguardianf1.conf and /etc/dansguardian/dansguardianf2.conf and /etc/dansguardian/dansguardianf3.conf and so on depending on the number of filter groups you wish to have.
===='''Modifying other Dansguardian configuration files'''====
====Modifying other Dansguardian configuration files====
You will need to change other config files to suit your site requirements:
You will need to change other config files to suit your site requirements:
===='''Modifying the default html error message page'''====
====Modifying the default html error message page====
You may also want to tailor the html template for the error message displayed when Dansguardian blocks a site, see
You may also want to tailor the html template for the error message displayed when Dansguardian blocks a site, see
===='''Groups and Auth login'''====
====Groups and Auth login====
See http:/dansguardian.org re Group configuration functionality in relation to Auth login (ie filtering users access rights based on group membership)
See http:/dansguardian.org re Group configuration functionality in relation to Auth login (ie filtering users access rights based on group membership)
Edit these to suit your site requirements
Edit these to suit your site requirements
===='''Other Dansguardian Config Files'''====
====Other Dansguardian Config Files====
There are many other config files, including but not limited to the one in this appendix
There are many other config files, including but not limited to the one in this appendix
[[:Dansguardian/ConfigFiles]]
[[:Dansguardian/ConfigFiles]]
==='''Starting Dansguardian'''===
===Starting Dansguardian===
After install & initial configuration you must manually start Dansguardian to enable web content filtering
After install & initial configuration you must manually start Dansguardian to enable web content filtering
/etc/init.d/dansguardian status
/etc/init.d/dansguardian status
=== Bugs ===
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-dansguardian component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-dansguardian|title=this link}}.
=== Tested software versions ===
* Host: SMEserver v7.2
* Installed: smeserver-dansguardian 0.9-3.el4.sme
* Dependency Installed: dansguardian 2.9-2
----
[[Category:Contrib]]
[[Category:Contrib]]
[[Category:Dungog]]
[[Category:Dungog]]