Configuring Operation Using Milter Protocol

Внимание!

To operate in this mode, Postfix system version 2.3.3 or later is required.

By default, Dr.Web for UNIX mail servers and Postfix are configured to interact in the after-queue mode. So, new settings that configure operation via Milter protocol, must be specified in the Postfix configuration files instead of the existing ones: change the content_filter parameter to the smtpd_milters parameter and remove all of the changes made to master.cf file. Necessary restrictions can be specified directly in the Postfix configuration files.

Address of the transport connection through which Postfix interacts with drweb-milter module can be specified as a TCP socket or as a UNIX socket.

Address is specified in the smtpd_milters parameter of the Postfix configuration file main.cf. If the connection is established via a TCP socket, the parameter value is set in the following format: inet:host@port (for example, smtpd_milters=inet:127.0.0.1:3001). If the connection is established through the UNIX socket, the address is set in the following format: unix:pathname, where pathname is an absolute path to the UNIX socket.

warning

If UNIX socket is used, Postfix must have privileges for writing to the socket file.

Address of the transport connection between Postfix system and drweb-milter module must be also specified in the Address parameter of the [Milter] section in Dr.Web MailD configuration file. Format and value of this parameter must be identical to the format and value of smtpd_milters parameter in main.cf file.

Apart from transport address, the following parameters must be specified in main.cf configuration file:

milter_content_timeout = 300s – this timeout of Postfix system is very important. It defines the maximum time period for Dr.Web MailD to check a message in the BeforeQueueFilters mode. It is recommended to set this parameter value greater than the value of the ProcessingTimeout parameter of the [Milter] section in the Dr.Web MailD configuration file;

milter_default_action = tempfail – this parameter defines action of Postfix if any errors occur during interaction with drweb-milter module;

milter_protocol = 6 – the required version of Milter protocol;

milter_mail_macros = _ – this parameter allows Dr.Web MailD to retrieve the IP address and host name of the sender;

milter_end_of_data_macros = i {auth_type} – this parameter allows to retrieve information on authorization and the message ID to add information on the message to drweb-milter log.

Note features of operation through Milter in the synchronous and asynchronous modes.