Плагин Kaspersky Anti-Spam для IVA Mail

Обзор плагина

Плагин фильтрации спама KAS высчитывает спам-рейтинг для каждого обработанного сообщения. Плагин KAS динамически получает новые шаблоны из Сети KasperskyLabs, что обеспечивает высокую точность в определении новых спам-сообщений.

Рейтинг определяется в пределах от 0 до 100; чем выше рейтинг сообщения, тем с большей вероятностью это сообщение является спамом. Сведения о рейтинге добавляются в заголовок сообщения, таким образом оно может быть обработано почтовыми правилами уровня Сервера, Домена или Пользователя.

По умолчанию добавляемый заголовок выглядит так:

X-KAS-Scan: score=92, method=content [main]
X-Junk-Score: [XXXX]
X-Alert: possible spam!

Кроме цифрового значения рейтинга (X-KAS-Scan: score=92), поле заголовка X-Junk-Score содержит «штрих-код» для упрощения автоматической обработки сообщений: чем больше символов «Х» в «штрих-коде», тем выше рейтинг.

Ниже приведены соответствия цифрового значения рейтинга и «штрих-кода» по умолчанию.

Цифровое значение рейтинга	Штрих-код
0	`[]`
1-39	`[X]`
40-80	`[XX]`
81-90	`[XXX]`
91-95	`[XXXX]`
96-99	`[XXXXX]`
100	`[XXXXXX]`

Установка плагина

Распакуйте архив с плагином на сервер IVA Mail в папку /var/ivamail:
```
tar -xf PluginKAS-Linux-x86_64-xx.tar.gz -C /var/ivamail
```
В папку плагина license (/var/ivamail/PluginKAS/license) скопируйте действующий файловый ключ:
```
cp KAS-xx.key /var/ivamail/PluginKAS/license
```
Для папки плагина и содержащихся в ней подпапок и файлов установите владельца и группу ivamail:ivamail и разрешения 0750:
```
chown -R ivamail:ivamail /var/ivamail/PluginKAS
chmod -R 0750 /var/ivamail/PluginKAS
```

Интеграция плагина в IVA Mail

В панели администратора в разделе Модули → Менеджер плагинов добавьте плагин, указав следующие настройки:
- Имя плагина — желаемое имя плагина (например: KAS). Это имя будет использоваться в почтовом правиле для сканирования сообщений.
- Тип плагина — Scanner.
- Автостарт — включить.
- Уровень журнала — требуемый уровень журнала (на первое время лучше установить Отладочный).
- Путь к плагину — путь к исполняемому файлу плагина (/var/ivamail/PluginKAS/PluginKAS).
- Нажать Добавить плагин.
  
  Добавление плагина KAS
- Запустите плагин, дождитесь запуска и убедитесь, что у плагина статус Выполняется.

Добавьте почтовое правило для сканирования сообщений:

В большинстве случаев подойдёт серверное правило (Настройки → Почтовые правила).

Для сканирования всех сообщений, проходящих через сервер, правило должно быть без условий.

Если нужно пропускать (не сканировать) сообщения, отправленные от пользователей сервера, можно добавить условие Аутентификация → любой равен с пустым значением.

В действия правила добавьте Сканировать Плагином, в параметре укажите имя плагина из шага 1.

Почтовое правило для сканирования сообщений плагином KAS

Добавьте почтовое правило для обработки сообщений с назначенным рейтингом спама:
- В большинстве случаев сообщения с высоким рейтингом спама перемещаются в папку пользователя для спама.
- В большинстве случаев подойдёт доменное правило (Объекты → Домены → Имя_домена → Почтовые правила).
- В условия правила добавьте Текст Заголовка → любой содержит → X-Junk-Score: [[]XXXXX (квадратная скобка заключена в [], чтобы сервер её воспринимал буквально, а не как часть шаблона).
- В действия правила добавьте Перенести в, в параметре укажите имя папки для спама.
  
  Почтовое правило для перемещения сообщений с высоким рейтингом спама
  
  Для получения подробной информации о Почтовых Правилах можно обратиться в документацию по серверу, в раздел Почтовые Правила.
Для проверки, что плагин распознаёт спам и письма со спамом перемещаются в папку для спама, можно отправить пользователю сервера письмо, в тело которого вставлен текст из файла test.eml из папки PluginKAS. Если в правило сканирования добавлено условие для пропуска сообщений от пользователей сервера, отправьте письмо с внешнего адреса.

Текст письма:
```
This is the GTUBE, the

Generic
Test for
Unsolicited
Bulk
Email

If your spam filter supports it, the GTUBE provides a test by which you
can verify that the filter is installed correctly and is detecting incoming
spam. You can send yourself a test mail containing the following string of
characters (in upper case and with no white spaces and line breaks):

XJS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST-EMAIL*C.34X
```