CommuniGate Pro
 


 

Kaspersky AntiVirus Plugin for CommuniGate Pro



Note: The Kaspersky AntiVirus Plugin is available only for some platforms supported with the CommuniGate Pro server software. Before you order the KAV Plugin License, make sure that the available versions of the Plugin software run on your CommuniGate Pro Server platform.

Note:The plugin requires two license keys to run:

  • Internal Kaspersky license Key file
  • CommuniGate Key
The Internal Kaspersky Key is required by is required for the Kaspersky Engine to work. The key has limited validity period. The new keys are given by us for free of charge, please contat <sales@communigate.ru>
Without the CommuniGate Key the plugin will run in demo mode with limited scan rate.

Note: The Kaspersky AntiVirus Plugin requires CommuniGatePro version 6.0.11 or later.


Download the KAV Plugins

Kaspersky AntiVirus Plugins are available for certain platforms only.


Operating System CPU Download
via
http
via
ftp
Linux
(RedHat, SuSE, Debian)
x86_64
FreeBSD 10.x x86_64
Microsoft Windows
7/8/10
2008 R2/2012
x86_64

The current version of the Plugin is 1.8


Installing on a Unix System

  • Download the CGPKAV-platform-processor-version.tar.gz Plugin archive file.
  • Log in as a super-user (root).
  • Move the archive into /var/CommuniGate/ which is the CommuniGate Pro base directory.
  • Unpack the Plugin archive with the gtar command (or with the gunzip and tar commands):
      gunzip CGPKAV-*.tar.gz
      tar -xf CGPKAV-*.tar

    The CGPKAV directory will be created inside the /var/CommuniGate/.
  • Install the Kaspersky Internal license Key file:
      cp 1234ABC.key /var/CommuniGate/CGPKAV/licenses/
  • Proceed with Testing the antivirus Plugin.


Installing on a MS Windows System

  • Download the CGPKAV-Win32-Intel.zip or CGPKAV-Windows-x86_64.zip Plugin archive file.
  • Move the archive into the CommuniGate Pro base directory C:\CommuniGate Files\
  • Unpack the Plugin archive with any "unzip" tool:
      pkunzip CGPKAV-*.zip

    The CGPKAV directory will be created inside the base directory.
  • Install the Kaspersky Internal license Key file:
      copy 1234ABC.key C:\CommuniGate Files\CGPKAV\licenses\
  • Proceed with Testing the antivirus Plugin.


Updating the antivirus Plugin.

When updating the Kaspersky Plugin to a newer version, do the following steps:

  • If you made any changes to the default configuration - save the contents of the CGPKAV.cfg file.
  • Stop the current copy of the Plugin application via CommuniGate Pro WebAdmin interface.
  • Delete all files form CGPKAV directory.
  • Install the new version of the Plugin as described above in this document.
  • Revise the new CGPKAV.cfg file and re-apply the necessary changes.

Note:To maintain the maximum virus protection you have to update to a newer version of the Plugin as soon as it is become available. By running an old versions you put yourself at risk because old versions may be unable to catch new virus types.


Testing the antivirus Plugin.

On Unix and MacOS X System:

  • Change the current directory to the CommuniGate Pro base directory:
      cd /var/CommuniGate

  • Launch the CGPKAV application from its directory:
      CGPKAV/CGPKAV
    It will report the Plugin version number, the Engine version number, the number of viruses in the database, the date of the latest update of the virus database, the internal key expiration date, and some other info.
  • Type:
      1 FILE CGPKAV/test.msg

    the Plugin should report that it has found the EICAR test file.
  • Quit CGPKAV by pressing Ctrl-D.

On a Windows System:

  • Change the current directory to the CommuniGate Pro base directory:
      cd "C:\CommuniGate Files"

  • Launch the CGPKAV.exe application from its directory:
      CGPKAV\CGPKAV.exe

    It will report the Plugin version number, the Engine version number, the number of viruses in the database, the date of the latest update of the virus database, the internal key expiration date, and some other info.

    Note: If the Plugin does not start, specify its full name including the drive letter:
      "C:\CommuniGate Files\CGPKAV\CGPKAV.exe"

  • Type:
      1 FILE CGPKAV\test.msg

    the Plugin should report that it has found the EICAR test file.
  • Quit CGPKAV.exe by pressing Ctrl-Z.

Note: Without the Internal Kaspersky license Key the plugin will give out an error and exit. However it still makes sence testing the Plugin without the Internal Kaspersky license Key to check the executables for library dependencies.


Integrating the antivirus Plugin with CommuniGate Pro.

Please check the VirusScan section of the CommuniGate Pro manual.

Open the General page in the Settings section of the WebAdmin Interface and click the Helpers link. Create the Helper as follows:

Content Filtering
Log Level: Program Path:
Time-out: Auto-Restart:

Note: For Windows the Program Path must be full, i.e. "C:\CommuniGate Files\CGPKAV\CGPKAV.exe"

The recommended Scanning Rule is as follows:

Data Operation Parameter
Action Parameter

Note: It's not recommended to scan small messages (less than 2K) because they are unlikely to contain viruses.

Note: If you run the unlicensed version of the Plugin you're limited to one message per hour. Therefore you must not scan all messages because this will just block the mail flow. If you want to see how the Plugin catches viruses, then in the Scanning Rule you should specify more conditions in order to apply the ExternalFilter action only to messages from certain sender (from you) and with certain subject.


Configuring the Plugin.

On startup the KAV Plugin reads the contents of the CGPKAV.cfg file from the current directory. The format of the file data elements is described in http://www.communigate.ru/CommuniGatePro/Data.html. The description of the data elements you may find in the CGPKAV.cfg file. The default CGPKAV.cfg is available here.

It is safe to view and edit the CGPKAV.cfg file while the Plugin is running. After you have made changes to the CGPKAV.cfg, you need to restart the Plugin via CommuniGate Pro WebAdmin interface.


CommuniGate Pro Guide. Copyright © 2020, AO StalkerSoft