Difference between revisions of "Cool Solution - Shallalist Downloader"

From Univention Wiki

Jump to: navigation, search
(Replaced content with "This page has been moved to the Knowledge Base Cool Solutions in the Forum. [https://help.univention.com/t/cool-solution-shallalist-downloader/13523 Cool Solution - Shall...")
Tag: Replaced
 
Line 1: Line 1:
{{Version|UCS=4.3}}
+
This page has been moved to the Knowledge Base Cool Solutions in the Forum.
{{Version|school=4.3}}
 
{{Cool Solutions Disclaimer|Repository=yes}}
 
{{#seo:
 
|title={{#replace:{{#replace:{{#replace:{{#replace:{{FULLPAGENAME}}|'|'}}|&|&}}|"|"}}|Cool Solution - |}} - {{SITENAME}}
 
<!--|description=-->
 
}}
 
  
The [http://www.shallalist.de/ Shalla Blacklists] provided by Shalla Secure Services are a collection of URL and Domain lists grouped in several categories, which are intended to be used with web filters. This Cool Solution describes the installation and usage of an automatic downloader which implements the blacklists into the Webproxy provided by UCS@school and another DNS Server blacklist solution.
+
[https://help.univention.com/t/cool-solution-shallalist-downloader/13523 Cool Solution - Shallalist Downloader]
  
Please note: Usage of the Shalla Blacklists may not be free of charge for your kind of application. To acknowledge the license, please read the following web page: [http://www.shallalist.de/licence.html shallalist.de/licence.html]
+
[[Category:EN]]
 
+
[[Category:Howtos]]
__TOC__
 
 
== Installation ==
 
Install the shalla-list downloader package:
 
<pre>univention-install univention-shalla-list-downloader</pre>
 
 
 
After installing the package, the downloader is ready to be configured.
 
 
 
== Configuration ==
 
Without any further configuration, the script won't do anything besides regularly downloading the newest shalla lists into the following local folder:
 
<pre>/usr/local/share/univention-shalla-list-downloader/</pre>
 
 
 
The downloader cronjob can be configured with the UCR variables <code>cron/shalla-list-downloader/command</code>, <code>cron/shalla-list-downloader/time</code> and <code>cron/shalla-list-downloader/description</code>.
 
Follow the descriptions below to automatically integrate the lists into different services.
 
 
 
=== Integrate the Shalla lists into the proxy server ===
 
Starting with UCS@school version 4.0 R2, it is possible to automatically integrate the blacklists into the proxy server provided. More information about this proxy can be found in the [https://docs.software-univention.de/ucsschool-handbuch-4.2.html#school:proxy:blacklists Documentation (German only).]<br>
 
 
 
Only the following UCR variables have to be set to achieve this. Everything else will be done automatically:
 
{| class="wikitable"
 
|-
 
!UCR Variable                              || Description                                                                                            || Example
 
|-
 
|<code>proxy/filter/global/blacklists/domains</code> || Space separated list of text files that will be included as blacklist for domains within the UCS@school proxy configuration || shallalists/adv/domains shallalists/hacking/domains shallalists/gamble/domains
 
|-
 
|<code>proxy/filter/global/blacklists/urls</code> || Space separated list of text files that will be included as blacklist for URLs within the UCS@school proxy configuration || shallalists/adv/urls shallalists/hacking/urls shallalists/gamble/urls
 
|}
 
Important is the correct format of these space separated lists. The first part of each entry for shalla lists is the prefix <code>shallalists/</code>. This is followed by the category name. All valid category names can be found in [http://www.shallalist.de/categories.html Shalla's Blacklists - Category description]. Each entry should be finished by the type name of the list. Valid values are <code>/domains</code> and <code>/urls</code> (each type should only be used in their according variable).<br>
 
Examples can be found in the table above.
 
 
 
=== Integrate the Shalla lists into the DNS server ===
 
It is possible to block certain websites through the UCS DNS Server. This can be helpful in situations, in which it isn't possible to force clients to use your proxy server.<br>
 
 
 
The following UCR variable has to be set after installing the [[Cool Solution - Simple domain blacklisting with DNS]]. A detailed description on how DNS blacklisting works and all its possibilities and restrictions can be found in the linked Cool Solution.
 
 
 
{| class="wikitable"
 
|-
 
!UCR Variable                              || Description                                                                                            || Example
 
|-
 
|<code>dns/blacklist/record/domains</code> || Space separated list of text files that will be included as blacklist for domains within the UCS DNS configuration || shallalists/adv/domains shallalists/hacking/domains shallalists/gamble/domains
 
|}
 
 
 
Important for this UCR space separated list is the correct format. The first part of each entry for shalla lists is the prefix <code>shallalists/</code>. This is followed by the category name. All valid category names can be found in [http://www.shallalist.de/categories.html Shalla's Blacklists - Category description]. Each entry should be finished by the type name <code>/domains</code>.<br>
 
Examples can be found in the table above.
 

Latest revision as of 16:04, 7 November 2019

This page has been moved to the Knowledge Base Cool Solutions in the Forum.

Cool Solution - Shallalist Downloader

Personal tools