Параметры конфигурации

На главную  Назад 

Компонент использует параметры конфигурации, заданные в секции [CLAMD] объединенного конфигурационного файла продукта Dr.Web для UNIX.

В секции представлены следующие параметры:

LogLevel = {уровень подробности}

Уровень подробности ведения журнала компонента.

Если значение параметра не указано, используется значение параметра DefaultLogLevel из секции [Root].

Значение по умолчанию:

LogLevel = Notice

Log = {тип журнала}

Метод ведения журнала компонента.

Значение по умолчанию:

Log = Auto

ExePath = {путь к файлу}

Путь к исполняемому файлу компонента.

Значение по умолчанию:

ExePath = <opt_dir>/bin/drweb-clamd

Для Linux:

ExePath = /opt/drweb.com/bin/drweb-clamd

Для FreeBSD:

ExePath = /usr/local/libexec/drweb.com/bin/drweb-clamd

Для Solaris:

ExePath = /opt/drweb.com/bin/drweb-clamd

Start = {логический}

Компонент должен быть запущен демоном управления конфигурацией Dr.Web ConfigD.

Установка данного параметра в Yes предписывает демону управления конфигурацией немедленно попытаться запустить компонент, а установка его в значение No – немедленно завершить работу компонента.

Значение по умолчанию:

Start = No

Endpoint.<tag>.ClamdSocket = {IP-адрес | UNIX-сокет}

Определяет точку подключения с именем <tag> и сокет (адрес IPv4 или адрес сокета UNIX) для клиентов, желающих проверять файлы на наличие угроз.

Для одной точки <tag> может быть задан только один сокет.

Значение по умолчанию:

Endpoint.<tag>.ClamdSocket =

[Endpoint.<tag>.]DetectSuspicious = {логический}

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

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]DetectSuspicious = Yes

[Endpoint.<tag>.]DetectAdware = {логический}

Сообщать о файлах, содержащих рекламные программы.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]DetectAdware = Yes

[Endpoint.<tag>.]DetectDialers = {логический}

Сообщать о файлах, содержащих программы дозвона.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]DetectDialers = Yes

[Endpoint.<tag>.]DetectJokes = {логический}

Сообщать о файлах, содержащих программы-шутки.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]DetectJokes = No

[Endpoint.<tag>.]DetectRiskware = {логический}

Сообщать о файлах, содержащих потенциально опасные программы.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]DetectRiskware = No

[Endpoint.<tag>.]DetectHacktools = {логический}

Сообщать о файлах, содержащих программы взлома.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]DetectHacktools = No

[Endpoint.<tag>.]ReadTimeout = {интервал времени}

Определяет тайм-аут на ожидание данных от клиента.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]ReadTimeout = 5s

[Endpoint.<tag>.]StreamMaxLength = {размер}

Определяет максимальный размер данных, которые могут быть получены от клиента (при передаче данных для проверки в виде потока байтов).

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]StreamMaxLength = 25mb

[Endpoint.<tag>.]ScanTimeout = {интервал времени}

Определяет таймаут на проверку одного файла (или одной порции данных), поступившего от клиента.

Может быть указано значение в диапазоне от 1s до 1h.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]ScanTimeout = 3m

[Endpoint.<tag>.]HeuristicAnalysis = {On | Off}

Определяет, следует ли использовать эвристический анализ при проверке.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]HeuristicAnalysis = On

[Endpoint.<tag>.]PackerMaxLevel = {целое число}

Определяет максимальный уровень вложенности для проверки запакованных объектов.

Может быть указано значение в диапазоне от 0 до 60. Значение 0 указывает, что вложенные объекты не проверяются.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]PackerMaxLevel = 8

[Endpoint.<tag>.]ArchiveMaxLevel = {целое число}

Определяет максимальный уровень вложенности для проверки архивов.

Может быть указано значение в диапазоне от 0 до 60. Значение 0 указывает, что вложенные объекты не проверяются.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]ArchiveMaxLevel = 8

[Endpoint.<tag>.]MailMaxLevel = {целое число}

Определяет максимальный уровень вложенности для проверки почтовых файлов.

Может быть указано значение в диапазоне от 0 до 60. Значение 0 указывает, что вложенные объекты не проверяются.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]MailMaxLevel = 8

[Endpoint.<tag>.]ContainerMaxLevel = {целое число}

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

Может быть указано значение в диапазоне от 0 до 60. Значение 0 указывает, что вложенные объекты не проверяются.

Если указан префикс Endpoint.<tag>, то параметр определен для точки <tag>, иначе он определен для всех точек, у которых значение этого параметра не задано.

Значение по умолчанию:

[Endpoint.<tag>.]ContainerMaxLevel = 8

[Endpoint.<tag>.]MaxCompressionRatio = {целое число}

Устанавливает максимальную допустимую степень сжатия запакованных объектов (отношение сжатого объема к несжатому). Если степень сжатия объекта превысит указанную величину, он будет пропущен при проверке.

Величина степени сжатия должна быть не менее 2.

Значение по умолчанию:

[Endpoint.<tag>.]MaxCompressionRatio = 500

Особенность настроек компонента

Параметры, отмеченные необязательным префиксом Endpoint.<tag>, могут быть сгруппированы. Каждая такая группа определяет точку подключения (endpoint) с задаваемым уникальным идентификатором <tag>, используемую клиентами для подключения к компоненту. Все параметры проверки, включенные в одну группу, определяют параметры, которые будут применяться при проверке данных от клиентов, подключившихся к этой точке. Если параметр указан без префикса Endpoint.<tag>, то он определяет значение, применяемое для всех точек подключения. Если из точки подключения удалить параметр, то для точки подключения будет применяться не значение параметра по умолчанию, а значение, указанное в соответствующем одноименном «родительском» параметре (без префикса Endpoint.<tag>).

Параметр ClamdSocket должен обязательно задаваться с префиксом Endpoint.<tag>, поскольку он не только определяет прослушиваемый сокет, но и определяет группу (точку подключения), к которой этот сокет привязывается.

Пример:

Пусть требуется организовать две точки подключения для двух групп внешних приложений (серверов) servers1 и servers2. При этом серверы из группы servers1 могут подключаться через UNIX-сокет, а серверы из группы servers2 – через сетевое соединение. Кроме того, по умолчанию эвристический анализ должен быть выключен, но для серверов из группы servers2 его нужно использовать. Пример соответствующих настроек:

1)Для задания в файле конфигурации:

[ClamD]
HeuristicAnalysis = Off
 
[ClamD.Endpoint.servers1]
ClamdSocket = /tmp/srv1.socket
 
[ClamD.Endpoint.servers2]
ClamdSocket = 127.0.0.1:1234
HeuristicAnalysis = On

2)Для задания через утилиту командной строки Dr.Web Ctl:

# drweb-ctl cfset ClamD.HeuristicAnalysis Off
# drweb-ctl cfset ClamD.Endpoint -a servers1
# drweb-ctl cfset ClamD.Endpoint -a servers2
# drweb-ctl cfset ClamD.Endpoint.servers1.ClamdSocket /tmp/srv1.socket
# drweb-ctl cfset ClamD.Endpoint.servers2.ClamdSocket 127.0.0.1:1234
# drweb-ctl cfset ClamD.Endpoint.servers2.HeuristicAnalysis On

Оба способа задания настроек приведут к одинаковому результату, но в случае непосредственной правки файла конфигурации необходимо применить измененные настройки, отправив сигнал SIGHUP модулю drweb-configd (для этого вы можете выполнить команду drweb-ctl reload).