Управление интеграцией в R-Vision VM

Данный раздел содержит информацию об управлении интеграцией с Kaspersky Security Center в R-Vision VM. Работа осуществляется в разделах Ресурсы → Переменные и Настройки → Интеграции → Интеграции ИБ-активов веб-интерфейса R-Vision VM.

Доступные действия над интеграцией:

  1. Добавление интеграции

  2. Просмотр интеграции

  3. Изменение интеграции

  4. Удаление интеграции

Добавление интеграции

Чтобы добавить интеграцию R-Vision VM с KSC, выполните следующие действия:

  1. Перейдите в раздел Ресурсы → Переменные веб-интерфейса R-Vision VM.

  2. Добавьте переменную, которая будет хранить логин пользователя KSC. Для этого:

    1. Нажмите на кнопку Создать (plus). Отобразится окно создания переменной.

    2. Укажите следующие параметры переменной:

      • ID — произвольный.

      • Название — произвольное.

      • Организация — организация, в рамках которой будет работать интеграция.

      • Описание — произвольное.

      • Секрет — установите переключатель в активное положение.

      • Тип — String.

      • Значение переменной — логин пользователя в системе KSC, заданный на этапе ее настройки.

    3. Нажмите на кнопку Создать. Переменная будет создана и добавлена в список в разделе Ресурсы → Переменные. Система отобразит соответствующее уведомление.

  3. Аналогичным образом добавьте переменную, которая будет хранить пароль пользователя KSC.

  4. Перейдите в раздел Настройки → Интеграции → Интеграции ИБ-активов веб-интерфейса R-Vision VM.

  5. Нажмите на кнопку plus и выберите из выпадающего списка опцию Интеграция с KSC. Отобразится окно создания интеграции.

  6. Выберите из выпадающего списка организацию, в которой будет работать интеграция.

    Организация должна совпадать с организацией, в которой созданы переменные для логина и пароля пользователя KSC.

  7. Введите произвольное название интеграции.

  8. Введите полное доменное имя (FQDN) или IP-адрес сервера KSC.

  9. В поле Логин выберите переменную с логином пользователя KSC, добавленную на шаге 2.

  10. В поле Пароль выберите переменную с паролем пользователя KSC, добавленную на шаге 3.

  11. Если порт, по которому выполняются запросы к KSC, отличается от 13299, укажите его номер в поле Порт.

  12. В поле Протокол выберите протокол, по которому будет осуществляться обмен данными между R-Vision VM и KSC. Доступные варианты:

    • HTTP;

    • HTTPS.

  13. Если требуется импортировать из KSC дополнительные атрибуты сущностей, добавьте их идентификаторы в нижеуказанные таблицы. Идентификаторы доступных атрибутов можно просмотреть в официальной документации KSC.

    Таблица Атрибуты KSC

    Дополнительные атрибуты оборудования

    support.kaspersky.com/help/KSC/14.2/KSCAPI/a00011.html

    Дополнительные атрибуты уязвимостей

    support.kaspersky.com/help/KSC/14.2/KSCAPI/a00359.html

    Дополнительные атрибуты технических характеристик оборудования

    support.kaspersky.com/help/KSC/14.2/KSCAPI/a00310.html

    Дополнительные атрибуты обновлений

    support.kaspersky.com/help/KSC/14.2/KSCAPI/a00357.html

    Дополнительные атрибуты учетных записей

    support.kaspersky.com/help/KSC/14.2/KSCAPI/a00187.html

  14. Установите переключатели напротив тех сущностей, данные о которых требуется импортировать из KSC, кроме включенного оборудования:

    • Отключенные устройства;

    • Технические характеристики;

    • ПО;

    • ПО Kaspersky;

    • Обновления Windows;

    • Учетные записи;

    • Уязвимости.

  15. Чтобы импортировать информацию обо всех активах и уязвимостях вне зависимости от того, когда они были созданы или изменены в KSC, установите переключатель Игнорировать дату последнего запуска. Если переключатель не установлен, импортируются только данные, созданные или измененные с момента предыдущего запуска интеграции.

    Если установлен переключатель Игнорировать дату последнего запуска, время импорта информации об активах и уязвимостях может значительно увеличиться. Выбор этой опции предполагает импорт из KSC всей информации независимо от того, когда интеграция запускалась в последний раз. Не рекомендуется использовать эту опцию в штатном режиме работы интеграции.

  16. В поле Фильтр по оборудованию укажите параметры фильтрации узлов, полученных через интеграцию, согласно следующим правилам:

    • Доступны следующие атрибуты фильтра:

      • KLHST_WKS_IP_LONG — IP-адрес в формате десятичного числа без разделения на октеты. Например, IP-адрес 10.99.101.200 указывается как 174286280.

      • KLHST_WKS_DN — имя устройства.

    • Доступны следующие операторы:

      • = — равно;

      • > — больше;

      • < — меньше;

      • <> — не равно

      • & — логическое И;

      • | — логическое ИЛИ;

      • ! — логическое НЕ.

    • Значения атрибутов указываются в кавычках. Например:

      (KLHST_WKS_IP_LONG = "174286280")
      (KLHST_WKS_DN = "DRWEBESS01")

    • Оператор отрицания ! указывается перед названием атрибута. Например:

      (!KLHST_WKS_DN = "DRWEBESS01")

    • Операторы логического И & и ИЛИ | указываются перед операндами, на которые они действуют. Примеры:

      Использование оператора & в фильтре по диапазону IP
      (&(KLHST_WKS_IP_LONG >= "174286280")(KLHST_WKS_IP_LONG <= "174286328"))
      Использование оператора | в фильтре по IP-адресу и имени устройства
      (|(KLHST_WKS_IP_LONG = "174286297")(KLHST_WKS_DN = "DRWEBESS01"))
    Подробная информация о синтаксисе фильтра представлена в официальной документации KSC.

  17. В таблице Фильтр по группам оборудования укажите имена групп, по которым будут фильтроваться узлы:

    • Если указать только имя группы (например, group), будут импортированы узлы из этой группы.

    • Если указать имя группы с символами подстановки /* (например, group/*), будут импортированы узлы из этой группы и всех вложенных подгрупп.

    • Если указать несколько групп в нескольких строках таблицы, будут импортированы узлы из всех этих групп и их подгрупп, если используются символы подстановки.

    • Если не заполнять таблицу Фильтр по группам оборудования, будут импортированы узлы из всех групп.

  18. В поле Тип источника данных оставьте значение по умолчанию.

  19. В поле Группа воркеров укажите ksc_worker_group.

  20. В поле Пагинация введите максимальное количество объектов, выгружаемых системой из NATS и передаваемых в плейбук load за один раз.

    Значение поля Пагинация влияет только на количество объектов, одновременно обрабатываемых внутри системы. На количество объектов, выгружаемых из внешней системы, этот параметр не влияет.

  21. В поле Задержка отправки запросов введите интервал в секундах между повторными запросами к внешней системе, если запрос к ней завершился с ошибкой.

  22. В поле Число повторных попыток отправки данных введите максимальное количество повторных запросов к внешней системе, если запрос к ней завершился с ошибкой.

    Если достигнуто максимальное число повторных попыток отправки данных и все эти попытки завершились с ошибкой, запуск интеграции также будет прерван с ошибкой.

  23. В таблицах Правила нормализации и Правила связывания оставьте содержимое по умолчанию.

  24. Чтобы настроить расписание запуска интеграции, установите переключатель Запуск по расписанию в активное положение и выполните действия ниже.

  25. Выберите часовой пояс из выпадающего списка.

  26. Выберите формат расписания, на основании которого будет запускаться интеграция. Доступные форматы:

    • Cron-выражение;

    • Расписание.

  27. Если была выбрана опция Cron-выражение, задайте cron-выражение для запуска интеграции по расписанию.

    Указанное cron-выражение задает расписание для триггера, по которому выполняется интеграция. Вы можете ознакомиться с синтаксисом cron-выражений в разделе Работа с автоматизациями.

  28. Если была выбрана опция Расписание, выполните следующие шаги:

    1. Выберите режим запуска интеграции из выпадающего списка Запускать. Доступные режимы:

      • Каждый месяц;

      • Каждую неделю;

      • Каждый день;

      • Каждый час;

      • Каждую минуту.

    2. Если выбран режим запуска Каждый месяц, укажите следующие параметры:

      1. Интервал между запусками в месяцах.

      2. Дни месяца, в которые будет выполняться запуск, через запятую. Например: 1, 5, 10, 15, 20, 25, 30.

    3. Если выбран режим запуска Каждую неделю, выберите из выпадающего списка день недели, в который будет запускаться интеграция.

    4. Если выбран режим запуска Каждый день, Каждый час или Каждую минуту, укажите интервал между запусками в днях, часах или минутах соответственно.

    5. Если выбран любой режим запуска, кроме Каждую минуту, выберите интервал времени, в который будет запускаться интеграция.

      Доступны интервалы в 15 минут с 00:00 до 23:59.

  29. Нажмите на кнопку Добавить. Система создаст интеграцию и отобразит уведомление об успешном создании.

Просмотр интеграции

Чтобы просмотреть настройки интеграции:

  1. Перейдите в раздел Настройки → Интеграции → Интеграции ИБ-активов веб-интерфейса R-Vision VM. Система отобразит список существующих интеграций.

  2. Нажмите на строку интеграции в списке. Система отобразит в правой части экрана карточку этой интеграции с подробной информацией о ней.

В верхней части карточки отображается название интеграции. Справа от названия расположена кнопка more vertical, при нажатии на которую открывается выпадающее меню с действиями, доступными для выбранной интеграции.

Карточка интеграции содержит следующие вкладки:

  • Основное — основная информация об интеграции.

  • Расширенные параметры — дополнительные атрибуты, импортируемые из KSC, правила нормализации и связывания.

  • История — история изменений интеграции.

  • Конфигурация — тип источника данных и группа воркеров интеграции, а также настройки интенсивности обработки импортируемых объектов.

Вкладка Основное

На вкладке Основное отображаются основные сведения об интеграции и элементы управления ей:

  • Кнопка Запустить (play) позволяет запустить интеграцию вручную.

  • Организация — организация, в рамках которой работает интеграция.

  • Название — название интеграции.

  • Статус — статус последнего запуска интеграции:

    • Успешно;

    • Ошибка;

    • В процессе;

    • Отменена.

  • Секция Параметры подключения:

    • Адрес сервера — адрес сервера KSC.

    • Логин — имя переменной, которая хранит логин пользователя KSC.

    • Пароль — имя переменной, которая хранит пароль пользователя KSC.

    • Порт — номер порта, по которому осуществляется обмен данными между R-Vision VM и KSC.

    • Протокол — протокол, по которому осуществляется обмен данными между R-Vision VM и KSC:

      • HTTP;

      • HTTPS.

  • Секция Параметры импорта:

    • Отключенные устройства — поле, которое показывает, импортируются ли данные об отключенных устройствах.

    • Технические характеристики — поле, которое показывает, импортируются ли данные о технических характеристиках устройств.

    • ПО — поле, которое показывает, импортируются ли данные о ПО.

    • ПО Kaspersky — поле, которое показывает, импортируются ли данные о ПО Kaspersky.

    • Обновления Windows — поле, которое показывает, импортируются ли данные об обновлениях Windows.

    • Учетные записи — поле, которое показывает, импортируются ли данные об учетных записях.

    • Уязвимости — поле, которое показывает, импортируются ли данные об уязвимостях.

    • Игнорировать дату последнего запуска — поле, которое показывает, импортируются ли только данные, изменившиеся с последнего запуска интеграции, или все данные.

    • Фильтр по оборудованию — фильтр списка оборудования согласно правилам фильтрации KSC.

    • Фильтр по группам оборудования — таблица групп и подгрупп оборудования, данные о котором импортируются из KSC.

  • Секция Расписание:

    • Запуск по расписанию — определяет, происходят ли запуски интеграции по заданному расписанию.

    • Часовой пояс — часовой пояс для времени запуска интеграции.

    • Формат расписания — формат расписания для запуска интеграции. Доступные форматы:

      • Cron-выражение;

      • Расписание.

    • Cron-выражение — cron-выражение для запуска интеграции по расписанию.

      Данное поле отображается, только если в поле Формат расписания выбрана опция Cron-выражение.
      Указанное cron-выражение задает расписание для триггера, по которому выполняется интеграция. Вы можете ознакомиться с синтаксисом cron-выражений в разделе Работа с автоматизациями.

    • Запускать — режим запуска интеграции. Доступные значения:

      • Каждый месяц;

      • Каждую неделю;

      • Каждый день;

      • Каждый час;

      • Каждую минуту.

      Это и все последующие поля отображаются, только если в поле Формат расписания выбрана опция Расписание.

    • Интервал повторения — количество единиц времени между последовательными запусками интеграции.

    • Дни повторения (через запятую) — дни месяца, в которые будет выполняться запуск, через запятую. Отображается только для режима запуска Каждый месяц.

    • День недели — день недели, в который будет запускаться интеграция. Отображается только для режима запуска Каждую неделю.

    • Время запуска — время, в которое инициируется выполнение интеграции. Отображается для всех режимов запуска, кроме Каждую минуту.

      Доступны интервалы в 15 минут с 00:00 до 23:59.

Вкладка Расширенные параметры

Вкладка Расширенные параметры содержит дополнительные параметры интеграции:

  • Таблицы дополнительных атрибутов, импортируемых из KSC:

    • Дополнительные атрибуты оборудования;

    • Дополнительные атрибуты уязвимостей;

    • Дополнительные атрибуты технических характеристик оборудования;

    • Дополнительные атрибуты обновлений;

    • Дополнительные атрибуты учетных записей.

  • Таблица Правила нормализации.

  • Таблица Правила связывания.

Вкладка История

Вкладка История отображает сведения о запусках интеграции, а также об изменениях ее настроек.

Вкладка Конфигурация

Вкладка Конфигурация содержит следующие поля:

  • Тип источника данных — в текущей версии интеграции всегда имеет значение integrationKSC.

  • Группа воркеров — группа воркеров, на которой запускается интеграция — ksc_worker_group.

  • Пагинация — максимальное количество объектов, выгружаемых системой из NATS и передаваемых в плейбук load за один раз.

  • Задержка отправки запросов — интервал в секундах между повторными запросами к внешней системе, если запрос к ней завершился с ошибкой.

  • Число повторных попыток отправки данных — максимальное количество повторных запросов к внешней системе, если запрос к ней завершился с ошибкой.

Изменение интеграции

Вы можете изменить интеграцию следующими способами:

Удаление интеграции

Вы можете удалить интеграцию следующими способами:

Была ли полезна эта страница?

+7 (499) 755 55 70 sales@rvision.ru

О компании Пользовательское соглашение Политика cookies

Обратная связь