---

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

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

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

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

X-Junk-Score:  92 [XXXX]
X-KAS-Score:  92 [XXXX]
X-Alert: possible spam!
X-Color: red

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

Каждый день в полночь Плагин генерирует отчет о количестве обработанных сообщений и их рейтинги. По умолчанию отчет отправляется на адрес postmaster из главного домена CommuniGate.

Обратите внимание: Плагин Kaspersky Anti-Spam доступен только для некоторых платформ, поддерживаемых программным обеспечением CommuniGate Pro. Перед оформлением заказа на лицензию KAS Плагина, убедитесь в доступности Плагина для платформы, на которой работает Ваш CommuniGate Pro сервер.

Обратите внимание: Для работы Плагина Kaspersky Anti-Spam требуется два ключа:

• Внутренний ключ Касперского
• Ключ CommuniGate

Обратите внимание: Плагин Kaspersky Anti-Spam требует версии CommuniGate Pro 6.2.4 или выше.

---

Скачать KAS Плагин

Плагин Kaspersky Anti-Spam доступен только для следующих платформ.

Операционная система	CPU	Загрузить
		по HTTP	по FTP
Linux (RedHat, SuSE, Debian, Astra Linux, Альт, РЕД ОС)	x86_64
FreeBSD 10.x	x86_64
Microsoft Windows 7/8/10	x86_64

Текущая версия Плагина 1.2

---

Установка на Unix системы

• Загрузите архив Плагина CGPKAS-platform-processor-version.tar.gz.
• Войдите под учетной записью супер-пользователя (root).
• Перенесите архив в директорию /var/CommuniGate/, которая является Базовой Директорией CommuniGate Pro.
• Распакуйте архив командой gtar (или командами gunzip и tar):
    gunzip CGPKAS-*.tar.gz
    tar -xf CGPKAS-*.tar
  . Будет создана директория CGPKAS внутри /var/CommuniGate/.
• Установите Внутренний Ключ Касперского:
    cp 12345ABC.key /var/CommuniGate/CGPKAS/licenses/
• Проведите Тестирование плагина.

---

Установка на системы MS Windows

• Загрузите архив Плагина CGPKAS-Windows-x86_64.zip.
• Перенесите архив в Базовую директорию CommuniGate Pro C:\CommuniGate Files\
• Распакуйте Плагин любой утилитой "unzip":
    pkunzip CGPKAS-*.zip
  Директория CGPKAS будет создана внутри Базовой директории.
• Установите Внутренний Ключ Касперского:
    copy 12345ABC.key C:\CommuniGate Files\CGPKAS\licenses\
• Проведите Тестирование Плагина.

---

Тестирование Плагина.

На Unix и MacOS X системах:

• Смените текущую директорию на Базовую директорию CommuniGate Pro:
    cd /var/CommuniGate
  
• Запустите приложение CGPKAS из его директории:
    CGPKAS/CGPKAS
  Оно сообщит текущую версию Плагина, версию движка, время последнего обновления базы спама, и некоторую другую информацию.
• Введите:
    1 FILE CGPKAS/test.msg
  Плагин должен ответить записью ADDHEADER с последующим выводом строки заголовка сообщения с некоторым выставленным рейтингом.
• Завершите работу приложения нажав Ctrl-D.

На системе MS Windows:

• Смените текущую директорию на Базовую директорию CommuniGate Pro:
    cd "C:\CommuniGate Files"
  
• Запустите приложение CGPKAS.exe из его директории:
    CGPKAS\CGPKAS.exe
  Оно сообщит текущую версию Плагина, версию движка, время последнего обновления базы спама, и некоторую другую информацию.

  Обратите внимание: Если Плагин не запускается, укажите полный путь, включая букву диска:
    "C:\CommuniGate Files\CGPKAS\CGPKAS.exe"
  

• Введите:
    1 FILE CGPKAS\test.msg
  Плагин должен ответить записью ADDHEADER с последующим выводом строки заголовка сообщения с некоторым выставленным рейтингом.
• Завершите работу приложения нажав Ctrl-Z.

