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

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

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

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

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

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

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

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

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

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

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

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

    Для этого:

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

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

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

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

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

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

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

      • Тип — String.

      • Значение переменной — токен API, созданный в системе Jira на этапе ее настройки.

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

  3. Если вы планируете использовать авторизацию в Jira по логину и паролю, добавьте переменные, которые будут хранить логин пароль пользователя Jira. Параметры переменных задайте аналогично параметрам переменной для токена, приведенным на шаге 2.

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

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

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

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

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

  8. Введите URL-адрес сервера Jira.

    Можно использовать только доменное имя сервера Jira. Отправка запросов к Jira по IP-адресу не поддерживается.

  9. Если вы используете авторизацию в Jira по токену, в поле Токен Jira выберите переменную с токеном, добавленную на шаге 2.

  10. Если вы используете авторизацию в Jira по логину и паролю, в полях Логин Jira и Пароль Jira выберите переменные с логином и паролем, добавленные на шаге 3.

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

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

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

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

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

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

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

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

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

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

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

  13. В поле Группа воркеров укажите jira_vm_worker_group.

  14. В поле Название stream в шине для записи данных файла оставьте значение по умолчанию.

  15. Если требуется создавать задачи в R-Vision VM из уязвимостей и закрывать их автоматически, установите переключатель Создавать/Закрывать задачи в активное положение.

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

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

  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, при нажатии на которую открывается выпадающее меню с действиями, доступными для выбранной интеграции.

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

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

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

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

  • Конфигурация — группа воркеров и идентификатор стрима в шине интеграции.

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

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

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

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

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

    • URL Jira — URL-адрес сервера Jira.

    • Токен Jira — имя переменной, которая хранит API-токен Jira.

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

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

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

    • Создавать/Закрывать задачи — определяет, происходит ли создание и закрытие задач в Jira автоматически.

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

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

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

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

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

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

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

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

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

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

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

      • Каждый час;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • ID прав. норм. для "Создание Задачи в Jira";

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

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

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

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

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

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

  • Группа воркеров — имя группы воркеров, на которой запускается интеграция — jira_vm_worker_group;

  • Название stream в шине для записи данных файла — имя стрима в NATS, через который передаются данные файлов, прикрепляемых к задачам.

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

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

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

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

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

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

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

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