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

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

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

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

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

  3. Проверка соединения с Naumen

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

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

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

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

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

  2. Добавьте переменную, которая будет хранить ключ доступа (Access Key) к системе Naumen.

    Используется тот же ключ доступа, который был получен в системе Naumen на этапе ее настройки.

    Для этого:

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

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

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

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

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

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

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

      • Тип — String.

      • Значение переменной — ключ доступа к Naumen, полученный на этапе ее настройки.

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

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

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

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

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

  6. Введите название интеграции. Название может быть произвольным.

  7. Введите URL-адрес сервера Naumen.

  8. В поле Access Key выберите переменную с ключом доступа к Naumen, добавленную на шаге 2.

  9. В поле Описание введите шаблон описания задачи в R-Vision VM, создаваемой из уязвимости с помощью интеграции. Шаблон может включать следующие теги:

    • {{ГИТ}} — список групп ИТ-активов, в которых обнаружена уязвимость, через запятую.

    • {{countAssets}} — количество хостов, на которых обнаружена уязвимость.

      Пример использования шаблона описания задачи

      Пусть в поле Описание настроек интеграции задан следующий шаблон:

      Требуется устранить уязвимость, обнаруженную в следующих группах ИТ-активов: {{ГИТ}}. Всего затронуто хостов: {{countAssets}}.

      Пример описания задачи, созданной с помощью интеграции:

      Требуется устранить уязвимость, обнаруженную в следующих группах ИТ-активов: ГИТ 1, ГИТ 2, ГИТ 3. Всего затронуто хостов: 8.

  10. Если требуется создавать задачи в R-Vision VM из уязвимостей автоматически, установите переключатель Автоматическое создание Задачи из Уязвимости в активное положение.

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

  11. В поле Размер выборки оставьте значение по умолчанию.

    Значение этого поля определяет количество задач, обрабатываемых NATS за один раз. Менять значение не рекомендуется во избежание проблем с производительностью.

  12. Если активно автоматическое создание задач из уязвимостей (переключатель Автоматическое создание Задачи из Уязвимости установлен в активное положение), вы можете заполнить таблицу Критерии Уязвимости для создания Задачи, чтобы ограничить выборку уязвимостей, из которых будут создаваться задачи в R-Vision VM.

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

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

    • Если в таблице указан атрибут, которого нет в сущности уязвимости, запуск интеграции завершится с ошибкой.

    Строки таблицы заполняются следующим образом:

    • Тег поля — идентификатор атрибута уязвимости в системной схеме домена Уязвимости.

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

      Также можно оставить поле пустым. В таком случае критерий считается выполненным, если значение указанного атрибута уязвимости не заполнено.

    Пример заполнения таблицы Критерии Уязвимости для создания Задачи
    Тег поля Значение

    isTrending

    true

    componentos

    Windows 10; Windows 11; РЕД ОС; Astra Linux

    При такой настройке критериев задачи будут создаваться автоматически только для трендовых уязвимостей в ОС Windows 10, Windows 11, РЕД ОС или Astra Linux.

  13. Если активно автоматическое создание задач из уязвимостей (переключатель Автоматическое создание Задачи из Уязвимости установлен в активное положение), вы можете заполнить таблицу Критерии Задачи для создания Проблемы, чтобы ограничить выборку задач в R-Vision VM, из которых будут создаваться проблемы в Naumen.

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

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

    • Если в таблице указан атрибут, которого нет в сущности задачи, запуск интеграции завершится с ошибкой.

    Строки таблицы заполняются следующим образом:

    • Тег поля — идентификатор атрибута задачи в системной схеме домена Задачи.

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

      Также можно оставить поле пустым. В таком случае критерий считается выполненным, если значение указанного атрибута задачи не заполнено.

    Пример заполнения таблицы Критерии Задачи для создания Проблемы
    Тег поля Значение

    taskPriority

    Критический; Высокий

    serviceDeskLink

    При такой настройке критериев проблемы будут создаваться автоматически только для задач с критическим или высоким приоритетом, у которых отсутствует связанная задача или проблема во внешней системе Service Desk (ссылка на связанную задачу или проблему пустая).

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

    • ID прав. норм. "Оборудование → файл" — преобразование данных об оборудовании, на котором обнаружена уязвимость, для записи в файл формата XLSX, прикрепляемый к задаче.

    • ID прав. норм. "Уязвимость → файл" — преобразование данных о найденной уязвимости для записи в файл формата XLSX, прикрепляемый к задаче.

    • ID прав. норм. "БДУ → файл" — преобразование данных о найденной уязвимости в разделе Управление уязвимостями → База уязвимостей веб-интерфейса R-Vision VM, для записи в файл формата XLSX, прикрепляемый к задаче.

    • ID прав. норм. для "Создание проблемы в Naumen" — преобразование данных о задаче в R-Vision VM для создания проблемы в Naumen.

    • ID прав. норм. для "Синхронизация R-EVO → Naumen" — преобразование статуса задачи в R-Vision VM для его синхронизации со статусом проблемы в Naumen.

    • ID прав. норм. для "Синхронизация Naumen → R-EVO" — преобразование статуса проблемы в Naumen для его синхронизации со статусом задачи в R-Vision VM.

    Код правил нормализации, настроенных по умолчанию, можно просмотреть в разделе Экспертиза веб-интерфейса R-Vision VM.

    Инструкция по созданию и редактированию пользовательских правил нормализации для интеграции приведена в разделе Настройка правил нормализации для интеграций.

  15. В поле Группа воркеров укажите naumen_worker_group.

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

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

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

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

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

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

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

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

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

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

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

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

      • Каждый час;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Кнопка Проверить соединение с Naumen (check) позволяет проверить соединение.

  • ID вкладки интеграций — автоматически генерируемый идентификатор интеграции. Его необходимо указывать при ручном создании задачи или проблемы.

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

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

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

    • URL сервиса — URL-адрес сервера Naumen.

    • Access Key — имя переменной, которая хранит ключ доступа к Naumen.

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

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

    • Статус подключения — статус соединения с Naumen.

    • Детали подключения — детальная информация о результате последней проверки соединения: например, сообщение об ошибке.

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

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

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

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

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

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

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

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

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

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

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

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

      • Каждый час;

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

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

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

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

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

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

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

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

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

  • Размер выборки.

  • Критерии Уязвимости для создания Задачи.

  • Критерии Задачи для создания Проблемы.

  • Идентификаторы используемых правил нормализации:

    • ID прав. норм. "Оборудование → файл";

    • ID прав. норм. "Уязвимость → файл";

    • ID прав. норм. "БДУ → файл";

    • ID прав. норм. для "Создание проблемы в Naumen";

    • ID прав. норм. для "Синхронизация R-EVO → Naumen";

    • ID прав. норм. для "Синхронизация Naumen → R-EVO".

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

Вкладка Конфигурация содержит поле Группа воркеров — имя группы воркеров, на которой запускается интеграция — naumen_worker_group.

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

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

Проверка соединения с Naumen

Чтобы проверить соединение с Naumen, выполните следующие действия:

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

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

  3. Нажмите на кнопку Проверить соединение с Naumen (check). Система проверит соединение с Naumen и по итогам проверки заполнит следующие поля:

    • Статус подключения — статус соединения с Naumen.

    • Детали подключения — детальная информация о результате последней проверки соединения: например, сообщение об ошибке.

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

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

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

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

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

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

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

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