Установка агентов
04 сентября 2026
ID 300161
Для обеспечения безопасности контейнеризированных объектов вам необходимо создать и установить группы агентов Kaspersky Container Security.
Чтобы создать группу агентов:
- В главном меню перейдите в раздел Компоненты → Агенты.
- Нажмите на кнопку Создать группу агентов, расположенную над таблицей со списком групп агентов.
- На вкладке Общая информация выполните следующие действия:
- Заполните поля формы:
- Введите название группы. В качестве названия группы для удобства управления агентами рекомендуется указывать имя кластера, на узлах которого будут установлены агенты.
- Если требуется, введите описание группы агентов.
- В раскрывающемся списке выберите одну или несколько областей применения, которые доступны роли пользователя. Если значение не указано, решение применяет установленную по умолчанию область применения.
Если потребуется добавить какую-либо область применения после создания группы агентов, необходимо добавить соответствующий кластер в область применения в разделе Администрирование → Управление доступом → Области применения.
- Выберите используемую платформу оркестрации.
- Укажите название пространства имен, которое будет использоваться для установки агентов.
Пространство имен должно существовать на момент запуска агентов.
- В блоке Реестр введите веб-адрес реестра Kaspersky Container Security, где находятся образы, с которых производится установка агентов. Для доступа к реестру требуется указать имя пользователя и пароль, которые используются для этого реестра.
- В блоке Сканирование на соответствие отраслевым стандартам укажите период сканирования кластера на соответствие отраслевым стандартам. Вы можете выбрать значение от 1 до 168 часов. Значение по умолчанию: 24 часа.
- В блоке Обновление базы данных укажите значения следующих параметров:
- URL инструмента обновлений, который используется для базы данных. Если вы не укажете значение этого параметра, обновления агентов будут осуществляться с помощью серверов обновлений "Лаборатории Касперского".
- URL прокси-сервера для облачного или локального сервера обновлений. Если вы не укажете значение этого параметра, подключение будет осуществляться напрямую с агентов без использования прокси-сервера.
Вам необходимо ввести URL прокси-сервера с указанием протокола HTTP и номера порта.
Если для обновления антивирусных баз используется контейнер
kcs-updates, URL инструмента обновлений антивирусных баз требуется указать следующим образом:<домен>/kuu/updates(например,https://kcs.company.com/kuu/updates).
- Заполните поля формы:
- На вкладке Мониторинг состояния узлов с помощью переключателя Выключить / Включить запустите действия по мониторингу и анализу состояния сети, процессов в контейнерах и защиты от файловых угроз для следующих параметров:
- Сетевые соединения. Состояние сетевых соединений отслеживается с помощью устройств для фиксации сетевого трафика (сетевых мониторов) и модулей на базе технологии eBPF. При этом учитываются применимые политики среды выполнения и профили среды выполнения контейнеров.
С помощью установки флажков вы можете активировать выполнение следующих действий по мониторингу:
- Включить контроль сетевой репутации.
- Включить мониторинг открытия портов.
- Выключить мониторинг остальных соединений.
Мониторинг и логирование сетевых событий, которые не попадают под действие применимых политик среды выполнения, требуют дополнительных ресурсов для обработки и хранения полученных данных. Вы можете уменьшить нагрузку на решение, выключив мониторинг остальных соединений.
По умолчанию эти действия выключены.
- Процессы в контейнерах. Процессы в контейнерах отслеживаются с помощью модулей на базе технологии eBPF, учитывая применимые политики среды выполнения и профили среды выполнения контейнеров.
- Защита от файловых угроз. Если действия по защите от файловых угроз запущены, вы можете выбрать объекты, для которых будет включен мониторинг в рамках компонента Защита от файловых угроз: Все, Контейнеры или Узлы. По умолчанию мониторинг включен для контейнеров.
В Kaspersky Container Security настройки параметров компонента Защита от файловых угроз применяются одинаково к контейнерам и узлам. Если в качестве режима проверки объектов выбран режим Блокирование, файловый перехватчик будет применять этот режим как к контейнерам, так и к узлам. В зависимости от выбранных значений параметров компонента Защита от файловых угроз файлы на узлах могут блокироваться, перемещаться или удаляться. Такие операции с файлами могут привести к сбоям в работе вашей инфраструктуры. Мы рекомендуем учитывать такую возможность, если при настройке параметров группы агентов вы включаете мониторинг для всех объектов или для узлов, а в параметрах компонента Защита от файловых угроз указан режим блокирования.
- Файловые операции. Решение отслеживает файловые операции с помощью модулей на базе технологии eBPF, учитывая применимые политики среды выполнения и профили среды выполнения контейнеров.
Вне зависимости от режима, указанного в политике среды выполнения, для файловых операций поддерживается только режим Аудит. Если в применимой политике среды выполнения установлен режим Блокирование, файловые операции осуществляются в режиме Аудит.
- Жизненный цикл контейнера. Решение осуществляет мониторинг изменений состояния контейнеров (их создание, запуск, остановку, удаление, приостановку и возобновление). Это позволяет отслеживать операции в отношении контейнеров на узле, которые выполняются в обход оркестратора.
Вне зависимости от режима, указанного в политике среды выполнения, для мониторинга жизненного цикла контейнеров поддерживается только режим Аудит. Если в применимой политике среды выполнения установлен режим Блокирование, жизненный цикл контейнеров отслеживается в режиме Аудит.
- Авторизация на хосте. Решение осуществляет мониторинг попыток входа локальных и удаленных пользователей в операционную систему хоста. Kaspersky Container Security отслеживает все попытки авторизации (успешные и безуспешные), а также определяет протокол, по которому осуществлялась попытка авторизации на хосте (SSH, TELNET, RDP).
Решение отправляет события авторизации на хосте непосредственно в выбранную вами SIEM-систему и не отображает их в веб-интерфейсе.
Ненужные действия в рамках процесса мониторинга можно выключить, чтобы избежать нецелесообразной нагрузки на узлы.
По умолчанию все действия по мониторингу и анализу состояния сети, процессов в контейнерах и защиты от файловых угроз выключены.
- Сетевые соединения. Состояние сетевых соединений отслеживается с помощью устройств для фиксации сетевого трафика (сетевых мониторов) и модулей на базе технологии eBPF. При этом учитываются применимые политики среды выполнения и профили среды выполнения контейнеров.
- Выполните одно из следующих действий:
- Нажмите на кнопку Сохранить.
Решение сохранит параметры группы агентов.
- Нажмите на кнопку Сохранить и скачать YAML.
Решение сохранит параметры группы агентов и скачает манифест в формате YAML.
- Нажмите на кнопку Сохранить.
При создании группы агентов решение показывает количество ресурсов, которые потребляет конфигурация группы агентов. Ресурсы отображаются следующим образом:
- ЦПУ – количество задействованных ядер.
- ОЗУ – объем оперативной памяти в ГБ.
В рабочей области на вкладке Данные для установки агентов отобразятся следующие данные, необходимые для установки агентов на кластере:
- Автоматически сгенерированный токен для установки – это идентификатор, который будет использовать агент при подключении к серверу.
- Инструкция для установки агентов на кластере.
В Kaspersky Container Security 2.5 группы агентов не связываются с SIEM-системами, интеграции с которыми настроены в решении. В отличие от более ранних версий решения информация о событиях агентов не направляется в такие SIEM-системы.
При необходимости после установки вы можете просмотреть и изменить параметры групп агентов.
Просмотр и изменение параметров группы агентов
В разделе Компоненты → Агенты в таблице отображаются созданные и развернутые группы агентов. Для каждой из таких групп представлена следующая информация:
- Название группы агентов.
- Количество подключенных агентов в группе. Решение отображает количество агентов со статусом подключения Подключен и общее количество агентов в группе.
- Пространство имен, в котором состоит группа агентов.
- Оркестратор, управляющий группой агентов.
- Включенные действия по мониторингу состояния узлов. Решение показывает действия по мониторингу, включенные в группе агентов, следующим образом:
- Процессы в контейнерах.
- Сетевые соединения. Решение дополнительно отображает включенные действия по мониторингу сетевой репутации с помощью значка защиты репутации (
) и мониторингу открытия портов с помощью значка открытия портов (
). - Защита от файловых угроз. Решение дополнительно отображает включенную защиту контейнеров с помощью значка контейнера (
) и защиту узлов с помощью значка узла (
). - Файловые операции.
- Жизненный цикл контейнера.
- Авторизация на хосте.
Если действия по мониторингу в группе агентов не включены, решение отображает Выключено.
Вы можете настроить отображение групп агентов по статусу подключения агентов (Все, Подключен, Отключен, Ожидает) с помощью соответствующих кнопок, расположенных над таблицей.
Нажав на значок развертывания (
), каждую группу агентов в таблице можно развернуть, чтобы посмотреть следующую информацию по агентам в ее составе:
- Название агента и статус его подключения.
- Версия узла, на котором развернут агент (главный или рабочий узел).
- Имя пода, с которым связан агент.
- Статусы выполнения действий по мониторингу состояния узлов (Процессы в контейнерах, Сетевые соединения, Защита от файловых угроз, Жизненный цикл контейнера и Файловые операции).
- Дата и время последнего подключения агента.
По ссылке на названии агента вы можете раскрыть боковую панель, чтобы посмотреть информацию о состоянии агента.
Чтобы изменить параметры группы агентов:
- В разделе Компоненты → Агенты в таблице со списком групп агентов нажмите на ссылку на названии группы агентов.
- В открывшемся окне измените параметры группы.
Вы можете добавить области применения только при создании группы агентов. Добавленные в группы агентов области применения можно изменить в разделе Администрирование → Управление доступом → Области применения.
При изменении параметров решение показывает количество ресурсов, которые будет потреблять группа агентов (ЦПУ/ОЗУ). Если устанавливаемая вами конфигурация не требует больше ресурсов, чем выделено для группы агентов, решение обновит параметры группы агентов без необходимости переустановки манифеста агентов. Если количество имеющихся ресурсов будет превышено, решение предупредит о необходимости переустановки манифеста агентов с помощью значка предупреждения (
) и соответствующего сообщения. - Выполните одно из следующих действий:
- Нажмите на кнопку Сохранить.
Решение сохранит параметры группы агентов.
- Нажмите на кнопку Сохранить и скачать YAML.
Решение сохранит параметры группы агентов и скачает манифест в формате YAML.
- Нажмите на кнопку Сохранить.
При обновлении версии решения до Kaspersky Container Security 2.5 указанные вами значения параметров группы агентов переносятся без изменений. Если вам нужно изменить параметры группы агентов, убедитесь, что вы указали правильные значения протокола и номера порта для URL прокси-сервера в блоке Обновление базы данных на вкладке Общая информация, так как они будут проверяться.
В Kaspersky Container Security 2.5 значения протокола и номера порта для URL прокси-сервера можно изменить с помощью OpenAPI версии 3. Для этого следующим объектам Endpoint (integrations/agent-group) добавлены поля networkSettingsProxyUrl и networkSettingsSource.
Пример заполнения полей
"networkSettingsProxyUrl": "http://username:password@example.com:8080",
"networkSettingsSource": "https://kcs.example.com/kuu/updates/"
Параметр networkSettingsProxyUrl является секретом и доступен только для записи. Решение не отправляет значение этого параметра через открытые конечные точки сети с помощью OpenAPI и не отображает в веб-интерфейсе.
Агенты должны быть установлены на всех узлах кластера, который вы хотите защищать. В Kaspersky Container Security вы можете установить агенты следующими способами:
- В консоли управления, реализованной в веб-интерфейсе решения.
До установки агентов требуется создать группу агентов.
Чтобы установить агенты в веб-интерфейсе:
- В главном меню перейдите в раздел Компоненты → Агенты.
- В столбце Название группы таблицы выберите группу агентов, нажмите на нее и перейдите на вкладку Данные для установки агентов.
- Нажмите на значок
рядом с полем Токен для установки для копирования сгенерированного токена для установки. - Нажмите на значок
рядом с полем Конфигурация для копирования инструкции для установки агентов.Вы также можете скачать инструкцию для установки агентов в виде файла в формате YAML.
В этом YAML-файле вы можете изменить настройки агентов и других ресурсов, развертываемых в кластере. Например, при необходимости можно отключить проверку хеша образа в реестре, чтобы максимально ускорить проверки в рамках политик среды выполнения с помощью контроллера доступа. Проверки при этом будут проводиться только на основе имени и тега образа. Для этого переменной окружения контейнера kcs-kube-agent
DAC_REGISTRY_REQUESTнужно присвоить значениеfalse.При
DAC_REGISTRY_REQUEST = falseнеобходимо учитывать следующее: если образ изменится (поменяется хеш образа), а имя и тег образа останутся прежними, решение будет считать образ неизмененным. - Выполните следующую команду:
kubectl apply -f <файл> -n <пространство имен>После применения инструкции агент будет установлен на всех рабочих узлах кластера.
Решение автоматически обновляет инструкцию для установки агентов, если вы изменяете следующие параметры, указанные для группы агентов:
- TLS-сертификаты решения;
- URL, имя пользователя и пароль для скачивания образов агентов kube-agent и node-agent;
- параметры в блоке Мониторинг состояния узлов.
Для работы агентам требуется доступ к API Kaspersky Container Security. Если агенты и API решения можно связать в сети только с использованием прокси-сервера, вы можете добавить конфигурацию прокси-сервера в инструкцию для установки агентов, создав специальный секрет.
Чтобы добавить конфигурацию прокси-сервера в инструкцию для установки агентов:
- Укажите данные прокси-сервера в кодировке BASE64. В примере ниже указаны данные для прокси-сервера http://proxy.example.com:8080:
---
apiVersion: v1
kind: Secret
metadata:
name: http-client-proxy
namespace: kcs-namespace
type: opaque
data:
HTTP_CLIENT_PROXY: 'aHR0cDovL3Byb3h5LmV4YW1wbGUuY29tOjgwODA='
---
- Добавьте использование секрета в секцию
ENVресурсов DaemonSet и Deployment в инструкции для установки агентов:- name: HTTP_CLIENT_PROXY
valueFrom:
secretKeyRef:
name: http-client-proxy
key: HTTP_CLIENT_PROXY
Необходимо повторно скопировать или скачать обновленную инструкцию в виде файла в формате YAML, а затем применить ее с помощью команды
kubectl apply -f <файл> -n <пространство имен>.Если этого не сделать, изменения указанных параметров для установленных агентов не будут применены.Перед обновлением агентов Kaspersky Container Security до версии 2.5.х необходимо сначала удалить установленных агентов с помощью инструкции для установки агентов предыдущей версии или команды
kubectl delete -f <файл> -n <пространство имен>. После этого требуется применить инструкцию для установки агентов для версии Kaspersky Container Security 2.5.х. - С помощью конфигурационного файла в составе пакета Helm Chart.
До установки агентов требуется создать группу агентов.
Чтобы установить агентов с помощью пакета Helm Chart:
- С помощью Kaspersky Container Security OpenAPI скачайте конфигурационный файл values.yaml с помощью следующей команды:
curl -X 'GET' \
'{{kcs_domain}}/api/v1/integrations/agent-group/{{agentGroupId}}/values' \
-H 'accept: application/x-yaml' \
-H 'Tron-Token: {{token}}' -o values-agents.yaml
где
{{agentGroupId}}– уникальный идентификатор (англ. UUID), который решение присваивает группе агентов при ее создании;{{token}}– токен API, который можно посмотреть в профиле пользователя.
После загрузки файла у вас будет 2 конфигурационных файла: values.yaml из комплекта поставки и values-agents.yaml, скачанный с помощью Kaspersky Container Security OpenAPI.
- При необходимости измените имя конфигурационного файла values.yaml в составе пакета Helm Chart из комплекта поставки на values-kcs.yaml. Такое имя файла указывает на то, что в нем содержатся данные для установки Kaspersky Container Security
Мы не рекомендуем заменять конфигурационный файл values.yaml в составе пакета Helm Chart из комплекта поставки. Это может привести к потере данных для установки Kaspersky Container Security.
- Установите конфигурационный файл values-agents.yaml с помощью следующей команды:
helm install kcs-agents . \
--create-namespace \
--namespace kcs-agents \
--values values-agents.yaml \
--set ...
При установке агентов с помощью пакета Helm Chart требуется учитывать следующее:
- Если агенты устанавливаются в кластер, в котором развернуто решение, то пространство имен агентов должно отличаться от пространства имен Kaspersky Container Security. По умолчанию пространство имен Kaspersky Container Security –
kcs. - В конфигурационный файл для установки агентов (values-agents.yaml) не переносятся секреты, которые вы могли указать при создании группы агентов. Например, не переносятся значения объектов
pullSecretдля скачивания образов.Если эти значения нужны, необходимо указать их еще раз вручную или задать с помощью команды
--setпри установке с помощью пакета Helm Chart из комплекта поставки.
Начиная с версии Kaspersky Container Security 2.3, при установке с помощью пакета Helm Chart компонент kube-agent не может создавать CRD на уровне кластера. Права на создание CRD должны быть у учетной записи пользователя, с которой устанавливаются агенты с помощью конфигурационного файла values-agents.yaml в пакете Helm Chart.
Custom Resource Definition – это специальный ресурс, который позволяет расширять API Kubernetes с помощью создания пользовательских объектов. CRD создают новые типы объектов, которые Kubernetes будет распознавать и обрабатывать так же, как и свои внутренние объекты и сущности (например, поды, Deployment, ReplicaSet).
При необходимости вы также можете настроить параметры для работы с базами сетевой репутации. Для этого в конфигурационный файл для установки агентов необходимо добавить представленные ниже переменные и указать их значение:
UPDATE_SOURCE– веб-адрес источника обновлений баз данных сетевой репутации и компонента Защита от файловых угроз. Значение этого параметра можно не указывать, если для актуализации баз данных используются сервера "Лаборатории Касперского".Если в качестве источника обновлений используется файл-сервер обновлений для закрытых контуров (kcs-updates), необходимо указать значение переменной
UPDATE_SOURCE. Если этого не сделать, решение будет запрашивать обновления с серверов "Лаборатории Касперского".UPDATE_PROXY– прокси-сервер внешних баз данных сетевой репутации, компонента Защита от файловых угроз или файл-сервера обновлений для закрытых контуров (kcs-updates).
Перед обновлением агентов Kaspersky Container Security до версии 2.5.х необходимо сначала удалить установленных агентов с помощью инструкции для установки агентов предыдущей версии или команды
kubectl delete -f <файл> -n <пространство имен>. После этого требуется применить инструкцию для установки агентов для версии Kaspersky Container Security 2.5.х. - С помощью Kaspersky Container Security OpenAPI скачайте конфигурационный файл values.yaml с помощью следующей команды:
Внесение изменений в параметры группы агентов зависит от выбранного вами способа установки:
- Если вы установили агенты с помощью инструкции для установки агентов в веб-интерфейсе решения, все дальнейшие изменения группы агентов можно осуществлять только используя инструкцию для установки агентов.
- Если вы установили агенты с помощью конфигурационного файла в составе пакета Helm Chart, все дальнейшие изменения группы агентов можно осуществлять только используя Helm Chart.
На каждый кластер устанавливается отдельная группа агентов.
Если вы применяете Cilium CNI, при установке агентов node-agent требуется учитывать правила и исключения Cilium CNI.