Änderungen von Dokument ClamAV


Von Version 1.2
bearbeitet von fse
am 16.05.2022, 13:02
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 13.1
bearbeitet von fse
am 25.05.2022, 10:10
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,5 +1,83 @@
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 +Dieses Plugin kann nur mit {{formcycle/}} Version 7.0.13 oder höher verwendet werden.
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]] (erfordert Anmeldung)
8 +
3 3  {{content/}}
4 4  
11 +Mit dem kostenlosen //ClamAV//-Plugin für {{formcycle/}} besteht die Möglichkeit, hochgeladene Dateien auf Viren zu scannen. Hierfür stellt dieses Plugin eine Verbindung zu einem //ClamAV//-Daemon Service via TCP her.
5 5  
13 +== Funktionalität ==
14 +
15 +; Sofortiger Virenscan
16 +: Jede Datei wird direkt nach Ihrem Upload gescannt.
17 +
18 +Der verwendete //ClamAV//-Daemon Service kann weder durch dieses Plugin konfiguriert noch gestartet werden.
19 +
20 +== Installation ==
21 +
22 +Die Installation des Plugins ist über die dafür vorgesehene Verwaltungsoberfläche von Plugins durchzuführen. Hierbei muss lediglich die entsprechende //Jar//-Datei eingespielt werden.
23 +{{info}}
24 + Das //ClamAV//-Plugin scann Dateien in Backend und Fronted. Es steht somit immer allen Benutzern zur Verfügung. Daher ist es anzuraten, das Plugin als System-Plugin zu installieren. Dies umgeht auch mögliche Probleme mit doppelt belegten Ports und ermöglicht eine zenztrale konfiguration.
25 +{{/info}}
26 +
27 +== Konfiguration ==
28 +
29 +//ClamAV// ist dafür gedacht, auf Linux basierten Servern zu laufen. Deswegen kann eine anderweitige Unterstützung unserseits nicht garantiert werden.
30 +
31 +{{figure image="de_error.png" width="400"}}
32 + Falls keine Verbindung zu dem angegeben Host aufgebaut werden kann, wird diese Meldung ausgegeben.
33 +{{/figure}}
34 +
35 +Folgende Konfigurationsparameter gibt es:
36 +
37 +; host (Erforderlich)
38 +: Standardwert: //127.0.0.1//. Gibt die zu verwendende //IP//-Adresse des //ClamAV//-Daemon Service an. Der Standardwert ist //127.0.0.1// und verwendet damit einen lokalen //ClamAV//-Daemon Service.
39 +; port (Erforderlich)
40 +: Standardwert: //3310//. Gibt den zu verwendenden Port des //ClamAV//-Daemon Service an. Der Standardwert sollte nur geändert werden, falls dieser Port nicht zu Verfügung steht
41 +; file-source
42 +: Wenn hier der Wert //stream// eingegeben wird (Standardwert), werden die Daten der zu überprüfenden Datei direkt an //ClamAV// übertragen. Falls hier der Wert //path// eingegeben wird, wird direkt auf dem Pfad gearbeitet - wobei dafür der //ClamAV//-Daemon Service root Rechte besitzen muss.
43 +
44 +Nach dem Speichern wird automatisch ein Ping-Test durchgeführt. Falls dieser fehlschlägt wird eine entsprechende Meldung angezeigt. In diesem Fall werden alle Uploads im Backend oder im Formular als fehlerhaft markiert - das Plugin sollte erst einmal deaktiviert werden und eine funktionierende Verbindung aufgebaut werden.
45 +
46 +== Konfiguration //ClamAV// ==
47 +
48 +Im folgenden Abschnitt wird auf wichtige Konfigurationsschritte von //ClamAV//-Daemon eingegangen. Unser empfohlenes Szenario ist {{formcycle/}} und den //ClamAV//-Daemon Service auf dem selben Server zu installieren.
49 +
50 +Da das eigentliche Virusscanning losgelöst von {{formcycle/}} stattfindet, sollte auf eine aktulle Virensignatur-Datenbank geachtet werden via //freshclam//.
51 +
52 +Dieses Plugin überträgt die zu untersuchenden Elemente via TCP, was standardmäßig in //ClamAV//-Daemon deaktiviert ist. Zur Aktivierung muss die Konfigurationsdatei unter: // /etc/clamav/clamd.conf // bearbeitet werden.
53 +
54 +Folgende Parameter müssen der Datei hinzugefügt werden:
55 +
56 +; TCPAddr (Erforderlich)
57 +: Soll hinzugefügt und mit dem Wert //127.0.0.1// angegeben werden.
58 +; TCPSocket (Erforderlich)
59 +: Soll hinzugefügt und mit dem Wert //3310// angegeben werden oder abweichend, falls der Port anderweitig genutzt werden soll.
60 +; User
61 +: Ist standardmäßig //clamav// und muss zu //root// geändert werden, um dem //ClamAV//-Daemon Service root Rechte zu geben.
62 +
63 +{{figure image="de_tcp_test.png"}}
64 + Mithilfe von //netstat// kann der TCP Socket vom //ClamAV//-Daemon Service untersucht werden.
65 +{{/figure}}
66 +
67 +Damit dieses Plugin den //ClamAV//-Daemon Service ansprechen kann, muss der Service an der richtigen Stelle zuhören - in diesem Fall unter //127.0.0.1:3310//. Das kann durch folgenden Befehl im Terminal überprüft werden:
68 +
69 +{{code language="shell"}}
70 +sudo netstat -anp | grep -E "(clam)"
71 +{{/code}}
72 +
73 +== Beispielkonfiguration ==
74 +
75 +Ein beispielhafte Konfiguration mit den oben genannten Standardwerten:
76 +
77 +{{lightbox image="de_plugin.png" /}}
78 +
79 +== Verwendung ==
80 +
81 +Sobald eine Virensignatur erkannt wurde, ist folgende Meldung zu sehen:
82 +
83 +