****************************************************************
*                                                              *
* Programm : JanaMailProtect 2.5.2                             *
* Descr.   : Jana-Server Email Virenscanner Erweiterung        *
*                                                              *
* Author   : Andreas Hausladen (Andreas.Hausladen@gmx.de)      *
* Copyright: (C) 2002-2004 Andreas Hausladen                   *
*                                                              *
****************************************************************

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!! Für eventuelle Schäden wird keine Haftung übernommen !!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

INHALT
======
1. Installation
1.1 Vorbereitung (für CheckExec 1.x Benutzer)
1.2 Durchführung der Installation
1.3 Abschließen der Konfiguration
2. Neuerungen
2.3 Neuerungen der Version 2.5
2.4 Neuerungen der Version 2.5.1
3. Kompatiblität
4. Virenscanner Kommandozeilen:





1. Installation
===============

1.1 Vorbereitung (für CheckExec 1.x Benutzer)
---------------------------------------------

Die Version ab 2.0 sind inkompatibel zu den 1.x Versionen. Sichern Sie
aus diesem Grund ihre vorherigen CheckExec-Einstellungen für eine spätere
Wiederherstellung. Löschen Sie nun den CheckExec Ordner und installieren 
Sie JanaMailProtect 2.5.


1.2 Durchführung der Installation
---------------------------------

Wählen Sie im Installationprogramm den Zielordner aus und klicken Sie auf
<Installieren>. Nun werden die Dateien entpackt. Nach der Installation der
Dateien startet automatisch das Konfigurationprogramm und setzt alle Ein-
stellungen auf ihre Vorgabewerte. Konfigurieren Sie nun JanaMailProtect 2 nach
Ihren Wünschen.


1.3 Abschließen der Konfiguration
---------------------------------
Nachdem Sie JanaMailProtect 2 entsprechend eingestellt haben, wechseln Sie zur
Jana Server Administration in den Bereich Email/Allgemein. Dort tragen Sie
die neue Kommandozeile ein (passen Sie ggf. den Pfad an):

  "C:\Jana2\JanaMailProtect\MPFastStart.exe" "$FILE$"


Aktivieren Sie nun die Optionen "E-Mails auf Viren scannen" und 
"Lokale und ausgehende E-Mails auf Viren scannen". klicken Sie
danach auf <Übernehmen> und schließen Sie die Administration.



2. Neuerungen
=============

Die Bezeichnung IFRAME wurde durch Aktive Inhalte ersetzt.

"ActiveX Elemente auskommentieren"
----------------------------------
Hierbei handelt es sich um eine, nur für die HTML-Passage einer
Mail eingesetze, Funktion die alle <object>-Tags in <block_object;>
umschreibt und somit die Einbindung von ActiveX-Elementen verhindert.


"Scripts entfernen"
-------------------
Diese Funktion entfernt alle Skripte aus den HTML-Passagen der Mail, wo
sie nichts verloren haben.


"Auch Html Anhänge überprüfen"
------------------------------
Ist diese Funktion aktiviert, so werden alle Anhänge, die eine Html-Datei
enthalten auf <object> und <script> Tags hin untersucht. Alle <object>-Tags
werden bei aktivierter Funktion "ActiveX Elemente auskommentieren" in
<block_object> umgeschrieben. Da in einer Html-Datei auch Skripte erlaubt
sind, kann bei eingeschalter Funktion "Scripts entfernen" nicht alle gelöscht
werden. Somit entfernt diese Funktion bei Html-Datei nur gefährliche Scripte,
die versuchen den WSH (Windows Scripting Host) zu nutzen.