Обратите внимание: Без Внутреннего Ключа Касперского Плагин выдаст ошибку и прекратит работу. Но всё равно тестирование без ключа имеет смысл для проверки зависимостей Плагина от системных библиотек.

---

Интеграция Плагина в CommuniGate Pro

Шаг #1: Создайте Помощника как описано ниже:

Откройте страницу Общие в разделе Установки в Административном веб-интерфейсе CommuniGate Pro и перейдите в раздел Помощники. Создайте Помощника для Плагина:

Обратите внимание: Для Linux, если Помощник не запускается, попробуйте снять SUID и SGID биты с сервера командой "chmod ug-s /opt/CommuniGate/CGServer" и перезапустите сервер.

Обратите внимание: Для Windows, если Помощник не запускается, попробуйте указать полный путь к Программе, например "C:\CommuniGate Files\CGPKAS\CGPKAS.exe"

Обратите внимание: Начиная с версии сервера CommuniGate Pro 6.4 в целях безопасности имена внешних программ должны быть указаны в файле Манифеста Дочерних Процессов. Пожалуйста, ознакомьтесь с разделом Манифест Дочерних Процессов в руководстве администратора CommuniGate Pro.

Шаг #2: Создание Правила Сканирования

Для вызова Помощника KAS Вам необходимо создать Общесерверное Правило с действием "Внешний Фильтр KAS". Правило сканирования будет применено Плагином к сообщению, и спам рейтинг будет добавлен к заголовку сообщения.
Обратите внимание: Это должно быть Общесерверное правило, а не Общедоменное Правило или Правило Аккаунта.

Рекомендованные правила сканирования сообщений:

Это правило пропускает сообщения от адреса MAILER-DAEMON (такие как сообщения о недоставке, и другие служебные сообщения), а также сообщения отправленные с Клиентских IP Адресов и аутентифицированных отправителей и включая только сообщения для локальных аккаунтов и списков рассылки.

Примечание: Не лицензированная установка Плагина ограничена обработкой 5 сообщений в час. Если трафик сообщений превышает этот лимит, Плагин будет пропускать эти сообщения без выставления рейтинга.

Шаг #3: Обработка Сообщений после выставления Рейтинга

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

Сценарий #1: подходит небольшим организациям, где Вы можете назначить ответственным одного человека (например, Postmaster) для ежедневного просмотра спам сообщений для проверки на ложные срабатывания, и если такое ложное срабатывание находится - перенаправлять эти сообщения соответствующим получателям.

Создайте Общесерверное Правило следующего содержания:

Данные	Операция	Параметр
---Поле Заголовка	равнобольше чем
---Поле Заголовка	равнобольше чем
Действие	Параметр
---Записать вПрекратить обработку	~postmaster@domain.com/spam_box
---ВыброситьПрекратить обработку
---Записать вПрекратить обработку

