| ... | 
        ... | 
                @@ -1,5 +1,142 @@ | 
      
              
                    | 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 | 
          +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. | 
        
              
                     | 
          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 | 
          +{{info}} | 
        
              
                     | 
          46 | 
          +//ClamAV// ist dafür gedacht, auf Linux basierten Servern zu laufen. Deswegen kann eine anderweitige Unterstützung unserseits nicht garantiert werden. | 
        
              
                     | 
          47 | 
          +{{/info}} | 
        
              
                     | 
          48 | 
          + | 
        
              
                     | 
          49 | 
          +== Konfiguration //ClamAV// == | 
        
              
                     | 
          50 | 
          + | 
        
              
                     | 
          51 | 
          +Im folgenden Abschnitt wird auf Installation und Konfiguration von //ClamAV// eingegangen. Unser empfohlenes Szenario ist {{formcycle/}} und den //ClamAV//-Daemon Service auf dem selben Server zu installieren. | 
        
              
                     | 
          52 | 
          + | 
        
              
                     | 
          53 | 
          +=== Installation === | 
        
              
                     | 
          54 | 
          + | 
        
              
                     | 
          55 | 
          +Um //ClamAV// auf einem Server zu installieren, sollten folgende Befehle auf dem Server eingegeben werden. | 
        
              
                     | 
          56 | 
          + | 
        
              
                     | 
          57 | 
          +//ClamAV// ist das Programm, welches Dateien auf Viren scannen kann und wird für die Verwendung von //ClamAV//-Daemon benötigt. | 
        
              
                     | 
          58 | 
          + | 
        
              
                     | 
          59 | 
          +; Aktualisieren der package list: | 
        
              
                     | 
          60 | 
          +; {{code language="shell"}} sudo apt-get update {{/code}} | 
        
              
                     | 
          61 | 
          + | 
        
              
                     | 
          62 | 
          +; Installiere //ClamAV// und //ClamAV//-Daemon: | 
        
              
                     | 
          63 | 
          +; {{code language="shell"}} sudo apt-get install clamav clamav-daemon -y {{/code}} | 
        
              
                     | 
          64 | 
          + | 
        
              
                     | 
          65 | 
          +=== Aktualisieren der Virensignatur-Datenbank === | 
        
              
                     | 
          66 | 
          + | 
        
              
                     | 
          67 | 
          +//freshclam// wird mit //ClamAV// automatisch installiert und wird zum aktualisieren der Virensignatur Datenbank genutzt. | 
        
              
                     | 
          68 | 
          + | 
        
              
                     | 
          69 | 
          +; Beenden des automatischen //freshclam// Prozess: | 
        
              
                     | 
          70 | 
          +; {{code language="shell"}} sudo systemctl stop clamav-freshclam {{/code}} | 
        
              
                     | 
          71 | 
          + | 
        
              
                     | 
          72 | 
          +; Manuelles aktualisieren der Virensignatur Datenabank: | 
        
              
                     | 
          73 | 
          +; {{code language="shell"}} sudo freshclam {{/code}} | 
        
              
                     | 
          74 | 
          + | 
        
              
                     | 
          75 | 
          +=== Konfiguration //ClamAV//-Daemon === | 
        
              
                     | 
          76 | 
          + | 
        
              
                     | 
          77 | 
          +//ClamAV//-Daemon ist der auf dem Server im Hintergrund laufende Prozess, welcher zum Virusscan angesprochen wird. Das geschieht via TCP und muss entprechend konfiguriert werden. | 
        
              
                     | 
          78 | 
          + | 
        
              
                     | 
          79 | 
          +Dafür soll die Konfigurationsdatei unter: // /etc/clamav/clamd.conf // angepasst werden. | 
        
              
                     | 
          80 | 
          + | 
        
              
                     | 
          81 | 
          +; Öffnen der Konfigurationsdatei: | 
        
              
                     | 
          82 | 
          +; {{code language="shell"}} sudo nano /etc/clamav/clamd.conf {{/code}} | 
        
              
                     | 
          83 | 
          + | 
        
              
                     | 
          84 | 
          +Mit den Pfeiltasten kann an das Ende der Datei navigiert werden. | 
        
              
                     | 
          85 | 
          + | 
        
              
                     | 
          86 | 
          +; Hinzufügen von //TCPAddr 127.0.0.1 // | 
        
              
                     | 
          87 | 
          +; Hinzufügen von //TCPSocket 3310 // | 
        
              
                     | 
          88 | 
          + | 
        
              
                     | 
          89 | 
          +{{lightbox image="en_clamd.conf.png"/}} | 
        
              
                     | 
          90 | 
          + | 
        
              
                     | 
          91 | 
          +; //ClamAV//-Daemon root Rechte geben | 
        
              
                     | 
          92 | 
          +: dafür muss in dieser Datei der Eintrag //User clamav// in //User root// geändert werden. | 
        
              
                     | 
          93 | 
          + | 
        
              
                     | 
          94 | 
          +Nun kann mit //Strg + X// gespeichert und beendet werden. Mit //Y// und der Enter-Taste bestätigen. | 
        
              
                     | 
          95 | 
          + | 
        
              
                     | 
          96 | 
          +=== Starten der //ClamAV//-Daemon Service === | 
        
              
                     | 
          97 | 
          + | 
        
              
                     | 
          98 | 
          +Nun kann der Service gestartet werden. | 
        
              
                     | 
          99 | 
          + | 
        
              
                     | 
          100 | 
          +: Starten des //ClamAV//-Daemon Service: | 
        
              
                     | 
          101 | 
          +; {{code language="shell"}} sudo systemctl start clamav-daemon.service {{/code}} | 
        
              
                     | 
          102 | 
          + | 
        
              
                     | 
          103 | 
          +=== Prüfen der Verfügbarkeit des Service === | 
        
              
                     | 
          104 | 
          + | 
        
              
                     | 
          105 | 
          +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 im Terminal der Servers überprüft werden. | 
        
              
                     | 
          106 | 
          + | 
        
              
                     | 
          107 | 
          +; Mithilfe von //netstat// kann der TCP Socket vom //ClamAV//-Daemon Service untersucht werden. | 
        
              
                     | 
          108 | 
          +; {{code language="shell"}} sudo netstat -anp | grep -E "(clam)" {{/code}} | 
        
              
                     | 
          109 | 
          + | 
        
              
                     | 
          110 | 
          +{{lightbox image="de_tcp_test.png" /}} | 
        
              
                     | 
          111 | 
          + | 
        
              
                     | 
          112 | 
          +Falls keine Zeile beginnend mit //tcp// zu sehen ist oder eine abweichende //host:port// Kombination als //127.0.0.1:3310// zu erkennen ist, muss die Konfiguration erneut geprüft werden. | 
        
              
                     | 
          113 | 
          + | 
        
              
                     | 
          114 | 
          +== Beispielkonfiguration == | 
        
              
                     | 
          115 | 
          + | 
        
              
                     | 
          116 | 
          +Ein beispielhafte Konfiguration mit den oben genannten Standardwerten: | 
        
              
                     | 
          117 | 
          + | 
        
              
                     | 
          118 | 
          +{{lightbox image="de_plugin.png"/}} | 
        
              
                     | 
          119 | 
          + | 
        
              
                     | 
          120 | 
          +== Verwendung == | 
        
              
                     | 
          121 | 
          + | 
        
              
                     | 
          122 | 
          +Sobald eine Virensignatur erkannt wurde, ist folgende Meldung zu sehen: | 
        
              
                     | 
          123 | 
          + | 
        
              
                     | 
          124 | 
          +{{lightbox image="de_virus_found.png"/}} | 
        
              
                     | 
          125 | 
          + | 
        
              
                     | 
          126 | 
          +=== Testdatei === | 
        
              
                     | 
          127 | 
          + | 
        
              
                     | 
          128 | 
          +Eine gängige Methode zur Überprüfung von Virenscannern ist die //eicar.com// Datei.  | 
        
              
                     | 
          129 | 
          + | 
        
              
                     | 
          130 | 
          +; [[**Wikipedia**>>https://de.wikipedia.org/wiki/EICAR-Testdatei]] | 
        
              
                     | 
          131 | 
          +; [[**Download**>>https://www.eicar.org/download-anti-malware-testfile/]] | 
        
              
                     | 
          132 | 
          + | 
        
              
                     | 
          133 | 
          + | 
        
              
                     | 
          134 | 
          +== Versionshistorie == | 
        
              
                     | 
          135 | 
          + | 
        
              
                     | 
          136 | 
          +**Version 1.0.1** | 
        
              
                     | 
          137 | 
          + | 
        
              
                     | 
          138 | 
          +* Optimierungen für Installation auf Server-Cluster | 
        
              
                     | 
          139 | 
          + | 
        
              
                     | 
          140 | 
          +**Version 1.0.0** | 
        
              
                     | 
          141 | 
          + | 
        
              
                     | 
          142 | 
          +* Initialer Release |