"eml Anhänge komplett überprüfen"
---------------------------------
Diese Funktion ermöglicht es JanaMailProtect und den VirenScannern auch Anhängen die
eml (Email-Datei) Dateien enthalten zu entschlüsseln und zu verarbeiten. So
entdecken JanaMailProtect und die VirenScanner ohne diese Funktion keine Viren, die
als Anlage in einer Eml-Datei enthalten sind. Des weiteren werden als
application/ms-tnef kodierte Anhänge, die von Microsoft(r) Outlook erzeugt werden,
extrahiert so dass die Virenscanner diese ebenfalls überprüfen können.


"Red Alert"
-----------
Ein Red Alert wird ausgelöst, wenn innerhalb einer bestimmten Zeit eine gewisse
Anzahl von Viren verseuchten Mails eintreffen. Tritt ein solcher Red Alert ein,
wird das unter Ausführen eingestellte Programm gestartet. So kann z.B. unter
Windows 2000/XP der net-Befehl genutzt werden um eine entsprechende Attacke an
den Administrator, der an einem anderen Computer sitzt gesendet werden.

  net send ADMINPC "JanaMailProtect: Eine Virenattacke auf den Jana Server findet gerade statt." $hide$

(das $hide$ verhindert, dass eine Console, die von net.exe erzeugt wird, für kurze
Zeit sichtbar wird.)


"Virus Exit Code"
-----------------
Dies ist keine eigene Funktion, sondern sie gehört zu den Virenscannern. Hier kann
ein Bereich von Rückgabewerten der Virenscanner eingestellt werden, die andeuten,
dass ein Virus gefunden wurde. Der Vorgabewert ist "1-99".
"1-99,101,102,200-255" ist eine gütige Eingabe.


"Intelli VirusScan"
-------------------
Diese Funktion wurde dahingehend erweitert, dass sie nun ab 10 Anhängen überprüft,
ob ein oder mehrere gleiche Anhänge (vom Inhalt/Daten aus, nicht vom Dateinamen)
in der Mail vorhanden sind. Ist dem der Fall, so werden alle doppelten entfernt und
nur die ersten an die Virenscanner weitergeleitet.



2.2 Neuerungen der Version 2.2
==============================

"Logdatei - Einzeilig"
--------------------
Wenn diese Funktion aktiviert ist, werden die Logdaten in eine Zeile geschrieben,
wobei jeder Teil durch ein Tabulatorzeichen getrennt ist.


"Logdatei - Backupdatei"
------------------------
Mit dieser Funktion wird JanaMailProtect angewiesen ein Backup der Logdatei anzufertigen,
wenn die maximale Größe der Logdatei erreicht ist.


"Gescannt Text"
---------------
Diese Funktion wurde erweitert. Im Konfigurationsmenü können die neuen Einstellungen
über den Schalter "Erweitert..." erreicht werden. Der Gescannt Text kann nun an die
Text-Passagen der Mail angehängt oder/und als X-Header (X-VirusScan) in den
Mail-Header geschrieben werden. Zudem kann eingestellt werden, dass der Text nur bei
erfolgreich ausgeführtem Virenscan durch einen VirenScanner eingetragen werden soll.
Der Eintrag im Mail-Text kann nun für Plain-Text und HTML-Text individuell angepasst
werden. Hierbei gibt es das Makro $ScannedText$, dass durch die "Gescannt Text"-Zeile
ersetzt wird. Die "Gescannt Text" Zeile besitzt mit dieser JanaMailProtect Version auch über
Makros.
    $FILE(Dateiname)$    : Textdatei laden
    $n$                  : Zeile "n" der mit $FILE() geladenen Datei einsetzen
    $DATE$               : aktuelles Datum (yyyy-mm-dd)
    $TIME$               : aktuelle Uhrzeit (hh:mm)
    $FILEDATE(Dateiname)$: Datum der Datei
    $FILETIME(Dateiname)$: Uhrzeit der Datei
    $FILEDATETIME(Dateiname)$: Datum und Uhrzeit der Datei


"Nur ausführbare Anhänge scannen - Anpassen"
--------------------------------------------
Über den Schalter "Anpassen..." im Virenscanner Register können die Dateierweiterungen,
die als ausführbar gelten einstellt werden.



