Интеграция со средствами уведомления

04 сентября 2026

ID 304606

Kaspersky Container Security может уведомлять пользователей о событиях в работе решения в соответствии с параметрами политики реагирования. Чтобы использовать функцию уведомления, вам нужно настроить интеграцию решения с одним или несколькими средствами уведомления.

Kaspersky Container Security может использовать следующие средства уведомления:

электронная почта;
Настройка интеграции с электронной почтой
Чтобы настроить интеграцию с электронной почтой:
1. В разделе Администрирование → Интеграции → Уведомления в блоке Электронная почта нажмите на кнопку Добавить интеграцию.
  Откроется окно ввода параметров интеграции.
2. Укажите следующие параметры в полях формы:
  - Название интеграции. Это название будет отображаться в параметрах политики реагирования.
  - Имя пользователя и пароль учетной записи, которая используется для отправки сообщений.
  - Имя сервера SMTP.
  - Способ шифрования электронной почты.
  - Порт, который использует сервер SMTP.
  - Адреса электронной почты отправителя и получателей сообщений. Вы можете указать один или несколько адресов электронной почты получателей сообщений.
    Убедитесь, что указанная в полях Отправитель и Получатели информация не содержит конфиденциальных данных (например, имени пользователя и пароля). Введенные значения не будут зашифрованы при экспорте конфигурации решения.
3. Нажмите на кнопку Проверить соединение, чтобы посмотреть, устанавливается ли соединение с электронной почтой.
4. Нажмите на кнопку Добавить, чтобы сохранить параметры интеграции с электронной почтой.
Пример параметров интеграции с электронной почтой
Далее представлен пример параметров интеграции Kaspersky Container Security с электронной почтой.

{

"form": {

"type": "email",

"name": "Email integration",

"username": "username@example.com",

"password": "P@ssword!",

"host": "smtp.company.com",

"port": 465,

"encrypting": "ssl",

"sender": "sender@example.com",

"recipients": [

"user@company.com",

"user1@company.com"

]

}

}

Для параметра encrypting необходимо указать один из следующих вариантов:
- tls
- ssl
- null
Настроенную интеграцию вы можете использовать в политиках реагирования.
Просмотр информации об интеграции с электронной почтой
Чтобы просмотреть и изменить интеграцию с электронной почтой:
1. В блоке Электронная почта в разделе Администрирование → Интеграции → Уведомления нажмите на ссылку на названии интеграции в списке интеграций.
2. В открывшемся окне редактирования при необходимости измените следующие параметры интеграции:
  - Название.
  - Имя пользователя.
  - Пароль учетной записи, которая используется для отправки сообщений.
  - Имя сервера SMTP.
  - Способ шифрования электронной почты.
  - Порт, который использует сервер SMTP.
  - Адрес электронной почты отправителя сообщений.
  - Адрес электронной почты получателей сообщений.
3. Нажмите на кнопку Проверить соединение, чтобы посмотреть, устанавливается ли соединение с электронной почтой.
4. Нажмите Сохранить.
система обмена мгновенными сообщениями Telegram;
Настройка интеграции с Telegram
Чтобы настроить интеграцию с Telegram:
1. В разделе Администрирование → Интеграции → Уведомления в блоке Telegram нажмите на кнопку Добавить интеграцию.
  Откроется окно ввода параметров интеграции.
2. Укажите следующие параметры в полях формы:
  - Название интеграции. Это название будет отображаться в параметрах политики реагирования.
  - Идентификатор чата, в котором будут публиковаться сообщения. Вы можете получить идентификатор следующим образом:
    1. Напишите первое сообщение боту, который будет публиковать сообщения. Идентификатор чата генерируется при первой отправке сообщения.
    2. Введите в адресной строке браузера:
      https://api.telegram.org/bot<токен>/getUpdates,
      
      где <токен> – токен бота, который будет публиковать сообщения.
    3. В полученном json-ответе найдите значение "id" из объекта "chat" – это идентификатор чата.
    После изменения настроек видимости истории сообщений для новых участников в чате Telegram меняется идентификатор чата. В таком случае требуется изменить настройки интеграции с Telegram и указать новое значение идентификатора чата.
  - Токен бота, который будет публиковать сообщения. Токен вы получаете в результате создания бота по команде /newbot в боте BotFather. Вы также можете получить токен ранее созданного бота по команде /token.
