7.1. Dropping messages marked by NOD32 author. as deleted in MTA Postfix ..........42 Eset, s.r.o. reserves the right to change any of the 7.2. NOD32LMS/NOD32BMS and TLS support in MTA ....42 8. Let us know ............45 described application software without prior notice.
Page 4
Dear user, you have acquired NOD32 for Linux/BSD Mail Server - NOD32LMS/NOD32BMS - probably the best anti- virus system running under the Linux/BSD OS. As you will soon find out, the system using, the state-of-the-art NOD32 scanning engine, has unsurpassed scanning speed and detection rate, combined with a very small footprint that makes it the ideal choice for any Linux/BSD OS server.
Page 6
RedHat Ready and Novell (SuSE) Ready certificate. This means in particular that the package is installed as an add-on application, i.e. the primary installation directory is ’/opt/eset/nod32’ instead of the base Linux OS directory structure. However, there are more differences between the original and ’Ready’ variation of the product that are beyond the scope of this document.
Page 8
Once the product package has been successfully installed, it is time to become familiar with its content. The structure of the NOD32LMS/NOD32BMS is shown in the figure 3-1. The system is composed of the following components. Figure 3-1. Structure of NOD3LMS/NOD3BMS. CORE AGENTS NOD32D...
Page 9
/etc/nod32 Note that in case of RedHat Ready and Novell (SuSE) Ready variation of the NOD32 for Linux Mail Server the configuration and authorization directory is /etc/opt/eset/nod32 The directory consists of the following files. nod32.cfg This is the most important configuration file as it maintains the major part of the product functionality. For this reason the file is further referred to as ‚main configuration file‘...
Page 10
e-mail header | From: | To: -------------------------- e-mail body | text of e-mail body | content of lms_sig_header_infected.html | list of infiltrations found by the scanner | content of lms_sig_footer_infected.html The following footnote templates are used in e-mails found as clean: e-mail header | From: | To: -------------------------- e-mail body | text of e-mail body...
Chapter 4: Integration with E-mail Messaging System...
Page 12
This chapter describes integration of the NOD32LMS/NOD32BMS with the variety of known email messaging systems. Knowledge of e-mail messaging system basic principles (figure 4-1) is of paramount importance for understanding of the NOD32LMS/NOD32BMS operation. Figure -1. Scheme of UNIX OS e-mail messaging system. MTA - Mail Transport Agent A program (for instance sendmail, postfix, qmail, exim, INTERNET...
In case of RedHat Ready and/or Novell (SuSE) Ready variation of NOD32 for Linux Mail Server the installation path to the nod32mda is different so an appropriate statement is as follows: ln -s /opt/eset/nod32/bin/nod32mda /usr/bin/procmail With the above modifications, you ensure that all messages originally sent to MDA are primarily catched by nod32mda module.
A=nod32mda -t -Y -a $h -d $u Note that in case of RedHat Ready and/or Novell (SuSE) Ready variation of NOD32 for Linux Mail Server the nod32mda module path is different, so an appropriate Sendmail configuration file sentence will be as follows. Mlocal, P=/opt/eset/nod32/bin/nod32mda, F=lsDFMAw5:/|@qSPhnu9, S=EnvFromL/HdrFromL, R=EnvToL/HdrToL, T=DNS/RFC822/X-Unix, A=nod32mda -t -Y -a $h -d $u Warning: In case you are reading the ASCII form of this guide, do not drag and drop any of above sentences, since it may not work.
not a full-blown MDA, it is rather a wrapper; the ‘mda_path‘ parameter in this case has the following format: mda_path = “/usr/lib/sm.bin/sensible-mda“ To reread of newly created NOD32 configuration, enter the following command: /etc/init.d/nod32d reload To accomplish the whole procedure, one has to restart the MTA Sendmail. Note that NOD32LMS/NOD32BMS provides you with the option to define NOD32 scanning engine parameters individually for recipient users (resp.
#!/bin/sh exec env - PATH=“/var/qmail/bin:$PATH“ \ qmail-start ’|/opt/eset/nod32/bin/nod32mda ’./Maildir/ splogger qmail Note that there is space before the second character ‚ and no space after it. Keep also in mind that the argument - ./Maildir/ - is used this time only as an example and in your case you must prepend argument used in your original ‚/ var/qmail/rc‘...
RedHat Ready and/or Novell (SuSE) Ready variation of NOD32 for Linux Mail Server the ’/var/qmail/rc’ script shall be slightly different. #!/bin/sh exec env - PATH=“/var/qmail/bin:$PATH“ \ qmail-start ’|/opt/eset/nod32/bin/nod32mda ’./Maildir/’ \ -- --user “$USER“’ splogger qmail 4.1.2.4. Setting NOD32MDA in MTA Exim version 3 Let’s look inside the exim configuration file ’/etc/exim/exim.conf’ (resp. in older versions ’/etc/exim.conf’) to become familiarwith its content.
Page 18
TRANSPORTS CONFIGURATION entry in this case is as follows: # TRANSPORTS CONFIGURATION nod32_transport: driver = pipe command = /opt/eset/nod32/bin/nod32mda -oMr virus-scanned $local_part@$domain user = mail group = mail Be sure that the ’user’ (usually ’mail’) used in the above settings is listed in a ’trusted_users’ list for this parameter.
-- --user $local_part 4.1.2.5. Setting NOD32MDA in MTA Exim version 4 Let’s look inside the exim configuration file ’/etc/exim4/exim4.conf’ to become familiar with its content. It is typically compound from TRANSPORTS CONFIGURATION section and ROUTERS CONFIGURATION section. Usually there is a ROUTERS CONFIGURATION entry ’localuser’...
-- --user $local_part resp. in case of RedHat Ready and Novell (SuSE) Ready variation of NOD32 for Linux Mail Server used, the ’ c ommand’ parameter has to be defined as follows: command = /opt/eset/nod32/bin/nod32mda -oMr virus-scanned $local_part@$domain \ -- --user $local_part 4.2. Scanning of outbound e-mail messages Scanning of the outbound e-mail messages is performed during transfer of e-mail messages between the local MUA and the MTA.
Page 21
case you use ipchains (resp. iptables) tool for network filtering an appropriate rules will be as follows. Kernel 2.2.X: ipchains -I INPUT -p tcp -s 192.168.1.0/24 -d 0.0.0.0/0 25 \ -j REDIRECT 2525 Kernel2.4.X: iptables -I PREROUTING -t nat -p tcp -s 192.168.1.0/24 --dport 25 \ -j REDIRECT --to-ports 2525 Now all the communication arrives to the nod32smtp that can be checked in the module logging output. Note that the port 2525 with this setting provides an open relay as nod32smtp accepts all the packets that arrive on port 2525 (including packets from outside the local network).
4.3.2. Content filtering in MTA Sendmail The nod32smfi module is a third-party program with the purpose to serve as a content filter for MTA Sendmail. Using Sendmail’s Milter interface the nod32smfi accesses all e-mail messages being processed by MTA Sendmail. In order to enable filtering, enter the following lines into the [smfi] section of main NOD32 configuration file.
Page 24
TRANSPORTS CONFIGURATION entry in this case is as follows: # TRANSPORTS CONFIGURATION nod32_transport: driver = pipe command = /opt/eset/nod32/bin/nod32mda -oMr virus-scanned $local_part@$domain user = mail group = mail Make sure that the ‘user‘ (usually ‘mail‘) used in the above settings is listed in a ‘trusted_users‘ list for this parameter.
-- --user $local_part resp. in case of RedHat Ready and Novell (SuSE) Ready variation of this anti-virus product used, the ’ c ommand’ parameter has to be defined as follows: command = /opt/eset/nod32/bin/nod32mda -oMr virus-scanned $local_part@$domain \ -- --user $local_part 4.3.4. Content filtering in MTA Exim 4 Let’s look inside the exim configuration file ’/etc/exim4/exim4.conf’ to become familiar with its content. It is typically compound from TRANSPORTS CONFIGURATION section and ROUTERS CONFIGURATION section.
-- --user $local_part resp. in case of RedHat Ready and Novell (SuSE) Ready variation of this anti-virus product used, the ’ c ommand’ parameter has to be defined as follows: command = /opt/eset/nod32/bin/nod32mda -oMr virus-scanned $local_part@$domain \ -- --user $local_part 4.3.5. Content filtering in MTA Qmail Nod32pipe can serve as a content-filter for Qmail. However, you need to download and compile the qmail-qfilter program, version 2.0 or newer.
4.4.1.1. amavis Configuration of Amavis is performed during the process of Amavis installation. For installation, first unpack the source amavis-0.x.y.tgz and overwrite the file amavis/av/nod32cli with this contents: # ESET Software NOD32 Command Line Interface, Version 2.52 if ($nod32cli) { do_log(2,“Using $nod32cli“); chop($output = ‘$nod32cli --subdir $TEMPDIR/parts‘);...
In order to install the product with Amavisd-new, unpack and install the source amavisdnew- 2.x.y.tgz in your installation directory. Now to configure the product with newly installed Amavisd-new, delete the clause for ’ESET Software NOD32’ and replace the clause for ’ESET Software NOD32 - Client/Server Version’ in file ’amavisd.conf’ with the following one: ### http://www.eset.com/...
Page 29
### http://www.eset.com/ [’ESET Software NOD32 Command Line Interface v 2.52’, ’/opt/eset/nod32/bin/nod32cli’, ’--subdir {}’, [0], [1,2], qr/virus=“([^“]+)“/ ], Please, note the NOD32 scanning status values written within square brackets of the above setting. They are set to follow the same performance of Amavis cooperation as defined by default in the section discussing Amavis configuration.
5.1. User Specific Configuration User Specific Configuration mechanism is implemented in the product in order to provide user with enhanced configuration functionality. It allows to define NOD32 anti-virus scanner parameters selectively for client/server identification. Regarding the NOD32LMS/NOD32BMS the NOD32 anti-virus scanner parameters can be defined individually for first recipient and/or sender of the e-mail messages processed.
5.2. Handle Object Policy The Handle Object Policy (see figure 5-1) is a mechanism that provides handling of the scanned objects depending on their scanning status. The mechanism is based on so-called action configuration options (’action_on_processed’ , ’action_on_infected’ , ‚action_on_uncleanable‘ , ‚action_on_notscanned‘) combined with Anti-Virus enabling configuration option (‚av_enabled‘).
Page 34
server_addr = “localhost“ server_port = 2525 In the following we provide the [smtp] section with the reference to special configuration file ’nod32smtp_spec.cfg’ where the black-list or white-list will be defined. [smtp] agent_enabled = yes listen_addr = “localhost“ listen_port = 2526 server_addr = “localhost“ server_port = 2525 user_config = “nod32smtp_spec.cfg“...
accepted without scanning. Please, note the character ’|’ placed in front of the header name of the special section in case of sender address and not placed there in case of recipient address. To get description of the special header name syntax, please refer to the appropriate NOD32 agent module manual page (in this case it is nod32smtp(1)).
6.1.1. NOD32 mirror creation First, the mirror of all relevant so-called NOD32 precompiled modules have to be created from the origin ESET server(s). In the product developed for Linux OS and BSD OS the precompiled NOD32 modules introduced above are...
(nod32.005) and ThreatSense.NET support module (nod32.006) in the directory: /var/lib/nod32 resp. in RedHat Ready and Novell (SuSE) Ready variation of the product the target directory is as follows: /var/opt/eset/nod32/lib Note that the above directory is exactly the NOD32 base directory where main NOD32 daemon loads NOD32 modules from.
This chapter is devoted to describe tips and tricks concerned with configuration of NOD32LMS/NOD32BMS. This means it describes configuration of NOD32LMS/NOD32BMS in circumstances when for instance MTA is configured to use other software with similar functionality or with functionality that could normally lead to misconfiguration of NOD32LMS/NOD32BMS.
Page 43
data encryption in communication between local MTA and Internet and still use the ’ c ontent filtering’ methods. In MTA Sendmail content filtering there is no problem with SMTP TLS support at all as the Sendmail Milter does not relay on the SMTP communication and content filtering is done rather internally.
Page 46
Therefore, in case of bugs or inconsistencies found within this documentation, please report a problem to our support center http://www.eset.com/support We are looking forward to help you solve any problem concerning the product.
Need help?
Do you have a question about the NOD32 ANTIVIRUS - FOR LINUX-BSD MAIL SERVER and is the answer not in the manual?
Questions and answers