Установка агентов
02 июня 2026
ID 300161
Для обеспечения безопасности контейнеризированных объектов вам необходимо создать и установить группы агентов Kaspersky Container Security.
Чтобы создать группу агентов:
- В главном меню перейдите в раздел Компоненты → Агенты.
- В рабочей области нажмите на кнопку Добавить группу агентов.
- На вкладке Общая информация выполните следующие действия:
- Заполните поля формы:
- Введите название группы. В качестве названия группы для удобства управления агентами рекомендуется указывать имя кластера, на узлах которого будут установлены агенты.
- Если требуется, введите описание группы агентов.
- В раскрывающемся списке выберите одну или несколько областей применения, которые доступны роли пользователя. Если значение не указано, решение применяет установленную по умолчанию область применения.
Если потребуется добавить какую-либо область применения после создания группы агентов, необходимо добавить соответствующий кластер в область применения в разделе Администрирование → Управление доступом → Области применения.
- Выберите используемый оркестратор.
- Укажите название пространства имен, которое будет использоваться для установки агентов.
Пространство имен должно существовать на момент запуска агентов.
- В блоке Реестр введите веб-адрес реестра Kaspersky Container Security, где находятся образы, с которых производится установка агентов. Для доступа к реестру требуется указать имя пользователя и пароль, которые используются для этого реестра.
- В блоке Связанная SIEM-система из раскрывающегося списка выберите SIEM-систему.
Для связывания группы агентов в Kaspersky Container Security необходимо создать и настроить хотя бы одну интеграцию с SIEM-системой.
Одну группу агентов можно связать только с одной SIEM-системой.Для каждой интеграции с SIEM-системой в раскрывающемся списке указывается статус ее подключения – Успешно, С предупреждением или Ошибка.
- Заполните поля формы:
- На вкладке Мониторинг состояния узлов с помощью переключателя Выключить / Включить запустите действия по мониторингу и анализу состояния сети, процессов в контейнерах и защиты от файловых угроз для следующих параметров:
- Сетевые соединения. Состояние сетевых соединений отслеживается с помощью устройств для фиксации сетевого трафика (сетевых мониторов) и модулей на базе технологии eBPF. При этом учитываются применимые политики среды выполнения и профили среды выполнения контейнеров.
С помощью установки флажков вы можете активировать следующие действия по мониторингу:
- Действия по мониторингу сетевой репутации.
- Действия по мониторингу открытия портов.
По умолчанию эти действия выключены.
- Процессы в контейнерах. Процессы в контейнерах отслеживаются с помощью модулей на базе технологии eBPF, учитывая применимые политики среды выполнения и профили среды выполнения контейнеров.
- Защита от файловых угроз. Если действия по защите от файловых угроз запущены, вы можете выбрать объекты, для которых будет включен мониторинг в рамках компонента Защита от файловых угроз: Все, Контейнеры или Узлы. По умолчанию мониторинг включен для контейнеров.
В Kaspersky Container Security настройки параметров компонента Защита от файловых угроз применяются одинаково к контейнерам и узлам. Если в качестве режима проверки объектов выбран режим Блокирование, файловый перехватчик будет применять этот режим как к контейнерам, так и к узлам. В зависимости от выбранных значений параметров компонента Защита от файловых угроз файлы на узлах могут блокироваться, перемещаться или удаляться. Такие операции с файлами могут привести к сбоям в работе вашей инфраструктуры. Мы рекомендуем учитывать такую возможность, если при настройке параметров группы агентов вы включаете мониторинг для всех объектов или для узлов, а в параметрах компонента Защита от файловых угроз указан режим блокирования.
Для отслеживания обновлений антивирусных баз необходимо указать одно из следующих значений:
- URL инструмента обновлений антивирусных баз – веб-адрес сервера обновлений Kaspersky Container Security.
- Прокси-сервер обновлений антивирусных баз – прокси-сервер HTTP для облачного или локального сервера обновлений.
Если для обновления антивирусных баз используется контейнер
kcs-updates, URL инструмента обновлений антивирусных баз требуется указать следующим образом:<домен>/kuu/updates(например,https://kcs.company.com/kuu/updates).По умолчанию базы данных компонента Защита от файловых угроз обновляются с помощью облачных серверов "Лаборатории Касперского".
- Файловые операции. Решение отслеживает файловые операции с помощью модулей на базе технологии eBPF, учитывая применимые политики среды выполнения и профили среды выполнения контейнеров.
Вне зависимости от режима, указанного в политике среды выполнения, для файловых операций поддерживается только режим Аудит. Если в применимой политике среды выполнения установлен режим Блокирование, файловые операции осуществляются в режиме Аудит.
- Жизненный цикл контейнера. Решение осуществляет мониторинг изменений состояния контейнеров (их создание, запуск, остановку, удаление, приостановку и возобновление). Это позволяет отслеживать операции в отношении контейнеров на узле, которые выполняются в обход оркестратора.
Вне зависимости от режима, указанного в политике среды выполнения, для мониторинга жизненного цикла контейнеров поддерживается только режим Аудит. Если в применимой политике среды выполнения установлен режим Блокирование, жизненный цикл контейнеров отслеживается в режиме Аудит.
- Авторизация на хосте. Решение осуществляет мониторинг попыток входа локальных и удаленных пользователей в операционную систему хоста. Kaspersky Container Security отслеживает все попытки авторизации (успешные и безуспешные), а также определяет протокол, по которому осуществлялась попытка авторизации на хосте (SSH, TELNET, RDP).
Решение отправляет события авторизации на хосте непосредственно в выбранную вами SIEM-систему и не отображает их в веб-интерфейсе.
Ненужные действия в рамках процесса мониторинга можно выключить, чтобы избежать нецелесообразной нагрузки на узлы.
По умолчанию все действия по мониторингу и анализу состояния сети, процессов в контейнерах и защиты от файловых угроз выключены.
- Сетевые соединения. Состояние сетевых соединений отслеживается с помощью устройств для фиксации сетевого трафика (сетевых мониторов) и модулей на базе технологии eBPF. При этом учитываются применимые политики среды выполнения и профили среды выполнения контейнеров.
- Нажмите на кнопку Сохранить.
В рабочей области на вкладке Данные для установки агентов отобразятся следующие данные, необходимые для установки агентов на кластере:
- Автоматически сгенерированный токен для установки – это идентификатор, который будет использовать агент при подключении к серверу.
- Инструкция для установки агентов на кластере.
При необходимости после установки вы можете просмотреть и изменить параметры групп агентов.
Просмотр и изменение параметров группы агентов
В разделе Компоненты → Агенты в таблице отображаются созданные и развернутые группы агентов. Для каждой из таких групп представлена следующая информация:
- Название группы агентов.
- Количество подключенных агентов в группе. Решение отображает количество агентов со статусом подключения Подключен и общее количество агентов в группе.
- Пространство имен, в котором состоит группа агентов.
- Оркестратор, управляющий группой агентов.
- Включенные действия по мониторингу состояния узлов. Решение показывает действия по мониторингу, включенные в группе агентов, следующим образом:
- Процессы в контейнерах.
- Сетевые соединения. Решение дополнительно отображает включенные действия по мониторингу сетевой репутации с помощью значка защиты репутации (
) и мониторингу открытия портов с помощью значка открытия портов (
). - Защита от файловых угроз. Решение дополнительно отображает включенную защиту контейнеров с помощью значка контейнера (
) и защиту узлов с помощью значка узла (
). - Файловые операции.
- Жизненный цикл контейнера.
- Авторизация на хосте.
Если действия по мониторингу в группе агентов не включены, решение отображает Выключено.
- Связанная SIEM-система.
Вы можете настроить отображение групп агентов по статусу подключения агентов (Все, Подключен, Отключен, Ожидает) с помощью соответствующих кнопок, расположенных над таблицей.
Нажав на значок развертывания (
), каждую группу агентов в таблице можно развернуть, чтобы посмотреть следующую информацию по агентам в ее составе:
- Название агента и статус его подключения.
- Версия узла, на котором развернут агент (главный или рабочий узел).
- Имя пода, с которым связан агент.
- Статусы выполнения действий по мониторингу состояния узлов (Процессы в контейнерах, Сетевые соединения, Защита от файловых угроз, Жизненный цикл контейнера и Файловые операции).
- Статус подключения к SIEM-системе.
- Дата и время последнего подключения агента.
По ссылке на названии агента вы можете раскрыть боковую панель, чтобы посмотреть информацию о состоянии агента.
Чтобы изменить параметры группы агентов:
- В разделе Компоненты → Агенты в таблице со списком групп агентов нажмите на ссылку на названии группы агентов.
- В открывшемся окне измените параметры группы.
Вы можете добавить области применения только при создании группы агентов. Добавленные в группы агентов области применения можно изменить в разделе Администрирование → Управление доступом → Области применения.
- Нажмите на кнопку Сохранить.
Агенты должны быть установлены на всех узлах кластера, который вы хотите защищать. В 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;
- cвязанную SIEM-систему;
- параметры в блоке Мониторинг состояния узлов.
Для работы агентам требуется доступ к 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.4.х необходимо сначала удалить установленных агентов с помощью инструкции для установки агентов предыдущей версии или команды
kubectl delete -f <файл> -n <пространство имен>. После этого требуется применить инструкцию для установки агентов для версии Kaspersky Container Security 2.4.х. - С помощью конфигурационного файла в составе пакета 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для скачивания образов; - данные для авторизации в SIEM-системе в
SIEM_CREDENTIALS; - данные прокси-сервера антивирусных баз в
MALWARE_DB_PROXY_URL.
Если значения таких переменных нужны, необходимо указать их еще раз вручную или задать с помощью команды
--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.4.х необходимо сначала удалить установленных агентов с помощью инструкции для установки агентов предыдущей версии или команды
kubectl delete -f <файл> -n <пространство имен>. После этого требуется применить инструкцию для установки агентов для версии Kaspersky Container Security 2.4.х. - С помощью Kaspersky Container Security OpenAPI скачайте конфигурационный файл values.yaml с помощью следующей команды:
На каждый кластер устанавливается отдельная группа агентов.
Если вы применяете Cilium CNI, при установке агентов node-agent требуется учитывать правила и исключения Cilium CNI.