| ... |
... |
@@ -8,31 +8,20 @@ |
| 8 |
8 |
|
| 9 |
9 |
{{content/}} |
| 10 |
10 |
|
| 11 |
|
-{{figure image="de_ms_defender_plugin.png" width="600"}} |
| 12 |
|
-Es muss der Pfad für die //Malware Protection Command Line Utility// von //Microsoft Defender// konfiguriert werden. |
| 13 |
|
-{{/figure}} |
| 14 |
|
- |
| 15 |
15 |
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//. |
| 16 |
16 |
|
| 17 |
17 |
== Funktionalität == |
|
14 |
+ |
| 18 |
18 |
; Sofortiger Virenscan |
| 19 |
19 |
: Jede Datei wird direkt nachdem sie hochgeladen wurde gescannt. |
| 20 |
20 |
|
| 21 |
|
-In {{formcycle/}} ist es möglich, 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 Protokol wird ein Eintrag hinzugefügt. |
|
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. |
| 22 |
22 |
|
| 23 |
|
-Im Formular wird je nach konfigurierten Uploadelement folgende Meldung gezeigt: |
| 24 |
|
-{{figure image="de_ms_defender_standard_upload.png" width="400"}} |
| 25 |
|
-Standard Upload-Element nach dem Absenden einer Virusdatei. |
| 26 |
|
-{{/figure}} |
|
20 |
+== Installation == |
| 27 |
27 |
|
| 28 |
|
-{{figure image="de_ms_defender_ajax_upload.png" width="400"}} |
| 29 |
|
-Upload-Element mit automatischen Upload nach dem Hochladen einer Virusdatei. |
| 30 |
|
-{{/figure}} |
|
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. |
| 31 |
31 |
|
| 32 |
|
-Im Backend von {{formcycle/}} kommt es zu dieser Meldung: |
| 33 |
|
-{{figure image="de_ms_defender_backend_upload.png" width="400"}} |
| 34 |
|
-Fehlermeldung im Backend von {{formcycle/}} nach dem Versuch eine Virusdatei hochzuladen. |
| 35 |
|
-{{/figure}} |
|
24 |
+{{info}}In den meisten Fällen dürfte der Microsoft Defender nicht unter //C:\Program Files\Windows Defender\MpCmdRun.exe// installiert sein. In diesen Fällen muss zwingend im Konfigurationsparameter //MpCmdRun-path// der Ort angegeben werdenm, unter dem der Microsoft Defender installiert ist. Üblicherweise 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.{{/info}} |
| 36 |
36 |
|
| 37 |
37 |
== Konfiguration == |
| 38 |
38 |
|
| ... |
... |
@@ -39,6 +39,54 @@ |
| 39 |
39 |
Folgende Konfigurationsparameter gibt es: |
| 40 |
40 |
|
| 41 |
41 |
; MpCmdRun-path (Erforderlich) |
| 42 |
|
-: 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 wie folgt aus: //C:\Program Files\Windows Defender\MpCmdRun.exe// oder //C:\ProgramData\Microsoft\Windows Defender\Platform\<letzte Version auswählen>\MpCmdRun.exe//. Falls kein Dateipfad angegeben wird, wird versucht ein Dateipfad zur MpCmdRun.exe automatisch zu erstellen, welcher dann in der Pluginbeschreibung angegeben wird. |
|
31 |
+: 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 diese Konfiguration nicht gemacht ist, wird versucht ein möglicher Dateipfad zu generieren, welcher dann in der Pluginbeschreibung angegeben wird. 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// |
| 43 |
43 |
; scan-timeout (Erforderlich) |
| 44 |
44 |
: 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. |
|
34 |
+ |
|
35 |
+== Beispielkonfiguration == |
|
36 |
+ |
|
37 |
+Beispiel für die Konfiguration des Plugins: |
|
38 |
+ |
|
39 |
+{{lightbox image="de_ms_defender_plugin.png"/}} |
|
40 |
+ |
|
41 |
+== Verwendung == |
|
42 |
+ |
|
43 |
+Sobald eine Virensignatur erkannt wurde, ist folgende Meldung zu sehen: |
|
44 |
+ |
|
45 |
+{{lightbox image="de_ms_defender_backend_upload.png"/}} |
|
46 |
+ |
|
47 |
+=== Testdatei === |
|
48 |
+ |
|
49 |
+Eine gängige Methode zur Überprüfung von Virenscannern ist die //eicar.com// Datei. |
|
50 |
+Beispielsweise kann im Backend von {{formcycle/}} diese Testdatei hochgeladen werden und nach erfolgreicher Konfiguration ist eine Fehlermeldung zu sehen. |
|
51 |
+ |
|
52 |
+; [[**Wikipedia**>>https://de.wikipedia.org/wiki/EICAR-Testdatei]] |
|
53 |
+; [[**Download**>>https://www.eicar.org/download-anti-malware-testfile/]] |
|
54 |
+ |
|
55 |
+=== Logging === |
|
56 |
+ |
|
57 |
+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// |
|
58 |
+ |
|
59 |
+{{formcycle/}} logs sind hierfür unter // /tomcat9/bin/logs zu finden.// |
|
60 |
+ |
|
61 |
+: Nach dem Hochladen der //eicar.com// Testdatei ist zum Beispiel folgender Eintrag in //formcycle-errors-log //zu sehen: |
|
62 |
+; {{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}} |
|
63 |
+; {{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}} |
|
64 |
+ |
|
65 |
+== Versionshistorie == |
|
66 |
+ |
|
67 |
+=== Version 1.0.3 |
|
68 |
+ |
|
69 |
+* 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. |
|
70 |
+ |
|
71 |
+=== Version 1.0.2 |
|
72 |
+ |
|
73 |
+* Automatische Ermittlung des Pfades zur ausführbaren Datei von MS Defender (MpCmdRun), wenn kein Pfad explizit angegeben wird. |
|
74 |
+ |
|
75 |
+=== Version 1.0.1 |
|
76 |
+ |
|
77 |
+* Benennung von Plugin-Eigenschaften |
|
78 |
+ |
|
79 |
+=== Version 1.0.0 |
|
80 |
+ |
|
81 |
+* Initialer Release |