Это Правило переносит входящие сообщения с рейтингом 96 и выше в ящик «spam_box» аккаунта postmaster@domain.com. Действие «Выбросить» требуется для предотвращения отправки сообщения первоначальному получателю (ящик INBOX). Обратите внимание, в примере выше символ «*» в выражении [XXXXX* необходим, чтобы отфильтровать все сообщения с рейтингом ниже 5 Х. Без этого символа правило будет фильтровать только сообщения с рейтингом 5 Х.
Обратите внимание: Приоритет Общесерверных правил должен быть ниже, чем приоритет Правил Сканирования.

Сценарий #2: подходящий для больших организаций и Интернет Провайдеров. Сценарий позволяет пользователям сами решать, что делать со спамом.

Создайте Общедоменное правило или несколько Правил Аккаунта для Аккаунтов, которым необходима фильтрация, со следующим содержаием:

Данные	Операция	Параметр
---Поле Заголовка	равнобольше чем
---Поле Заголовка	равнобольше чем
Действие	Параметр
---Записать вПрекратить обработку	Junk
---ВыброситьПрекратить обработку
---Записать вПрекратить обработку

Это Правило переносит входящие сообщения с рейтингом 96 и выше в ящик «Junk» аккаунта первоначального получателя. Пользователь должен сам проверять свой ящик «Junk» и очищать его. Действие «Выбросить» требуется для предотвращения отправки сообщения первоначальному получателю (ящик INBOX). Обратите внимание, в примере выше символ «*» в выражении [XXXXX* необходим, чтобы отфильтровать все сообщения с рейтингом ниже 5 Х. Без этого символа правило будет фильтровать только сообщения с рейтингом 5 Х.

В качестве альтернативы, Вы можете использовать упрощенные Правила «Управление Спамом» на уровне домена или аккаунта:

Управление Спамом
Высокая вероятность: ВыброситьЗаписать в СпамПометить как Спам	Средняя вероятность: ВыброситьЗаписать в СпамПометить как Спам	Низкая вероятность: ВыброситьЗаписать в СпамПометить как Спам

Сценарий #3: подходящий для больших организаций и Интернет Провайдеров, пользователи которых имею доступ только к ящику INBOX (например пользователи POP3).

Создайте Общедоменное правило или несколько Правил Аккаунта для Аккаунтов, которым необходима фильтрация, со следующим содержаием:

Данные	Операция	Параметр
---Поле Заголовка	равнобольше чем
---Поле Заголовка	равнобольше чем
Действие	Параметр
---Пометить ТемуПрекратить обработку	[SPAM]
---Записать вПрекратить обработку

Это правило помечает спам сообщения префиксом [SPAM] в теме сообщения.

Сценарий #4: подходит для компаний с относительно небольшим входящим трафиком. Доступен для серверов CommuniGate Pro версии 5.1 и выше.

В CommuniGate Pro версии 5.1 и выше, Вы можете добавлять сообщения в очередь синхронно. Используйте Веб Интерфейс Администратора, чтобы сконфигурировать компонент Очереди. Откройте страницу Очередь в разделе Установки -> Почта: Снимите галочку с опции «Добавлять в очередь асинхронно»:

Установка в Очередь
Уровень Журнала:	КатастрофыСбоиОсновноеПроблемыПодробностиВсё	Процессоры:	1235102550другое
Ограничение Числа 'Received':	1510203050другое		Асинхронная Установка в Очередь

Более детальную информацию смотрите в руководстве администратора CommuniGate.

Создайте Общесерверное Правило следующего содержания:

Данные	Операция	Параметр
---Поле Заголовка	равнобольше чем
---Поле Заголовка	равнобольше чем
Действие	Параметр
---Отвергнуть сПрекратить обработку	Мы предполагаем, что данное сообщение является спамом.
---Записать вПрекратить обработку

При синхронной постановке в очередь, если сообщение отвергается Общесерверным правилом, оно отвергается еще на уровне SMTP с кодом ошибки 5xx, вместо полноценной операции приёма и отклонения с ответом.

При любом сценарии не рекомендуется отвергать сообщения без сохранения их, так как всегда существует возможность ложного срабатывания. Крайне не рекомендуется автоматически отвергать спам сообщения (кроме синхронного режима, используемого в сценарии 4), потому что обратный адрес зачастую сфабрикован и сообщение о отвергнутом сообщении может прийти человеку, который не отправлял данное сообщение. При отвержении писем в синхронном режиме, хост отправитель получит ошибку еще на уровне SMTP, и никакого ответного сообщения от Вашего сервера отправлено не будет.

Рекомендуемый порог (значение рейтинга, при котором сообщение расценивается как спам) - 96. Если слишком большое количество спам сообщений проходит фильтр, снизьте порог до 90. Если же наоборот, происходит слишком много ложных срабатываний, повысьте порог до 100.

---

Файл конфигурации Плагина

При старте Плагин зачитывает содержимое файла CGPKAS.cfg из текущей директории. Формат данных в этом файле описан здесь http://www.communigate.ru/CommuniGatePro/Data.html. Описание элементов данных находится в самом файле CGPKAS.cfg. Стандартный файл CGPKAS.cfg доступен здесь.

Стандартный файл CGPKAS.cfg имеет следующее содержимое:

Header="X-Junk-Score: ^1 [^2]";

Эта строка определяет заголовок с рейтингом, который будет добавлен в сообщение.
Комбинация ^1 заменяется числовым рейтингом сообщения.
Комбинация ^2 заменяется «штрих-кодом» с рейтингом сообщения.
Чтобы создать заголовок с несколькими строчками, используйте комбинацию \e для переноса строки. Убедитесь, что каждая строка соответствует требованиям RFC. Лучше всего начинать каждую строку с префикса «X-». Пример: Header="X-Score: ^1\eX-Bar-Score: ^2"

AlertLevel=96;

Эта строка определяет рейтинг, который инициирует добавление предупреждающего заголовка AlertHeader в сообщение, а в ежедневные отчеты об источниках и получателях спама, будет добавлена информация об этих сообщениях.

AlertHeader="X-Alert: possible spam!\eX-Color: red";

Эта строка определяет заголовок с рейтингом, который будет добавлен в сообщение, если его рейтинг равер или выше значения AlertLevel. Комбинация «X-Color: red» меняет цвет сообщения при просмотре через Пользовательский Веб Интерфейс CommuniGate Pro.
Обратите внимание: Для обработки спам сообщений, Вы можете использовать факт наличия заголовка AlertHeader вместо проверки рейтинга сообщения, но этот метод не слишком гибкий, в случае если пользователи хотят использовать различные пороговые рейтинги.

SubmittedDirectory = "Submitted";

Эта строка определяет директорию Submitted в CommuniGate Pro, которая требуется для приёма отчетов через модуль PIPE. Это может быть относительный или абсолютный путь, например "/var/CommuniGate/Submitted"

OnLicenseLimitReached=Pass;

Эта строка определяет поведения Плагина при превышении лимита сообщений, который определен лицензией. Когда он установлен в значение «Delay», Плагин будет задерживать модуль обработки Очереди CommuniGate Pro, а в значении «Pass», Плагин будет пропускать сообщения без обработки и выставления рейтинга. Такие необработанные сообщения не будут иметь заголовка X-KAS-Score. Кроме того, в записи лога CommuniGate Pro будут записи о превышении лимита лиценизии.

---

Обращение в Спам-лабораторию

Технические требования для приема сообщений о ложных срабатываниях в Лабораторию Касперского:

• Для анализа спам-писем «Лаборатории Касперского» необходим оригинал сообщения в rfc822 MIME формате с полными техническими заголовками. Прикрепите образец спама в формате MSG или EML.
• Для анализа подходят только те спам-письма, которые были получены в течение последних 48 часов. Ваш запрос поступит в очередь на обработку в автоматическом режиме, ответа спам-аналитиков с данного адреса не предусмотрено.

Сообщения должны отправляться по следующим адресам:

notspam@kaspersky.com - для ложно-положительных срабатываний
spam@kaspersky.com - для ложно-отрицательных срабатываний

Использования Microsoft Outlook для отправки отзыва:

1. Запустите Outlook.
2. Создайте новое сообщение нажатием на кнопку «Новое сообщение».
3. Перетащите сообщение, которое было неверно классифицировано в окно с новым письмом, чтобы добавить его как вложение.
4. Отправьте созданное сообщение с вложением на один из адресов для отзывов, перечисленных выше.

Использования Веб Почты CommuniGate для отправки отзыва

1. Откройте сообщение, которое было неверно классифицировано в отдельном окне.
2. Нажмите кнопку «Переслать» для создания сообщения с отзывом.
3. В поле «Кому» введите один из адресов для отзывов, перечисленных выше.
4. Нажмите на кнопку «Отправить».

---

Эксплуатационные документы

1. Ведомость эксплуатационных документов KAS (pdf-документ).
2. Руководство по установке KAS (pdf-документ).
3. Руководство администратора KAS (pdf-документ).
4. Поддержание Жизненного Цикла KAS (pdf-документ).
5. Системные требования KAS (pdf-документ).
6. Функциональные возможности KAS (pdf-документ).