877
edits
Changes
Jump to navigation
Jump to search
Line 2:
Line 2: + + + + + + + + + + + Line 33:
Line 44: + Line 147:
Line 159: − + + + Line 180:
Line 194: + − Line 209:
Line 223: − + + + Line 215:
Line 231: − eg+ + + + − + + + Line 422:
Line 443: + + + + + + + + + + + + + + + + + + + + + + + + + + Line 427:
Line 474: − + − Line 503:
Line 549: + + + + + + + + + Line 509:
Line 564: + +
no edit summary
== Dansguardian web content filtering ==
== Dansguardian web content filtering ==
{{Level|Medium}}
{{Level|Medium}}
{{Warning box| Dansguardian is deprecated and not available on Koozali SME v10.
There is a fork called e2guardian http://e2guardian.org/cms/index.php and https://github.com/e2guardian }}
=== Version ===
{{ #smeversion: dansguardian}}
{{ #smeversion: smeserver-dansguardian}}
Also see:
https://wiki.koozali.org/index.php?title=Dansguardian-panel
{{ #smeversion: smeserver-dansguardian-panel}}
=== Description ===
=== Description ===
Optional, download and install a set of blacklists from http://urlblacklist.com/
Optional, download and install a set of blacklists from http://urlblacklist.com/
alternatively you can choose ftp://ftp.ut-capitole.fr/pub/reseau/cache/squidguard_contrib/blacklists.tar.gz from http://dsi.ut-capitole.fr/blacklists/
{{Note box|It is not sufficient to simply install the package, the appropriate manual configuration is an integral part of getting Dansguardian working on your system. A minimal installation requires all the configuration steps listed below to be carried out, ie from the "Modifying Firewall and Proxy" section up to "Filter Groups and Auth login". Filter Group configuration is only required if you wish to control access on a per user basis.}}
{{Note box|It is not sufficient to simply install the package, the appropriate manual configuration is an integral part of getting Dansguardian working on your system. A minimal installation requires all the configuration steps listed below to be carried out, ie from the "Modifying Firewall and Proxy" section up to "Filter Groups and Auth login". Filter Group configuration is only required if you wish to control access on a per user basis.}}
* '''TCP'''
* '''TCP'''
===Modifying Dansguardian configuration===
===Modifying Dansguardian Configuration Files===
====Modifying Dansguardian dansguardian.conf & dansguardianf1.conf files====
You need to manually modify various configuration files.
You need to manually modify various configuration files.
Ctrl x
Ctrl x
Additional Options can be found here, http://wiki.contribs.org/Dansguardian/ConfigFiles under the topic dansguardian.conf & dansguardianf1.conf
If you have additional filter groups, then additional configuration files will need to be created and modified. See section on "Filter Groups and Auth login" below.
If you have additional filter groups, then additional configuration files will need to be created and modified. See section on "Filter Groups and Auth login" below.
====Modifying other Dansguardian configuration files====
====Modifying other Dansguardian configuration files====
You should review ALL the dansguardian config files in /etc/dansguardian/lists and subfolders as part of your initial Dansguardian setup.
You should review ALL the dansguardian config files in /etc/dansguardian/lists and subfolders as part of your initial Dansguardian setup.
Some of the default settings in these files will prevent access to certain web sites and file types, which may conflict with your site requirements. See more details on the [[:Dansguardian/ConfigFiles]] page of this Howto or at http://dansguardian.org
Some of the default settings in these files will prevent access to certain web sites and file types, which may conflict with your site requirements.
For many more details and descriptions on the configuration files see [[:Dansguardian/ConfigFiles]] page of this Howto or at http://dansguardian.org
====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
/etc/dansguardian/languages/(languagename)/template.html
/etc/dansguardian/languages/(languagename)/template.html
or in some newer versions
/usr/share/dansguardian/languages/(languagename)/template.html
e.g.
pico -w /etc/dansguardian/languages/ukenglish/template.html
pico -w /etc/dansguardian/languages/ukenglish/template.html
After you make any changes to the template.html you will need to run the command,
/etc/init.d/dansguardian restart
for the changes to take effect.
====Filter Groups and Auth login====
====Filter Groups and Auth login====
DansGuardian should block the download!
DansGuardian should block the download!
=====ClamAV & Dansguardian on SME 9+=====
The path to clamd.socket changed with SME 9, and [https://forums.contribs.org/index.php/topic,52519.msg269937.html#msg269937 users report] file access rights issues between dansguardian and clamav.
After installing DansGuardian and completing the clamav setup instructions above, there are 3 extra steps to take on SME9:
1. The path to clamd.socket must match the path given in /etc/clamd.conf
* edit <span style="color:blue;">/etc/dansguardian/contentscanners/clamdscan.conf</span> and set clamdudsfile to:
clamdudsfile = '/var/clamav/clamd.socket'
2. Dansguardian and Clamav must run as the same user for clamav scanning to work. Set Dansguardian to run as 'clamav' as follows:
* edit <span style="color:blue;">/etc/dansguardian/dansguardian.conf</span>
** uncomment 'daemonuser' and 'daemongroup'
** set 'daemonuser' to 'clamav':
daemonuser = 'clamav'
daemongroup = 'dansguardian
3. Correct the ownership on existing files and folders that belong to the original dansguardian user account.
* Execute the commands below
chown clamav /var/log/dansguardian/access.log
'rm' -rf /tmp/.dguardianipc
'rm' -rf /tmp/.dguardianurlipc
Restart dansguardian and test
/etc/init.d/dansguardian restart
====Other Dansguardian Config Files====
====Other Dansguardian Config Files====
There are many other config files, including but not limited to the ones in this appendix
There are many other config files, including but not limited to the ones in this appendix
See [[:Dansguardian/ConfigFiles]]
[[:Dansguardian/ConfigFiles]]
===Starting Dansguardian===
===Starting Dansguardian===
=== Bugs ===
=== 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}}.
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}}.
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-dansguardian|noresultsmessage="No open bugs found."}}
===Changelog===
Only versions released in smecontrib are listed here.
{{ #smechangelog: smeserver-dansguardian}}
[[Category:Dungog]]
[[Category:Dungog]]
[[Category:Administration:Content Spam Virus Blocking]]
[[Category:Administration:Content Spam Virus Blocking]]
[[Category:Security]]
[[Category:Contrib:webfiltering]]