| ... | 
        ... | 
                @@ -1,5 +1,117 @@ | 
      
              
                    | 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 | 
          + | 
        
              
                     | 
          24 | 
          +{{info}} | 
        
              
                     | 
          25 | 
          +  Das //ClamAV//-Plugin scannt 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. | 
        
              
                     | 
          26 | 
          +{{/info}} | 
        
              
                     | 
          27 | 
          + | 
        
              
                     | 
          28 | 
          +== Konfiguration Plugin == | 
        
              
                     | 
          29 | 
          + | 
        
              
                     | 
          30 | 
          +//ClamAV// ist dafür gedacht, auf Linux basierten Servern zu laufen. Deswegen kann eine anderweitige Unterstützung unserseits nicht garantiert werden. | 
        
              
                     | 
          31 | 
          + | 
        
              
                     | 
          32 | 
          +{{figure image="de_error.png" width="400"}} | 
        
              
                     | 
          33 | 
          +  Falls keine Verbindung zu dem angegeben Host aufgebaut werden kann, wird diese Meldung ausgegeben. | 
        
              
                     | 
          34 | 
          +{{/figure}} | 
        
              
                     | 
          35 | 
          + | 
        
              
                     | 
          36 | 
          +Folgende Konfigurationsparameter gibt es: | 
        
              
                     | 
          37 | 
          + | 
        
              
                     | 
          38 | 
          +; host (Erforderlich) | 
        
              
                     | 
          39 | 
          +: 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. | 
        
              
                     | 
          40 | 
          +; port (Erforderlich) | 
        
              
                     | 
          41 | 
          +: 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 | 
        
              
                     | 
          42 | 
          +; file-source | 
        
              
                     | 
          43 | 
          +: 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. | 
        
              
                     | 
          44 | 
          + | 
        
              
                     | 
          45 | 
          +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. | 
        
              
                     | 
          46 | 
          + | 
        
              
                     | 
          47 | 
          +== Konfiguration //ClamAV// == | 
        
              
                     | 
          48 | 
          + | 
        
              
                     | 
          49 | 
          +Im folgenden Abschnitt wird auf Installation und Konfiguration von //ClamAV//-Daemon eingegangen. Unser empfohlenes Szenario ist {{formcycle/}} und den //ClamAV//-Daemon Service auf dem selben Server zu installieren. | 
        
              
                     | 
          50 | 
          + | 
        
              
                     | 
          51 | 
          +=== Installation === | 
        
              
                     | 
          52 | 
          + | 
        
              
                     | 
          53 | 
          +Um //ClamAV//-Daemon auf einem Server zu installieren, sollten folgende Befehle auf dem Server eingegeben werden. | 
        
              
                     | 
          54 | 
          + | 
        
              
                     | 
          55 | 
          +: Update der package list | 
        
              
                     | 
          56 | 
          +; {{code language="shell"}} sudo apt-get update {{/code}} | 
        
              
                     | 
          57 | 
          + | 
        
              
                     | 
          58 | 
          +: Installiere //ClamAV// und //ClamAV//-Daemon | 
        
              
                     | 
          59 | 
          +; {{code language="shell"}} sudo apt-get install clamav clamav-daemon -y {{/code}} | 
        
              
                     | 
          60 | 
          + | 
        
              
                     | 
          61 | 
          +=== Update der Virensignatur-Datenbank === | 
        
              
                     | 
          62 | 
          + | 
        
              
                     | 
          63 | 
          +//freshclam// wird mit clamav automatisch installiert und wird zum update der Virensignatur Datenbank genutzt. | 
        
              
                     | 
          64 | 
          + | 
        
              
                     | 
          65 | 
          +: Beenden des automatischen //freshclam// Prozess | 
        
              
                     | 
          66 | 
          +; {{code language="shell"}} sudo systemctl stop clamav-freshclam {{/code}} | 
        
              
                     | 
          67 | 
          + | 
        
              
                     | 
          68 | 
          +: Manuelles update der Virensignatur Datenabank | 
        
              
                     | 
          69 | 
          +; {{code language="shell"}} sudo freshclam {{/code}} | 
        
              
                     | 
          70 | 
          + | 
        
              
                     | 
          71 | 
          + | 
        
              
                     | 
          72 | 
          + | 
        
              
                     | 
          73 | 
          + | 
        
              
                     | 
          74 | 
          +Da das eigentliche Virusscanning losgelöst von {{formcycle/}} stattfindet, sollte auf eine aktulle Virensignatur-Datenbank geachtet werden via //freshclam//. | 
        
              
                     | 
          75 | 
          + | 
        
              
                     | 
          76 | 
          +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. | 
        
              
                     | 
          77 | 
          + | 
        
              
                     | 
          78 | 
          +Folgende Parameter müssen der Datei hinzugefügt werden: | 
        
              
                     | 
          79 | 
          + | 
        
              
                     | 
          80 | 
          +; TCPAddr (Erforderlich) | 
        
              
                     | 
          81 | 
          +: Soll hinzugefügt und mit dem Wert //127.0.0.1// angegeben werden. | 
        
              
                     | 
          82 | 
          +; TCPSocket (Erforderlich) | 
        
              
                     | 
          83 | 
          +: Soll hinzugefügt und mit dem Wert //3310// angegeben werden oder abweichend, falls der Port anderweitig genutzt werden soll. | 
        
              
                     | 
          84 | 
          +; User | 
        
              
                     | 
          85 | 
          +: Ist standardmäßig //clamav// und muss zu //root// geändert werden, um dem //ClamAV//-Daemon Service root Rechte zu geben. | 
        
              
                     | 
          86 | 
          + | 
        
              
                     | 
          87 | 
          +{{figure image="de_tcp_test.png"}} | 
        
              
                     | 
          88 | 
          +  Mithilfe von //netstat// kann der TCP Socket vom //ClamAV//-Daemon Service untersucht werden. | 
        
              
                     | 
          89 | 
          +{{/figure}} | 
        
              
                     | 
          90 | 
          + | 
        
              
                     | 
          91 | 
          +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: | 
        
              
                     | 
          92 | 
          + | 
        
              
                     | 
          93 | 
          +{{code language="shell"}} | 
        
              
                     | 
          94 | 
          +sudo netstat -anp | grep -E "(clam)" | 
        
              
                     | 
          95 | 
          +{{/code}} | 
        
              
                     | 
          96 | 
          + | 
        
              
                     | 
          97 | 
          +== Beispielkonfiguration == | 
        
              
                     | 
          98 | 
          + | 
        
              
                     | 
          99 | 
          +Ein beispielhafte Konfiguration mit den oben genannten Standardwerten: | 
        
              
                     | 
          100 | 
          + | 
        
              
                     | 
          101 | 
          +{{lightbox image="de_plugin.png" /}} | 
        
              
                     | 
          102 | 
          + | 
        
              
                     | 
          103 | 
          +== Verwendung == | 
        
              
                     | 
          104 | 
          + | 
        
              
                     | 
          105 | 
          +Sobald eine Virensignatur erkannt wurde, ist folgende Meldung zu sehen: | 
        
              
                     | 
          106 | 
          + | 
        
              
                     | 
          107 | 
          +{{lightbox image="de_virus_found.png" /}} | 
        
              
                     | 
          108 | 
          + | 
        
              
                     | 
          109 | 
          +== Versionshistorie == | 
        
              
                     | 
          110 | 
          + | 
        
              
                     | 
          111 | 
          +**Version 1.0.1** | 
        
              
                     | 
          112 | 
          + | 
        
              
                     | 
          113 | 
          +* Optimierungen für Installation auf Server-Cluster | 
        
              
                     | 
          114 | 
          + | 
        
              
                     | 
          115 | 
          +**Version 1.0.0** | 
        
              
                     | 
          116 | 
          + | 
        
              
                     | 
          117 | 
          +* Initialer Release |