spmfilter-clamav(1)spmfilter-clamav(1)NAMEspmfilter-clamav - spmfilter ClamAV-plugin
SYNOPSIS
[clamav]
DESCRIPTION
clamav is a plugin for spmfilter that enables spmfilter to check mails
with the Clam AntiVirus open source toolkit for viruses. The major goal
of this plugin is to provide an easy way for virus-scanning emails. If
ClamAV detects malicious software like viruses the affected email is
discarded by the plugin. Optionally notifications can be enabled to
inform the recipients and sender (configurable) about the discarded
message. Activation of the module is done by adding clamav to the mod‐
ules-variable with the [global]-section in spmfilter.conf like follows:
[global]
...
modules = clamav
...
Please note that ClamAV needs to listen on a TCP/IP-socket instead of a
local socket to interact with the spmfilter clamav-plugin. This is
achieved by replacing the option "LocalSocket" with "TCPSocket" and
"TCPAddr" in clamd.conf
OPTIONS
Configuration of the spmfilter clamav-plugin is done by adding a new
section for clamav to spmfilter.conf
[clamav]
host = 127.0.0.1
port = 3310
max_scan_size = 2097152
notification = 0
notification_template = /path/to/clamav-template.txt
notification_sender = postmaster@example.com
notification_subject = Virus detected
add_header = true
header_name = X-Spmfilter-Virus-Scanned
scan_direction = 0
host IP-address of the ClamAV-daemon. This option is mandatory.
port Port on which the ClamAV-daemon listens. This parameter is
optional, port 3310 is used as default if the port is not
defined.
max_scan_size
Files larger than this limit won't be scanned, defined in bytes.
This parameter is optional, 5MB is used as default if
max_scan_size is not defined.
notification
Enables or disables notifications of recipient if virus
detected. Possible values: 0 (notification disabled), 1 (notify
recipient), 2 (notify sender and recipient). If the smtp-engine
of spmfilter is used, envelope-addresses are used for notifica‐
tion. Otherwise if the message was delivered to spmfilter by the
pipe-engine all address are extracted from the header. Default:
0 (notification disabled).
notification_template
Absolute path to the notification template. If you want to
inform your users within templates about which malicious soft‐
ware has been found by ClamAV, you can use the '%virus%' expan‐
sion which will be replaced by the full name of the virus
detected. Also there is a '%sender%' expansion which you can use
within your templates to inform the recipient about the origin
sender. This parameter is mandatory if notification != 0.
notification_sender
Define sender address for notifications. This parameter is
mandatory if notification != 0
notification_subject
Subject String for notification messages. This parameter is
optional, the string "Virus notification" is used as default if
unspecified.
add_header
Add header for scanned message. Possible values: true (add
header), false (don't add header). Default is "false".
header_name
Define X-header-name for scanned messages. This parameter is
optional, "X-Spmfilter-Virus-Scanned" is used as default if
unspecified.
scan_direction
Define direction to scan. Possible values: 0 (scan incoming and
outgoing mail), 1 (scan incoming mails only), 2 (scan outgoing
mails only). This parameter is optional, 0 is used as default if
unspecified (scan incoming and outgoing mails). Lookup-backend
required for option 1 or 2.
reject_virus
If true, infected messages will be rejected by spmfilter.
reject_msg
Define optional reject message.
SEE ALSOspmfilter.conf(5), spmfilter(3)AUTHOR(S)spmfilter-clamav was written by Axel Steiner <ast@treibsand.com>
31. March 2010 spmfilter-clamav(1)