2.3 Neuerungen der Version 2.5
==============================

Namensänderung
--------------
Der Name CheckExec wird mit dieser Version aufgeben und das Programm in
JanaMailProtect umbenannt.


"SpamFilter"
------------
JanaMailProtect 2.5 stellt eine Schnittstelle für SpamFilter zur Verfügung. Dabei
ist es möglich bis zu zwei Spam Filter zu installieren, die unterschiedliche 
Exit-Codes haben können. Die Filter werden nur für die Email Dateien (in_xxxxx.inp)
aufgerufen. Signalisiert einer der Spam Filter eine Spam Mail, so wird das 
"To"-Mailheader Feld auf eine vorgegebene Adresse abgeändert womit die Spam-Mail
den Benutzer nicht erreicht, aber in einem Spam-Sammelkonto auftaucht.


"Nur bestimmte Anhänge scannen - Anpassen"
--------------------------------------------
Beim Virenscanner kann nun auch eingestellt werden, dass bestimmte Anhänge nicht
überprüft werden sollen.


"Log-Datei - Ein/Ausgehend"
---------------------------
Wenn diese Funktion aktiviert ist, werden die Dateien InMails.log und OutMails.log im
Log-Ordner geführt. Diese enthalten für jede ein- und ausgehende Mail einen Eintrag, 
der wie folgt aufgebaut ist:
[Datum Uhrzeit] TAB [Absender] TAB [Betreff] TAB [Maildateigröße in Byte] TAB 
  [Anzahl der Anhänge] TAB [Empfängerliste] TAB
Enhält die Mail einen Virus, wird noch "[VIRUS]" angefügt.


"Virenscanner - Bei Virus benachrichtigen"
------------------------------------------
Diese Funktion erlaubt es bei einem empfangenen Virus dem Empfänger eine
Informations-Mail zuzusenden. Hierfür wird der Text aus der Datei
JanaMailProtect\MPVirusMail.txt benutzt. Dieser kann nach belieben angepasst
werden.


"BlockedScripts.dat"
--------------------
In dieser Datei können je Zeile ein Auszug aus einem gefährlichen Java/VB-Script
eingetragen werden. Script die einen dieser Befehle enthalten, werden als Virus
identifiziert.


"MPVirusMail.txt"
-----------------
In dieser Datei steht der Text, der dem Benutzer anstatt einer Viren-verseuchten Mail
geschickt wird.


"MPVirusAdminMail.txt"
----------------------
In dieser Datei steht der Text, der dem Administrator geschickt wird, wenn ein Virus
gefunden wurde.



2.4 Neuerungen der Version 2.5.1
===============================
Unterstützung für den neuen Jana Server 2.4.2



3. Kompatiblität
================

JanaMailProtect 2 ist unter WinXP und WinME getestet mit
- Jana Server ab 2.2.4
- f-prot (f-prot.exe und FProtExec.exe möglich)
- H+DEBV AntiVir Personal Edition (mit Hilfe von AVPersExec.exe)
- H+DEBV AntiVir
- "Eicar-Test-Signatur"

Der Virenscanner F-Prot benötigt nun keine FProtExec.exe mehr.



4. Virenscanner Kommandozeilen:
===============================

f-prot: C:\Programme\fprot\f-prot.exe /dumb /archive /collect /packed /nomem /noboot /list /REPORT=C:\Report.txt /APPEND $NAME-SP$ $CHDIR$

FProtExec: C:\Programme\fprot\FProtExec.exe /REPORT=C:\rep.txt /APPEND "$FILE$"

AntiVir: C:\Programme\AntiVir\ave32.exe -z -nomem -noboot -nombr -ro -rfC:\Report.txt "$FILE$"  (nur Vollversion)

AVPersExec: C:\Programme\AntiVir\AVPersExec.exe "$FILE$"