Пользовательские сценарии работы с интеграцией с Jira

Автоматическое создание задач в R-Vision VM из уязвимостей

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

  1. Проверяются уязвимости, созданные в разделе Управление уязвимостями → Уязвимости с момента последнего запуска интеграции.

  2. Над каждой из уязвимостей, для которых нет связанных задач в разделе Задачи, выполняются следующие действия:

    • Название — идентификатор уязвимости, для устранения которой создается задача.

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

    • Документы — файлы в формате XLSX с данными об уязвимости, связанном с ней оборудовании, а также информацией о ней в базе данных уязвимостей.

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

  3. Ссылка на задачу добавляется в соответствующее поле уязвимости.

Автоматическое создание задач в Jira из задач в R-Vision VM

Если в настройках интеграции установлен переключатель Создавать/Закрывать задачи, то при запусках интеграции по расписанию она создает задачи в Jira из задач в R-Vision VM согласно следующей логике:

  1. Проверяются задачи, созданные в разделе Задачи с момента последнего запуска интеграции. Выбираются задачи, у которых есть связанные уязвимости, но нет связанных задач в Jira.

  2. Для каждой из задач в выборке создается задача в Jira со следующими параметрами:

    • Название — название задачи в R-Vision VM.

    • Исполнитель — исполнитель задачи в R-Vision VM.

    • Приоритет — приоритет в соответствии с маппингом в правиле нормализации, заданном в поле ID прав. норм. для "Создание Задачи в Jira" настроек интеграции.

    • Вложения — файлы с информацией об уязвимости и связанном с ней оборудовании из поля Документы задачи в R-Vision VM.

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

  3. Ссылка на задачу в R-Vision VM добавляется в соответствующее поле задачи в Jira.

  4. Ссылка на задачу в Jira добавляется в поле Ссылка в SD задачи в R-Vision VM.

Создание задач из уязвимостей вручную

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

  1. Выберите уязвимости, для которых требуется создать задачу, и откройте окно создания задачи согласно инструкции в разделе Уязвимости.

  2. Укажите параметры запуска интеграции:

    • task_domain_id — идентификатор домена Задачи в разделе Ресурсы → Домены веб-интерфейса R-Vision VM.

    • task_entity_id — идентификатор сущности Задача в схеме домена Задачи.

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

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

    • vrl_vulndb — идентификатор правила нормализации, преобразующего данные о найденной уязвимости в разделе Управление уязвимостями → База уязвимостей для записи в файл формата XLSX. Совпадает со значением поля ID прав. норм. "БДУ → файл" настроек интеграции.

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

  3. Нажмите на кнопку Создать задачу. В разделе Задачи создастся задача со следующими параметрами:

    • Название — идентификатор уязвимости, для устранения которой создается задача.

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

    • Документы — файлы в формате XLSX с данными об уязвимости, связанном с ней оборудовании, а также информацией о ней в базе данных уязвимостей.

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

  4. Если в настройках интеграции установлен переключатель Создавать/Закрывать задачи, в Jira будет создана задача, связанная с созданной задачей, со следующими параметрами:

    • Название — название задачи в R-Vision VM.

    • Исполнитель — исполнитель задачи в R-Vision VM.

    • Приоритет — приоритет в соответствии с маппингом в правиле нормализации, заданном в поле ID прав. норм. для "Создание Задачи в Jira" настроек интеграции.

    • Вложения — файлы с информацией об уязвимости и связанном с ней оборудовании из поля Документы задачи в R-Vision VM.

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

  5. Ссылка на задачу в R-Vision VM добавляется в соответствующее поле задачи в Jira.

  6. Ссылка на задачу в Jira добавляется в поле Ссылка в SD задачи в R-Vision VM.

Создание задач Jira из задач R-Vision VM вручную

Отображение опции Создать задачу в Jira в выпадающем меню кнопки действий more vertical в карточке задачи определяется строкой action: actions.playbookJIRATask в схеме домена tasks.rvision.ru. Убедитесь, что строка раскомментирована.

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

  1. Перейдите в раздел Задачи веб-интерфейса R-Vision VM.

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

  3. Выберите опцию Создать задачу в Jira в выпадающем меню кнопки действий more vertical в верхней части карточки. Отобразится окно создания задачи в системе Jira.

  4. Укажите параметры запуска интеграции:

    • url — URL-адрес сервера Jira. Совпадает со значением поля URL Jira настроек интеграции.

    • token — API-токен пользователя Jira.

    • login — логин пользователя Jira.

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

      Можно заполнить либо поле token, либо поля login и password в зависимости от того, какой метод авторизации использует ваш сервер Jira.

    • vuln_domain_id — идентификатор домена Управление уязвимостями → Уязвимости в разделе Ресурсы → Домены веб-интерфейса R-Vision VM.

    • vrl_create_jira_task — идентификатор правила нормализации, преобразующего данные о задаче в R-Vision VM для создания задачи в Jira. Совпадает со значением поля Имя прав. норм. для "Создание Задачи в Jira" настроек интеграции.

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

  5. Нажмите на кнопку Создать задачу в Jira. В Jira будет создана задача, связанная с задачей в R-Vision VM. Задача будет иметь следующие параметры:

    • Название — название задачи в R-Vision VM.

    • Исполнитель — исполнитель задачи в R-Vision VM.

    • Приоритет — приоритет в соответствии с маппингом в правиле нормализации, заданном в поле ID прав. норм. для "Создание Задачи в Jira" настроек интеграции.

    • Вложения — файлы с информацией об уязвимости и связанном с ней оборудовании из поля Документы задачи в R-Vision VM.

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

  6. Ссылка на задачу в R-Vision VM добавляется в соответствующее поле задачи в Jira.

  7. Ссылка на задачу в Jira добавляется в поле Ссылка в SD задачи в R-Vision VM.

Синхронизация статусов задач в R-Vision VM и в Jira

В рамках запусков по расписанию интеграция выполняет синхронизацию статусов связанных задач в R-Vision VM и проблем в Jira. Маппинг статусов задач и проблем определяется следующими правилами нормализации в настройках интеграции:

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

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

Автоматическое закрытие задач в R-Vision VM и Jira при закрытии уязвимости

Если в настройках интеграции установлен переключатель Создавать/Закрывать задачи, то интеграция выполняет следующие действия при переходе уязвимости в статус Закрыта:

  1. Все задачи, связанные с уязвимостью, переходят в статус Завершено.

  2. Если с завершенными задачами связаны задачи в Jira, они переходят в статус, связанный со статусом Завершено в R-Vision VM. Связи статусов определяются маппингом, заданным правилом нормализации ID прав. норм. для "Синхронизация R-EVO → Jira".

При завершении всех связанных задач уязвимость не закрывается автоматически.

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

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

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

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