3. Нажмите на кнопку Проверить соединение, чтобы посмотреть, устанавливается ли соединение с Telegram.
4. Нажмите на кнопку Добавить, чтобы сохранить параметры интеграции с Telegram.
Пример параметров интеграции с Telegram

Далее представлен пример параметров интеграции Kaspersky Container Security с Telegram.

{

"form": {

"type": "telegram",

"name": "Telegram integration",

"chatId": "{{chatId}}",

"botToken": "{{botToken}}"

}

}

Настроенную интеграцию вы можете использовать в политиках реагирования.
Просмотр и изменение информации об интеграции с Telegram
Чтобы просмотреть и изменить интеграцию с Telegram:
1. В блоке Telegram в разделе Администрирование → Интеграции → Уведомления нажмите на ссылку на названии интеграции в списке интеграций.
2. В открывшемся окне редактирования при необходимости измените следующие параметры интеграции:
  - Название.
  - Идентификатор чата.
  - Токен бота.
3. Нажмите на кнопку Проверить соединение, чтобы посмотреть, устанавливается ли соединение с Telegram.
4. Нажмите Сохранить.
вебхуки.
Настройка интеграции с вебхуками
Вебхук (англ. webhook) – это механизм, позволяющий Kaspersky Container Security отслеживать изменения и направлять вам информацию при наступлении определенного события. С помощью HTTP-сообщений вебхуки запускают указанные вами действия в другом решении.

Чтобы настроить интеграцию с вебхуком:
1. В разделе Администрирование → Интеграции → Уведомления на вкладке Вебхуки нажмите на кнопку Добавить интеграцию.
  Откроется окно ввода параметров интеграции.
