Changes

{{Languages}}

{{Languages}}

 

=== Maintainer ===

=== Maintainer ===

[http://www.firewall-services.com Firewall Services]<br>

[http://www.firewall-services.com Firewall Services]<br>

mailto:daniel@firewall-services.com

mailto:daniel@firewall-services.com

 

=== Description ===

=== Description ===

This contrib can replace dansguardian if you have simple filtering requirements. It's really easy to configure, but is also less powerful. Dansguardian is a real content scanner (it analyse the content of the pages while squidguard only look at the URLs for example).

This contrib can replace dansguardian if you have simple filtering requirements. It's really easy to configure, but is also less powerful. Dansguardian is a real content scanner (it analyse the content of the pages while squidguard only look at the URLs for example).

=== Screenshots ===

=== Screenshots ===

[[File:Webfilter_2.png|webfilter panel]]

[[File:Webfilter_2.png|webfilter panel]]

=== Installation ===

=== Installation===

 

To install the contrib, simply run the following command:

To install the contrib, simply run the following command:

  expand-template /etc/httpd/conf/httpd.conf

  expand-template /etc/httpd/conf/httpd.conf

  sv t /service/httpd-e-smith

  sv t /service/httpd-e-smith

You can then access the new panel in the server-manager. The first time you access it, you might have an empty category list. Just click the save button at the bottom of the page, wait a few minutes and try again (the list is empty because categories hasn't been downloaded yet). Now, you should be able to enable URL and AV filtering, and choose which categories you want to block. The next settings modification might take a long time (several minutes, you may also have a timeout error displayed). This is expected and is because squidGuard databases need to be compiled. After this, settings change should be fast.

You can then access the new panel in the server-manager. The first time you access it, you might have an empty category list. Just click the save button at the bottom of the page, wait a few minutes and try again (the list is empty because categories hasn't been downloaded yet). Now, you should be able to enable URL and AV filtering, and choose which categories you want to block. The next settings modification might take a long time (several minutes, you may also have a timeout error displayed). This is expected and is because squidGuard databases need to be compiled. After this, settings change should be fast.

  *.phobos.apple.com

  *.phobos.apple.com

With this, those appstoire won't be scanned by the AV engine, and they will work just as before.

With this, those appstores won't be scanned by the AV engine, and they will work just as before.

===Customize category lists===

===Customize category lists===

Category lists are simple text files in /var/lib/squidGuard/blacklists. Each category is a directory, and each directory may have a file named '''domains''' and another named '''urls'''. Each directory in /var/lib/squidGuard/blacklists will be displayed in the panel of the server-manager, except if it's listed in the DisabledCategories prop. You can see which categories are disabled with:

Category lists are simple text files in /var/squidGuard/blacklists. Each category is a directory, and each directory may have a file named '''domains''' and another named '''urls'''. Each directory in /var/lib/squidGuard/blacklists will be displayed in the panel of the server-manager, except if it's listed in the DisabledCategories prop. You can see which categories are disabled with:

  db configuration getprop squidguard DisabledCategories

  db configuration getprop squidguard DisabledCategories

This lets you ignore some useless categories, and hide them from the panel.

This lets you ignore some useless categories, and hide them from the panel.

Now, you can edit this new file to your need. Then, just select it as the default blocked page:

Now, you can edit this new file to your need. Then, just select it as the default blocked page:

  db configuration setprop squidguard RedirectURL \

  db configuration setprop squidguard RedirectUrl \

  http://hostname.systemname.com/squidGuard/cgi-bin/custom.cgi?clientaddr=%a&clientname=%n&clientuser=%i&clientgroup=%s&targetgroup=%t&url=%u

  http://hostname.systemname.com/squidGuard/cgi-bin/custom.cgi?clientaddr=%a&clientname=%n&clientuser=%i&clientgroup=%s&targetgroup=%t&url=%u

  signal-event http-proxy-update

  signal-event http-proxy-update

===MySQL logs===

===MySQL logs===

MySQL loging of clients requests is handled by a independent daemon called squid-db-logd. It monitors squid access log and squidGuard deny log in real time, parse it and put everything in the database called squid_log. In this database, the table access_log list all the access while the deny_log only list denied pages. This feature may need a lot of disk space. On a busy server, you can easily reach 3GB / month only for the database (and more for the dump when you backup your server). To limit the needed space, a cron job rotate and compress the access_log and deny_log tables each month. Old tables are also removed. The default config keeps one year of log. You can change this setting with (value is in day and default is 365)

MySQL loging of clients requests is handled by a independent daemon called squid-db-logd. It monitors squid access log and squidGuard deny log in real time, parse it and put everything in the database called squid_log. In this database, the table access_log list all the access while the deny_log only list denied pages. This feature may need a lot of disk space. On a busy server, you can easily reach 3GB / month only for the database (and more for the dump when you backup your server). To limit the needed space, a cron job remove the oldest entries. The default config keeps one year of log. You can change this setting with (value is in day and default is 365)

  db configuration setprop squid-db-logd Retention 180

  db configuration setprop squid-db-logd Retention 180

===Uninstall===

===Uninstall===

If you want to uninstall this contrib, just run:

If you want to uninstall this contrib, just run:

  yum remove squidguard squidclamav

  yum remove squidGuard squidclamav

  expand-template /etc/squid/squid.conf

  expand-template /etc/squid/squid.conf

  squid -k reconfigure

  squid -k reconfigure

  rm -f /etc/squidclamav.conf

  rm -f /etc/squidclamav.conf

===Panel and translation===

===Bugs===

The panel is translated in English, French, Dutch and Italian.

and select the {{#var:smecontribname}} component or use {{BugzillaFileBug|product=SME%20Contribs|component={{#var:smecontribname}}|title=this link}}

 

Below is an overview of the current issues for this contrib:{{#bugzilla:columns=id,product,version,status,summary|sort=id|order=desc|component={{#var:smecontribname}} |noresultsmessage=No open bugs found.}}

 

Only released versions in smecontrib are listed here.

For now, this contrib is not available for translation in pootle (because it's in our own GIT repo). If you want to help with translation, you can get the file /etc/e-smith/locale/en-us/etc/e-smith/web/functions/webfilter (or directly from [https://gitweb.firewall-services.com/?p=smeserver-webfilter;a=blob_plain;f=root/etc/e-smith/locale/en-us/etc/e-smith/web/functions/webfilter here]) translate it, and send it back to us by mail at tech @ firewall-services . com

{{#smechangelog:{{#var:smecontribname}}}}

[[Category:Contrib]]

[[Category:Contrib]]