Integration with External Applications

The emulation of the clamd interface makes it possible to integrate Dr.Web ClamD with external applications capable to connect to the clamd anti-virus daemon (included in ClamAV).

The table below shows examples of applications that can use clamd for anti-virus scans:

Product

Integration

Email message services

Mail server
Postfix

Use of clamd

Scanning of email messages for viruses and malicious programs.

Integration requirements

Use of an intermediate component: clamsmtpd, clamav-milter or amavisd-new.

Links to documentation

Postfix documentation: http://www.postfix.org/documentation.html.

Description and source code files of amavisd-new: https://www.amavis.org/

Mail server
Exim

Use of clamd

Scanning of email messages for viruses and malicious programs.

Integration requirements

Adding the following setting in the Exim configuration file:

av_scanner = clamd:<path_to_clamd_UNIX_socket>

where <path_to_clamd_UNIX_socket> corresponds to the socket of a connection point (endpoint) configured in Dr.Web ClamD.

Links to documentation

Exim documentation: https://exim.org/docs.html

Mail server
CommuniGate Pro

Use of clamd

Scanning of email messages for viruses and malicious programs.

Integration requirements

Using cgpav as an intermediate component.

Links to documentation

CommuniGate Pro official site: https://www.communigate.ru/en/.

Description and source code files of cgpav: http://program.farit.ru/index.html

In the settings of the external software component that communicates directly with Dr.Web ClamD as with the clamd anti-virus daemon, specify an address for connecting to clamd as a path to a UNIX socket or as a TCP socket listened to by Dr.Web ClamD at one of its connection points (endpoint) set up in its configuration.

Example of how to connect CommuniGate Pro to Dr.Web ClamD:

1.Downloading and building of cgpav (version 1.5):

$ wget http://program.farit.ru/antivir/cgpav-1.5.tar.gz
$ tar -xzvf cgpav-1.5.tar.gz
$ cd cgpav-1.5/
$ ./configure
$ make && make install

At the configure stage, when choosing a response to a question Choose Anti-Virus daemon, select Clamav.

2.Configuring Dr.Web ClamD:

[ClamD]
Start = yes

[ClamD.Endpoint.mail]
ClamdSocket = /var/run/drweb.clamd

3.CommuniGate Pro configuration:

1)In the CommuniGate Pro settings file (/var/CommuniGate/Settings/cgpav.conf), specify the path to the Dr.Web ClamD socket:

clamd_socket = /var/run/drweb.clamd

2)In the CommuniGate Pro web interface:

•go to Settings → General → Helpers;

▫in Content Filtering, set a new filter:

▪toggle it to Enabled,

▪specify the filter name (for example, drweb),

▪specify cgpav in the Program Path parameter;

▫save changes;

•go to Settings → Mail → Rules;

▫specify the new rule name (for example, drweb_scan) and click Add Rule;

▫select the Highest rule preference and save changes;

▫click Edit on the right-hand side from the rule name;

▪select Message Size in the Data dropdown menu,

▪select greater than in the Operation field,

▪specify 1 in the Parameter field,

▪select ExternalFilter in the Action field,

▪select the name of the previously created filter (drweb in this case) in Parameter;

▫save changes.