Предустановленные конфигурационные файлы
После первоначальной настройки в приложении создаются следующие конфигурационные файлы:
- /var/opt/kaspersky/kesl/common/agreements.ini
Конфигурационный файл agreements.ini содержит параметры, связанные с Лицензионным соглашением, Политикой конфиденциальности и Положением о Kaspersky Security Network.
- /var/opt/kaspersky/kesl/common/kesl.ini
Конфигурационный файл kesl.ini содержит параметры, приведенные в таблице ниже.
Если требуется, вы можете изменять значения параметров в этих файлах.
Изменять значения по умолчанию в этих файлах рекомендуется только под руководством специалистов Службы технической поддержки по полученным от них инструкциям.
Чтобы измененные параметры в конфигурационном файле вступили в силу, перезапустите приложение Kaspersky Endpoint Security.
Если параметр отсутствует в файле или указано некорректное значение параметра, то приложение будет использовать значение по умолчанию.
Параметры конфигурационного файла kesl.ini
Параметр | Описание | Значения |
|---|---|---|
Секция [General] содержит следующие параметры: | ||
| Языковой стандарт, используемый для локализации событий, передаваемых приложением Kaspersky Endpoint Security в Kaspersky Security Center. Для отображения графического интерфейса и командной строки приложения используется локализация, указанная в переменной окружения | Языковой стандарт в формате, определенном в RFC 3066. Если параметр Если приложению не удалось определить язык локализации операционной системы или эта локализация не поддерживается, для локализации событий используется английский язык (en_US.UTF-8 в формате стандарта RFC 3066). |
| Формат установленного пакета приложения. Не рекомендуется изменять значение этого параметра вручную. Значение заполняется автоматически во время первоначальной настройки приложения. |
|
| Использование технологии fanotify для перехвата файловых операций. Не рекомендуется изменять значение этого параметра вручную. Параметр настраивается во время первоначальной настройки приложения. |
|
| Использование Kaspersky Endpoint Security в режиме Легкого агента. Не рекомендуется изменять значение этого параметра вручную. Параметр настраивается во время первоначальной настройки приложения. |
|
| Использование Kaspersky Endpoint Security в режиме Агента Endpoint Detection and Response. |
|
| Использование приложения Kaspersky Endpoint Security в составе решения Kaspersky Security для контейнеров в качестве компонента Защита от файловых угроз. Не рекомендуется изменять значение этого параметра вручную. Параметр используется только в работе решения Kaspersky Security для контейнеров. |
|
| Включение создания файлов трассировки при запуске приложения. |
|
| Отображение в файлах трассировки информации, которая может содержать персональные данные (например, пароли). |
|
| Включение асинхронной трассировки, при которой запись информации в файлы трассировки происходит в асинхронном режиме. |
|
| Включение создания файла дампа при сбое в работе приложения. |
|
| Путь к директории, в которой хранятся файлы дампов. | Значение по умолчанию: /var/opt/kaspersky/kesl/common/dumps. Для доступа к директории хранения файлов дампов, заданной по умолчанию, требуются root-права. |
| Минимальное количество памяти на диске, которое останется после записи файла дампа, в мегабайтах. | Значение по умолчанию: 300. |
| Ограничение на использование памяти приложением в мегабайтах. | Значение по умолчанию: 8192. Рекомендуется указывать значение параметра |
| Уникальный идентификатор устройства пользователя. | Значение параметра заполняется автоматически во время установки приложения. |
| Путь к сокету для удаленного подключения, по которому подключаются, например, графический интерфейс и утилита kesl-control. | Значение по умолчанию: /var/run/bl4control. |
| Ограничение количества подписок на изменения в файлах и директориях (user watches), указанное в файле /proc/sys/fs/inotify/max_user_watches. Если значение параметра в операционной системе меньше значения параметра | Значение по умолчанию: 299987.
|
| Ограничение количества подписок на изменения в файлах и директориях на одного пользователя, указанное в файле /proc/sys/fs/inotify/max_user_instances. Если значение параметра в операционной системе меньше значения параметра | Значение по умолчанию: 2047.
|
| Количество переменных окружения, которые приложение будет захватывать из вызова команды. | Значение по умолчанию: 50. |
| Количество аргументов, которые приложение будет захватывать из вызова exec. | Значение по умолчанию: 20. |
| Использование публичного DNS. При сбоях доступа к серверам через системный DNS приложение будет использовать публичный DNS. Это нужно для обновления баз приложения и поддержки уровня безопасности устройства. Приложение будет использовать следующие публичные DNS в порядке их обхода:
|
Запросы приложения могут содержать адреса доменов и внешний IP-адрес пользователя, так как приложение устанавливает с DNS-сервером TCP/UDP-соединение. Эти данные нужны, например, для проверки сертификата веб-ресурса при обращении по HTTPS. Если приложение использует публичный DNS-сервер, правила обработки данных регламентируются Политикой конфиденциальности этого сервиса. |
| Максимальное количество нештатных остановок приложения при использовании обновляемого модуля ядра. При достижении указанного значения приложение переходит в "безопасный" режим, в котором обновляемый модуль ядра не запускается. | Значение по умолчанию: 3. |
| Включение "безопасного" режима работы приложения при использовании обновляемого модуля ядра. В этом режиме приложение не запускает обновляемый модуль ядра. "Безопасный" режим включается автоматически, если достигнуто максимальное количество нештатных остановок приложения, заданное параметром |
|
| Передача в данных телеметрии следующей информации о контейнере при интеграции с Kaspersky Managed Detection and Response:
Имя контейнера передается только при наличии лицензии на использование задачи Проверка контейнеров и при достаточном времени жизни контейнера. |
|
Секция [Network] содержит следующие параметры: | ||
| Метка в правилах утилиты iptables для перенаправления трафика в приложение для обработки компонентом Защита от веб-угроз. Вам может потребоваться изменить эту метку, если на одном устройстве с установленным приложением работает другое ПО, которое использует девятый бит маски TCP-пакета, и возникает конфликт. | Значение задается десятеричным или шестнадцатеричным числом с префиксом 0x. Значение по умолчанию: 0x100. Во избежание цикличной проверки трафика при работе приложения на узлах, используемых в составе распределенных систем, таких как Kubernetes, требуется изменить значения меток сетевых пакетов, используя более старшие биты. Например: 0х1000 или 0х10000 (значение метки ограничено 32-битным целым числом). |
| Метка в правилах утилиты iptables для перенаправления трафика в приложение для обработки компонентом Защита от сетевых угроз. Вам может потребоваться изменить эту метку, если на одном устройстве с установленным приложением работает другое ПО, которое использует девятый бит маски TCP-пакета, и возникает конфликт. | Значение задается десятеричным или шестнадцатеричным числом с префиксом 0x. Значение по умолчанию: 0x200. Во избежание цикличной проверки трафика при работе приложения на узлах, используемых в составе распределенных систем, таких как Kubernetes, требуется изменить значения меток сетевых пакетов, используя более старшие биты. Например: 0х2000 или 0х20000 (значение метки ограничено 32-битным целым числом). |
| Метка, которой маркируются пакеты, созданные или проверенные приложением, чтобы они снова не попали в приложение на проверку. | Значение задается десятеричным или шестнадцатеричным числом с префиксом 0x. Значение по умолчанию: 0x400. Во избежание цикличной проверки трафика при работе приложения на узлах, используемых в составе распределенных систем, таких как Kubernetes, требуется изменить значения меток сетевых пакетов, используя более старшие биты. Например: 0х4000 или 0х40000 (значение метки ограничено 32-битным целым числом). |
| Метка, которой маркируются пакеты, созданные или проверенные приложением, чтобы запись о них не попадала в журнал утилиты iptable. | Значение задается десятеричным или шестнадцатеричным числом с префиксом 0x. Значение по умолчанию: 0x800. Во избежание цикличной проверки трафика при работе приложения на узлах, используемых в составе распределенных систем, таких как Kubernetes, требуется изменить значения меток сетевых пакетов, используя более старшие биты. Например: 0х8000 или 0х80000 (значение метки ограничено 32-битным целым числом). |
| Номер таблицы маршрутизации. | Значение по умолчанию: 101. |
Секция [ScannerImpactStats] содержит следующие параметры: | ||
| Включение подсчета статистики проверки файлов и процессов приложением. |
|
| Интервал времени, в течение которого приложение считает статистику проверенных файлов и обнаруженных процессов перед сохранением в файл трассировки и в отчеты. | Значение по умолчанию: 10 минут. |
| Количество проверенных файлов и обнаруженных процессов, которые были посчитаны приложением за интервал времени, указанный параметром | Значение по умолчанию: 10. |
| Количество записей, которые будут выведены в отчеты о наиболее часто проверяемых файлах и процессах за сутки. | Значение по умолчанию: 20. |
Секция [Virtualization] содержит следующие параметры: | ||
| Роль защищенной виртуальной машины, на которой приложение Kaspersky Endpoint Security используется в режиме Легкого агента для защиты виртуальных сред: сервер или рабочая станция. Не рекомендуется изменять значение этого параметра вручную. Параметр настраивается во время первоначальной настройки приложения. |
|
| Включение режима защиты инфраструктуры VDI в случае использования приложения в режиме Легкого агента для защиты виртуальных сред. Не рекомендуется изменять значение этого параметра вручную. Параметр настраивается во время первоначальной настройки приложения. |
|
Секция [Watchdog] содержит следующие параметры: | ||
| Максимальное время ожидания завершения процесса kesl от момента отправки сигнала HEADSHOT Watchdog-сервером процессу kesl. | Значение по умолчанию: 2 минуты. |
| Максимальное время ожидания запуска приложения (в минутах), после которого Watchdog-сервер начинает процедуру перезапуска процесса kesl. | Значение по умолчанию: 3 минуты. |
| Максимальное время ожидания завершения управляемого процесса kesl от момента отправки сигнала SIGKILL Watchdog-сервером процессу kesl. Если по истечении этого времени процесс kesl не завершился, выполняется действие, заданное параметром --failed-kill. | Значение по умолчанию: 2 дня. |
| Периодичность, с которой приложение пытается отправить Watchdog-серверу сообщение PONG в ответ на принятое сообщение PING. | Значение по умолчанию: 2000 миллисекунд. |
| Максимальное количество неудачных последовательных попыток запуска приложения. | Значение по умолчанию: 5. |
| Максимальный интервал времени, в течение которого приложение должно отправить сообщение Watchdog-серверу. Если в течение этого интервала времени от приложения не будет сообщения, Watchdog-сервер начинает процедуру перезапуска процесса kesl. | Значение по умолчанию: 2 минуты. |
| Максимальное время ожидания соединения приложения с Watchdog-сервером от момента запуска процесса kesl. Если приложение не успевает создать соединение за этот интервал времени, Watchdog-сервер начинает процедуру перезапуска процесса kesl. | Значение по умолчанию: 3 минуты. |
| Максимальный интервал времени от момента соединения приложения с Watchdog-сервером до получения сервером сообщения REGISTER. | Значение по умолчанию: 500 миллисекунд. |
| Максимальное время ожидания завершения процесса kesl от момента отправки сигнала SHUTDOWN Watchdog-сервером процессу kesl. | Значение по умолчанию: 2 минуты. |
| Ограничение на использование резидентной памяти процесса kesl. Если резидентная память управляемого процесса превышает это ограничение, Watchdog-сервер начинает процедуру перезапуска процесса kesl. |
Значение по умолчанию: |
| Ограничение на использование виртуальной памяти процесса kesl. Если виртуальная память управляемого процесса превышает это ограничение, Watchdog-сервер начинает процедуру перезапуска процесса kesl. |
|
| Ограничение на размер swap-файла управляемого процесса kesl. Если swap-файл управляемого процесса превышает это ограничение, Watchdog-сервер начинает процедуру перезапуска процесса kesl. |
|
| Включение отправки статуса устройства от приложения Kaspersky Endpoint Security в Kaspersky Security Center при нестабильной работе приложения. |
|
| Путь к файлу, с помощью которого осуществляется мониторинг стабильности приложения. | Значение по умолчанию: /var/opt/kaspersky/kesl/private/kesl_health.log. |
| Интервал времени (в секундах), за который приложение должно посчитать количество нештатных остановок, прежде чем вывести уведомление о нестабильной работе. | Значение по умолчанию: 3600 секунд. |
| Максимальное количество нештатных остановок приложения, по достижении которого отображается уведомление о нестабильной работе приложения. | Значение по умолчанию: 10. Если указано значение 0, уведомление о нестабильной работе приложения не отображается. |
| Интервал времени (в секундах), по истечении которого статус о нестабильной работе приложения будет снят. | Значение по умолчанию: 86400 секунд. |
| Периодичность, с которой Watchdog-сервер вызывает системные функции open и execve и увеличивает счетчики успешного вызова этих функций. | Значение по умолчанию: 3 секунды. |
| Периодичность, с которой Watchdog-сервер проверяет счетчики успешного вызова функций open и execve. Если по истечении этого времени значение счетчиков не изменилось, Watchdog-сервер начинает процедуру перезапуска процесса kesl. | Значение по умолчанию: 32 секунды. |
| Максимальное время ожидания завершения создания файла дампа приложения, в течение которого Watchdog-сервер приостанавливает проверку активности приложения. Если по истечении этого времени создание файла дампа не завершилось, Watchdog-сервер начинает процедуру перезапуска процесса kesl. | Возможные значения: 1 – 30 минут. Значение по умолчанию: 2 минуты. |
| Максимальный интервал времени, в течение которого Watchdog-сервер приостанавливает отправку других сигналов процессу kesl после отправки сигнала SIGTRAP, который отправляется в ходе процедуры нештатной остановки процесса. | Значение по умолчанию: 2 минуты. Рекомендуется указывать значение параметра Вы можете указать значение параметра в следующих единицах измерения:
Если единица измерения не указана, приложение по умолчанию будет использовать значение в миллисекундах. |
Секция [Environment] по умолчанию отсутствует в конфигурационном файле. | ||
| Включение поддержки среды containerd при работе компонента Мониторинг контейнеров (Проверка контейнеров, Мониторинг контейнеров). Этот параметр по умолчанию отсутствует в конфигурационном файле. Если вы хотите использовать среду containerd при работе компонента Мониторинг контейнеров, вам нужно вручную добавить в конфигурационный файл секцию |
|
| Ограничение памяти, потребляемой компонентом Анализ поведения на обработку очереди событий. Включение ограничение памяти негативно сказывается на обнаружении угроз и в том числе на качестве телеметрии, передаваемой при интеграции с решениями Detection and Response. Рекомендуется включать ограничение только на высоконагруженных системах под руководством специалистов Службы технической поддержки по полученным от них инструкциям при отсутствии других вариантов решения проблемы высокого потребления памяти. | 1 – включить ограничение памяти, потребляемой компонентом Анализ поведения на обработку очереди событий. 0 (значение по умолчанию) – не включать ограничение памяти. После изменения значения этого параметра требуется перезапустить приложение. |
