| ... |
... |
@@ -8,21 +8,80 @@ |
| 8 |
8 |
|
| 9 |
9 |
{{content/}} |
| 10 |
10 |
|
| 11 |
|
-{{figure image="de_plugin.png" width="600"}} |
| 12 |
|
- Es muss ein TCP-Verbindung eingerichtet werden, um den ClamAV-Daemon Service zum scannen der hochgeladenen Dateien zu verwenden. |
| 13 |
|
-{{/figure}} |
|
11 |
+Mit dem kostenlosen Microsoft Defender-Plugin für {{formcycle/}} besteht die Möglichkeit, hochgeladene Dateien auf Viren zu scannen. Dafür benutzt das Plugin die von Microsoft Defender bereitgestellte //Malware Protection Command Line Utility//. |
| 14 |
14 |
|
| 15 |
|
-Durch dieses Plugin ist es möglich, hochgeladene Elemente im Backend sowie in ausgelieferten Formularen mit Hilfe von Microsoft Defender auf Viren untersuchen zu lassen. Hierfür wird dieses Plugin als aktiviertes System-Plugin benötigt und der FORMCYCLE-Server muss auf einem Windows-Betriebssystem laufen mit aktiviertem Microsoft Defender. |
|
13 |
+== Funktionalität == |
| 16 |
16 |
|
| 17 |
|
-Nach der Installation des Plugins ist die Konfiguration des Dateipfades zur MpCmdRun.exe von Microsoft Defender notwendig. |
|
15 |
+; Sofortiger Virenscan |
|
16 |
+: Jede Datei wird direkt nachdem sie hochgeladen wurde gescannt. |
| 18 |
18 |
|
| 19 |
|
-== Konfiguration == |
|
18 |
+In {{formcycle/}} ist es möglich, bspw. im Formular durch ein Upload-Element oder im Backend von {{formcycle/}}, Dateien hochzuladen. Durch dieses Plugin wird die //Malware Protection Command Line Utility// von Microsoft Defender angesprochen und ein Virenscan wird auf die hochgeladene Datei durchgeführt. Wenn es sich laut Microsoft Defender, um ein Virus handelt, wird eine Fehlermeldung angezeigt und im Vorgangsprotokol wird ein Eintrag hinzugefügt. |
| 20 |
20 |
|
| 21 |
|
-Microsoft Defender ist vor allem, auf Windows basierten Servern verfügbar. Deswegen kann eine anderweitige Unterstützung unserseits nicht garantiert werden. |
|
20 |
+== Installation == |
| 22 |
22 |
|
| 23 |
|
-Folgende Konfiguration-Parameter gibt es: |
|
22 |
+Damit das Plugin auch in allen Mandanten und Formularen verfügbar ist, ist eine Installation als System-Plugin empfehlenswert, wodurch eine bessere zentrale Adminstration und Konfiguration möglich ist. |
| 24 |
24 |
|
|
24 |
+{{info}} |
|
25 |
+In bestimmten Fällen befindet sich der Microsoft Defender nicht in dem vom Plugin standardmäßg verwendeten Installationspfad. In diesen Fällen muss zwingend im Konfigurationsparameter //MpCmdRun-path// des Plugins der Ort angegeben werden, an dem der Microsoft Defender installiert ist. In den meisten Fällen liegt er dann unter //C:\ProgramData\Microsoft\Windows Defender\Platform\<Versionsnummer>\MpCmdRun.exe//, wobei hier die höchste vorhandene Version im Plugin angegeben werden sollte. |
|
26 |
+{{/info}} |
|
27 |
+ |
|
28 |
+== Konfiguration == |
|
29 |
+ |
|
30 |
+Folgende Konfigurationsparameter gibt es: |
|
31 |
+ |
| 25 |
25 |
; MpCmdRun-path (Erforderlich) |
| 26 |
|
-: Dateipfad zur MpCmdRun.exe bzw. Malware Protection Command Line Utility von Microsoft Defender. Durch sie kann ein Scan im Dateisystem durch die Befehlszeile stattfinden. In der Regel sieht der Dateipfad zu dieser Datei so aus: C:\ProgramData\Microsoft\Windows Defender\Platform\<letzte Version auswählen>\MpCmdRun.exe |
|
33 |
+: Dateipfad zur MpCmdRun.exe bzw. //Malware Protection Command Line Utility// von //Microsoft Defender//. Durch sie kann ein Scan im Dateisystem durch die Befehlszeile stattfinden. Falls dieser Parameter nicht konfiguriert wurde, wird vom Plugin versucht, einen möglichen Dateipfad zu generieren. Dieser ist in der Pluginbeschreibung angegeben. Empfohlen ist jedoch den Pfad zur MpCmdRun.exe bzw. //Malware Protection Command Line Utility// selber anzugeben. Mögliche Dateipfade könnten sein: //C:\Program Files\Windows Defender\MpCmdRun.exe// oder //C:\ProgramData\Microsoft\Windows Defender\Platform\<letzte Version auswählen>\MpCmdRun.exe//. Falls ein Pfad eines Ordners angegeben wurde, wird versucht automatisch den Pfad zur letzten Version der //Malware Protection Command Line Utility// zu generieren. Der derzeitige genutzte Dateipfad zur //Malware Protection Command Line Utility// wird ebenfalls in der Pluginbeschreibung angegeben. |
| 27 |
27 |
; scan-timeout (Erforderlich) |
| 28 |
|
-: Hiermit kann die Zeit in Sekunden definierten werden bis der Scanprozess zum Abbruch führt. Der Standardwert ist 45 Sekunden. |
|
35 |
+: Hiermit kann die Zeit in Sekunden definierten werden, bevor der Scanprozess abgebrochen wird. Nach dem Timeout wird die Datei so behandelt wie eine Datei, bei der ein Virus gefunden wurde. Der Standardwert ist 45 Sekunden. |
|
36 |
+ |
|
37 |
+== Beispielkonfiguration == |
|
38 |
+ |
|
39 |
+Beispiel für die Konfiguration des Plugins: |
|
40 |
+ |
|
41 |
+{{lightbox image="de_ms_defender_plugin.png"/}} |
|
42 |
+ |
|
43 |
+== Verwendung == |
|
44 |
+ |
|
45 |
+Sobald eine Virensignatur erkannt wurde, ist folgende Meldung zu sehen: |
|
46 |
+ |
|
47 |
+{{lightbox image="de_ms_defender_backend_upload.png"/}} |
|
48 |
+ |
|
49 |
+=== Testdatei === |
|
50 |
+ |
|
51 |
+Eine gängige Methode zur Überprüfung von Virenscannern ist die //eicar.com// Datei. |
|
52 |
+Beispielsweise kann im Backend von {{formcycle/}} diese Testdatei hochgeladen werden und nach erfolgreicher Konfiguration ist eine Fehlermeldung zu sehen. |
|
53 |
+ |
|
54 |
+; [[**Wikipedia**>>https://de.wikipedia.org/wiki/EICAR-Testdatei]] |
|
55 |
+; [[**Download**>>https://www.eicar.org/download-anti-malware-testfile/]] |
|
56 |
+ |
|
57 |
+=== Logging === |
|
58 |
+ |
|
59 |
+Bei der Ausführung eines Virenscans durch die //Malware Protection Command Line Utility// von Microsoft Defender werden die Ergebnisse in eine MpCmdRun.log Datei geschrieben. Dadurch kann die genau Befehlszeilen Rückgabe des Scan nachvollzogen werden. In der Regel befindet sich diese Log-Datei im lokalen Temp-Verzeichnis. Zum Beispiel: //C:\Users\<UserName>\AppData\Local\Temp\MpCmdRun.log// |
|
60 |
+ |
|
61 |
+{{formcycle/}} logs sind hierfür unter // /tomcat9/bin/logs zu finden.// |
|
62 |
+ |
|
63 |
+: Nach dem Hochladen der //eicar.com// Testdatei ist zum Beispiel folgender Eintrag in //formcycle-errors-log //zu sehen: |
|
64 |
+; {{code language="shell"}} [WARN] [25-05-22 10:10:21,192] [ajp-nio-127.0.0.1-8009-exec-43] (MalwareScanner.java:211) - Scanner <fc.plugin.fc_plugin_malware_scanner_ms_defender.MsDefenderFileScanner@7b2a4953> detected malware signature for file </home/fc/tomcat9/tmp/xima-temp/formcycle7/xfc-malware-scan/stream-scan12705251110052849842/data2383296604287452271>: {stream=[Win.Test.EICAR_HDB-1]} {{/code}} |
|
65 |
+; {{code language="shell"}} [ERROR] [25-05-22 10:10:21,207] [ajp-nio-127.0.0.1-8009-exec-43] (VirusScannerService.java:71) - Detected a virus {{/code}} |
|
66 |
+ |
|
67 |
+== Versionshistorie == |
|
68 |
+ |
|
69 |
+=== Version 1.0.4 === |
|
70 |
+ |
|
71 |
+* Change: Automatische Ermittlung zur letzten Version von MS Defender (MpCmdRun). |
|
72 |
+ |
|
73 |
+=== Version 1.0.3 === |
|
74 |
+ |
|
75 |
+* Change: Das Plugin wird auch auf den Frontend-Server übertragen, wenn ein solcher verfügbar ist. Somit kann auch auf Frontend-Server nach Viren gesucht werden. |
|
76 |
+ |
|
77 |
+=== Version 1.0.2 === |
|
78 |
+ |
|
79 |
+* Automatische Ermittlung des Pfades zur ausführbaren Datei von MS Defender (MpCmdRun), wenn kein Pfad explizit angegeben wird. |
|
80 |
+ |
|
81 |
+=== Version 1.0.1 === |
|
82 |
+ |
|
83 |
+* Benennung von Plugin-Eigenschaften |
|
84 |
+ |
|
85 |
+=== Version 1.0.0 === |
|
86 |
+ |
|
87 |
+* Initialer Release |