2. Укажите название интеграции, которое будет отображаться в параметрах политики реагирования.
3. В поле URL укажите полный веб-адрес, на который Kaspersky Container Security будет направлять уведомления (например, https://company.com/v3/notifications/notcompliant). Вы также можете указать получателя уведомления в следующем формате: <IP-адрес>:<номер порта> (например, 127.0.0.1:2193).
4. При необходимости с помощью флажка Количество запросов в секунду включите ограничение и определите на количество уведомлений, которое решение будет отправлять в секунду. Если максимально установленное количество уведомлений будет превышено, решение поставит сообщений в очередь на отправку в следующий период (секунду), но его приоритет будет ниже, чем у более новых сообщений.
  По умолчанию установлено 150 запросов в секунду.
5. Выберите один из следующих способов авторизации, нажав на соответствующую кнопку:
  - Открытый доступ.
  - Базовая проверка – авторизация осуществляется с помощью имени пользователя и пароля.
  - HMAC – для авторизации необходимо указать хеш-алгоритм, заголовок и секрет.
  - Токен API – для авторизации необходимо указать заголовок и значение токена API.
6. Укажите данные для авторизации в зависимости от выбранного способа авторизации.
7. При необходимости в поле Данные в формате JSON внесите изменения в текст запроса. По умолчанию решение отображает следующий текст запроса:
  {
  
  "general_template": {
  
  "response_policy_name": $$response_policy_name$$,
  
  "image_name": $$image_name$$,
  
  "registry_name": $$registry_name$$,
  
  "compliance_verdict": $$compliance_verdict$$,
  
  "malware_count": $$malware_count$$,
  
  "sensitive_data_count": $$sensitive_data_count$$,
  
  "misconfigurations_count": $$misconfigurations_count$$,
  
  "vulnerabilities_count": $$vulnerabilities_count$$,
  
  "total_critical": $$total_critical$$,
  
  "total_high": $$total_high$$,
  
  "total_medium": $$total_medium$$,
  
  "risks": $$risks$$,
  
  "agent_group_name": $$agent_group_name$$,
  
  "agent_group_failed_agent_number": $$agent_group_failed_agent_number$$,
  
  "agent_group_runtime_policies_blocked_number": $$agent_group_runtime_policies_blocked_number$$,
  
  "agent_group_dac_policies_blocked_number": $$agent_group_dac_policies_blocked_number$$,
  
  "agents": $$agents$$,
  
  "core_component_name": $$core_component_name$$,
  
  "core_component_pod_name": $$core_component_pod_name$$,
  
  "core_component_status": $$core_component_status$$,
  
  "core_component_error_message": $$core_component_error_message$$
  
  },
  
  "agent_template": {
  
  "agent_name": $$agent_name$$,
  
  "agent_type": $$agent_type$$,
  
  "agent_error_message": $$agent_error_message$$,
  
  "agent_pod_ip": $$agent_pod_ip$$
  
  },
  
  "risk_template": {
  
  "risk_name": $$risk_name$$,
  
  "image_name": $$image_name$$,
  
  "repository_name": $$repository_name$$,
  
  "expiration": $$expiration$$
  
  }
  
  }
  
  Вы можете удалить или дублировать строки, указанные в запросе:
  - $$response_policy_name$$ – название сработавшей политики реагирования.
  - $$image_name$$ – имя целевого образа.
  - $$registry_name$$ – название интеграции с реестром образа.
  - $$compliance_verdict$$ – статус соответствия требованиям политики (Соответствует или Не соответствует).
  - $$malware_count$$ – количество найденных объектов с вредоносным ПО.
  - $$sensitive_data_count$$ – количество найденных конфиденциальных данных.
  - $$misconfigurations_count$$ – количество найденных ошибок конфигурации.
  - $$vulnerabilities_count$$ – количество найденных уязвимостей.
  - $$total_critical$$ – количество найденных уязвимостей с уровнем критичности Критический.
  - $$total_high$$ – количество найденных уязвимостей с уровнем критичности Высокий.
  - $$total_medium$$ – количество найденных уязвимостей с уровнем критичности Средний.
  - $$risks$$ – массив принятых ранее рисков, для которых срок принятия риска истек или истечет в течении пяти дней.
  - $$risk_name$$ – название риска.
  - $$image_name$$ – название артефакта (сочетание имени репозитория и тега), на который распространяется принятие риска.
  - $$repository_name$$ – имя репозитория, в котором был принят риск.
  - $$expiration$$ – дата истечения принятия риска.
  - $$agent_group_name$$ – название группы агентов.
  - $$agent_group_failed_agent_number$$ – количество агентов, которые прекратили работать.
  - $$agent_group_runtime_policies_blocked_number$$ – количество включенных политик среды выполнения, которые решение не может применить из-за недоступности группы агентов.
  - $$agent_group_dac_policies_blocked_number$$ – количество включенных политик контроля доступа, которые решение не может применить из-за недоступности группы агентов.
  - $$agents$$ – массив агентов, которые прекратили работать.
  - $$agent_name$$ – название агента.
  - $$agent_type$$ – тип агента.
  - $$agent_error_message$$ – подробная информация об ошибке в работе агента (если доступно).
  - $$agent_pod_ip$$ – IP-адрес пода агента.
  - $$core_component_name$$ – имя компонента ядра.
  - $$core_component_pod_name$$ – имя пода, на котором расположен компонент ядра.
  - $$core_component_status$$ – статус состояния компонента ядра.
  - $$core_component_error_message$$ – подробная информация об ошибке в работе компонента ядра.
  Текст запроса должен соответствовать формату JSON. Значения в строках запроса необходимо указывать в виде $$example$$.
  
  Убедитесь, что указанная в поле Данные в формате JSON информация не содержит конфиденциальных данных (например, имени пользователя и пароля). Введенные значения не будут зашифрованы при экспорте конфигурации решения.
8. Нажмите на кнопку Проверить соединение, чтобы посмотреть, устанавливается ли соединение с вебхуком.
9. Нажмите на кнопку Добавить, чтобы сохранить параметры интеграции с вебхуком.
Настроенную интеграцию вы можете использовать в политиках реагирования.
Просмотр и изменение информации об интеграции с вебхуками
Чтобы просмотреть и изменить интеграцию с вебхуком:
1. В разделе Администрирование → Интеграции → Уведомления на вкладке Вебхуки нажмите на ссылку на названии интеграции в списке интеграций.
2. В открывшемся окне редактирования при необходимости измените следующие параметры интеграции:
  - Название.
  - Полный веб-адрес для направления уведомлений.
  - Наличие ограничения на количество уведомлений в секунду, которое будет отправлять решение.
  - Способ авторизации.
  - Если вы меняете способ авторизации, укажите данные для авторизации для выбранного способа авторизации.
  - Если вы не меняете способ авторизации, вы можете изменить значения полей Пароль, Секрет и Токен API.
3. При необходимости внесите изменения в текст запроса в поле Данные в формате JSON.
4. Нажмите на кнопку Проверить соединение, чтобы посмотреть, устанавливается ли соединение с вебхуком.
5. Нажмите на кнопку Добавить.

Просмотр списка интеграций со средствами уведомления

Удаление интеграции со средством уведомления

Вам помогла эта статья?

Что нам нужно улучшить?

Спасибо за ваш отзыв, вы помогаете нам становиться лучше!