Differences

This shows you the differences between two versions of the page.

--- en:dpi:dpi_options:opt_filtration:filtration_settings [2020/02/05 17:29] – ↷ Page moved from en:dpi:dpi_options:base_functionality:opt_filtration:filtration_settings to en:dpi:dpi_options:opt_filtration:filtration_settings lexx26
+++ en:dpi:dpi_options:opt_filtration:filtration_settings [2024/09/30 11:15] (current) – atereschenko
@@ Line 1: / Line 1: @@
-====== 2 Configuration ======
+====== Configuration ======
+{{indexmenu_n>2}}
+<note warning>The system is delivered with black list filtering option turned on.</note>
+You can configure the option or turn it off by configuration file **/etc/dpi/fastdpi.conf**. All parameters are optional and have default values.
+===== Filtering service configuration =====
+<code>federal_black_list=2 enables automatic loading and application of cloud service list
+(0 - disables)</code>
+The lists received from clouds are placed to the directory **/var/lib/dpi**. Their names are:
+**blcache.bin** - URL dictionary to block HTTP\\
+**blcachecn.bin** - names' dictionary to block HTTPS by certificates\\
+**blcacheip.bin** - IP addresses dictionary to block HTTPS by IP\\
+**blcachesni.bin** - dictionary to block HTTPS by SNI
+<note important>The subscriber's browser receives 403 error (Forbidden) as a reply on an attempt to access a restricted page by HTTP protocol. Its look depends on the browser in use. \\
+This behaviour can be modified. The browser can be redirected to a special operator's information page Instead of the error code((in case this parameter ends by ? or &: the parameter UrlRedir is added to the formed URL. It points to a page selected by the subscriber.))((you should add parameters can be added usingr ? or & (by HTTP rules), otherwise the DPI adds /? to the URL))</note>
+Page setup for redirect:
+<code>black_list_redirect=http://operator.com/blockpage.html</code>
+The black list update period can be configured. It is 60 minutes by default:
+<code>timeout_check_new_bl=60</code>
+<note important>We recommend making the download period no more than 5 minutes. The lists are updated automatically without interruption of the service and the need to restart /reload.</note>
+The service has to load modified parameters after configuration changes. One can do it by the following instructions (([[en:dpi:update:troubleshooting|Corrections]])):
+To update modified "hot" parameters:
+<code>service fastdpi reload</code>
+To update all parameters by the service's restart:
+<code>service fastdpi restart</code>
+:!: The short break (less than 1 second) in service is caused by restart, if the Bypass is not supported.
+<note>The "hot" parameters: federal_black_list,only_tcp,timeout_check_new_bl \\
+The "cold" parameters: black_list_redirect,custom_url_black_list,custom_cn_black_list,custom_ip_black_list,custom_sni_black_list \\
+You can find more details here: [[en:dpi:dpi_components:platform:dpi_admin|administering]]
+</note>
+===== Custom lists configuration =====
+<note important>Preparing dictionaries with URL, SNI, CN and IP addresses is described [[en:dpi:dpi_options:opt_filtration:making_dictionary|in the next section of the documentation]].</note>
+The operator can attach his own black list.
+<code>#URL dictionary for blocking by HTTP protocol
+custom_url_black_list=http://operator.com/url_list.dic
+#Names dictionary for blocking HTTPS by certificate
+custom_cn_black_list=http://operator.com/cn_list.dic
+#IP addresses dictionary for blocking HTTPS by IP
+custom_ip_black_list=http://operator.com/ip_list.dic
+#Hosts names dictionary for blocking HTTPS by SNI (Server Name Indication)
+custom_sni_black_list=http://operator.com/sni_list.dic
+</code>
+URL field can be used to specify ftp protocol and authentication parameters.
+The lists downloaded from the specified URL are stored in /var/lib/dpi. Their names are:
+**blcustom.bin** - the URL dictionary to block HTTP\\
+**blcustomcn.bin** - the name's dictionary to block HTTPS by certificate\\
+**blcustomip.bin** - the IP addresses' dictionary to block HTTPS by IP\\
+**blcustomsni.bin** - the IP addresses' dictionary to block HTTPS by SNI
+===== Additional Information =====
+'#' character at the beginning of a configuration file line marks the comment.
+In case the service is used to filter by black list only, we advise to switch off the analysis of protocols rather than HTTP. It helps increase productivity and reduces CPU load:
+<code>only_tcp=1</code>
+If the black lists are created on the same computer that runs DPI: you can just put them to **/var/lib/dpi** directory. Their names must be **blcustom.bin, blcustomsni.bin, blcustomcn.bin and blcustomip.bin,** same as above.\\
+<note warning>Use only command mv for moving dictionaries - it's atomic, don't use copying!</note>
+===== Switching off the custom lists =====
+To switch off additional (operator's) black lists:
+Comment out or remove the parameters from configuration file **/etc/dpi/fastdpi.conf**:
+<code>custom_url_black_list, custom_ip_black_list, custom_cname_black_list, custom_sni_black_list
+</code>
+To remove local lists:
+<code>
+rm /var/lib/dpi/blcustom.bin
+rm /var/lib/dpi/blcustomcn.bin
+rm /var/lib/dpi/blcustomip.bin
+rm /var/lib/dpi/blcustomsni.bin
+</code>
+Here's the translation of the blocking settings:
+=====Blocking Settings=====
+Add the parameter ''block_options'' to the configuration file ''/etc/dpi/fastdpi.conf''.
+Values:
+  * 1 — block regardless of the presence of SNI
+  * 2 — block all ports on the address
+  * 4 — block all of IPv6 (when the [[en:dpi:dpi_options:opt_filtration:filtration_ctrl|service 4]] is enabled)
+  * 8 — do not generate RST packets for blocking and redirection for `inet–>subs` packet direction