1,574
edits
Changes
From SME Server
Jump to navigationJump to searchCorrect path error /dguardianurlipc to /tmp/.dguardianurlipc
== Dansguardian web content filtering ==
== Dansguardian web content filtering ==
{{Level|Medium}}
{{Level|Medium}}
=== Version ===
{{ #smeversion: dansguardian}}
{{ #smeversion: smeserver-dansguardian}}
=== 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 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,
After you make any changes to the template.html you will need to run the command,
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]]
