| ... |
... |
@@ -1,13 +1,15 @@ |
| 1 |
|
-[[**Plugin download**>>https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/fc-plugin-malware-scanner/ClamAV&fileid=40404]] |
|
1 |
+{{info}} |
|
2 |
+{{version major="7" minor="0" patch="13" showInfo="true"}} |
|
3 |
+This plugin can only be used with {{formcycle/}} version 7.0.13 or higher. |
|
4 |
+{{/version}} |
|
5 |
+{{/info}} |
| 2 |
2 |
|
|
7 |
+[[**Plugin download**>>https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/fc-plugin-malware-scanner/ClamAV&fileid=40404]] (Requires login) |
|
8 |
+ |
| 3 |
3 |
{{content/}} |
| 4 |
4 |
|
| 5 |
|
-{{figure image="en_plugin.png" width="600"}} |
| 6 |
|
- A TCP connection must be set up to use the ClamAV-daemon service to scan the uploaded files. |
| 7 |
|
-{{/figure}} |
|
11 |
+Uploaded files can be checked for viruses via the plug-in. For this purpose, this plugin is required as an activated system plugin and a running ClamAV-daemon service that can be accessed via TCP. |
| 8 |
8 |
|
| 9 |
|
-It is possible to use ClamAV to scan for malware in uploaded elements of the backend as well as of delivered forms. For this purpose, this plugin is required as an activated system plugin and a running ClamAV-daemon service that can be accessed via TCP. |
| 10 |
|
- |
| 11 |
11 |
After this plugin has been installed, it must be configured. The configuration consists of specifying which {{smallcaps}}host:port{{/smallcaps}} combination is to be used. Furthermore, the transfer can be done with a {{smallcaps}}InputStream{{/smallcaps}} or working straight on the path. |
| 12 |
12 |
|
| 13 |
13 |
== Configuration == |
| ... |
... |
@@ -19,8 +19,8 @@ |
| 19 |
19 |
The following configuration parameters exist: |
| 20 |
20 |
|
| 21 |
21 |
; host (Required) |
| 22 |
|
-: Host name or IP address of the server running ClamAV-daemon, {{smallcaps}}127.0.0.1{{/smallcaps}} if the service is running on the same server as {{formcycle/}}. |
| 23 |
|
-; port |
|
24 |
+: Host name or IP address of the server running ClamAV-daemon. The standard port is {{smallcaps}}127.0.0.1{{/smallcaps}}, since ClamAV-daemon should be running on the same server as {{formcycle/}}. |
|
25 |
+; port (Required) |
| 24 |
24 |
: The default port of ClamAV-daemon is {{smallcaps}}3310{{/smallcaps}}. If the port is different, it must be specified here. |
| 25 |
25 |
; file-source |
| 26 |
26 |
: By default, the element to be checked is transferred via Java's {{smallcaps}}InputStream{{/smallcaps}}. If the value {{smallcaps}}path{{/smallcaps}} is entered here, the path is used directly - whereby the ClamAV-daemon service must have root rights. |
| ... |
... |
@@ -29,26 +29,26 @@ |
| 29 |
29 |
|
| 30 |
30 |
== ClamAV settings == |
| 31 |
31 |
|
| 32 |
|
-The following section describes important configuration steps of ClamAV-daemon. In this scenario, {{formcycle/}} is installed on a Debian based server and the ClamAV-daemon service is running on the same system. |
|
34 |
+The following section discusses important configuration steps of ClamAV-Daemon. Our recommended scenario is to install {{formcycle/}} and the ClamAV-Daemon service on the same server. |
| 33 |
33 |
|
| 34 |
34 |
Since the actual virus scanning takes place separately from {{formcycle/}}, take care to keep the virus signature database up-to-date via {{smallcaps}}freshclam{{/smallcaps}}. |
| 35 |
35 |
|
| 36 |
|
-This plugin transmits the elements to be examined via TCP, which is deactivated by default in ClamAV-daemon. To enable it, the configuration file under: {{smallcaps}}/etc/clamav/clamd.conf{{/smallcaps}}. |
|
38 |
+This plugin transmits the elements to be examined via TCP, which is deactivated by default in ClamAV-daemon. To enable it, the configuration file: {{smallcaps}}/etc/clamav/clamd.conf{{/smallcaps}} has to be edited. |
| 37 |
37 |
|
| 38 |
|
-Folgende Parameter müssen der Datei hinzugefügt werden: |
|
40 |
+The following parameters have to be added to the file: |
| 39 |
39 |
|
| 40 |
|
-; TCPAddr (Erforderlich) |
| 41 |
|
-: Soll hinzugefügt und mit dem Wert {{smallcaps}}127.0.0.1{{/smallcaps}} angegeben werden. |
| 42 |
|
-; TCPSocket (Erforderlich) |
| 43 |
|
-: Soll hinzugefügt und mit dem Wert {{smallcaps}}3310{{/smallcaps}} angegeben werden oder abweichend, falls der Port anderweitig genutzt werden soll. |
|
42 |
+; TCPAddr (Required) |
|
43 |
+: Shall be added and specified with the value {{smallcaps}}127.0.0.1{{/smallcaps}}. |
|
44 |
+; TCPSocket (Required) |
|
45 |
+: Shall be added and specified with the value {{smallcaps}}3310{{/smallcaps}} or different, if the port is occupied. |
| 44 |
44 |
; User |
| 45 |
|
-: Ist standardmäßig {{smallcaps}}clamav{{/smallcaps}} und muss zu {{smallcaps}}root{{/smallcaps}} geändert werden um dem Clamav-Daemon Service root Rechte zu geben. |
|
47 |
+: By default this is {{smallcaps}}clamav{{/smallcaps}} and has to be changed to {{smallcaps}}root{{/smallcaps}} to give root rights to the ClamAV-daemon service. |
| 46 |
46 |
|
| 47 |
47 |
{{figure image="en_tcp_test.png"}} |
| 48 |
|
- Mithilfe von {{smallcaps}}netstat{{/smallcaps}} kann der TCP Socket vom Clamav-Daemon Service untersucht werden. |
|
50 |
+ With the help of {{smallcaps}}netstat{{/smallcaps}} the TCP socket of the ClamAV-daemon service can be examined. |
| 49 |
49 |
{{/figure}} |
| 50 |
50 |
|
| 51 |
|
-Damit dieses Plugin den Clamav-Daemon Service ansprechen kann, muss der Service an der richtigen Stelle zuhören - in diesem Fall unter {{smallcaps}}127.0.0.1:3310{{/smallcaps}}. Das kann durch folgenden Befehl im Terminal überprüft werden: |
|
53 |
+In order for this plugin to address the ClamAV-daemon service, the service has to be listening in the right place - in this case at {{smallcaps}}127.0.0.1:3310{{/smallcaps}}. This can be checked by the following command in the terminal: |
| 52 |
52 |
|
| 53 |
53 |
{{code language="shell"}} |
| 54 |
54 |
sudo netstat -anp | grep -E "(clam)" |
