Перейти к основному содержимому
Версия: v1.0.x

Dependency Track

Для того, чтобы запускать сканирования Dependency Track из Шерлока необходимо настроить взаимосвязь между проектом в Шерлоке и проектом в Dependency Track.
После этого функционал запуска сканирования будет доступен на странице с таблицей ИБ-дефектов.

к сведению

Соотношение проектов настраивается для конкретных веток. Запустить сканирование ветки, для которой отсутствует настройка не получится.
Таким образом, для запуска сканирования main и develop веток из Шерлока необходимо использовать несколько проектов Dependency Track.

Подготовительная работа​

Перед тем, как настраивать взаимосвязь между проектом Шерлока и проектом Dependency Track необходимо убедиться, что настройка системная интеграция между Шерлоком и Dependency Track.

Подключение проекта Dependency Track​

Допускается использовать как существующие проекты Dependency Track для анализа, так и создавать новые проекты в сканере непосредственно из Шерлока.

Создание проекта в Dependency Track из Шерлока​

  1. Для создания проекта в Dependency Track из Шерлока необходимо, находясь в проекте, перейти в его настройки () и выбрать раздел Сканирование в SCM.

  2. Найти необходимую интеграцию с Dependency Track в разделе Можно подключить и нажать кнопку Подключить.

  3. Выбрать вариант Новый проект в сканере.

  4. Заполнить необходимые параметры в открывшемся окне:

    • Название проекта: название проекта, который будет создан в CodeScoring

    • Ветка: ветка проекта, которую необходимо проанализировать

    • SBoM-файл: файл формата CycloneDX до 30 МБ

      к сведению

      Рекомендуется использовать версию CycloneDX, поддерживаемую версией Dependency Track.

  5. Нажать кнопку Подключить. В случае успеха Шерлок оповестит о том, что подключение настроено и можно продолжать работу.

Использование существующего проекта Dependency Track​

  1. Для использования существующего проекта в Dependency Track из Шерлока необходимо, находясь в проекте, перейти в его настройки () и выбрать раздел Сканирование в SCM.

  2. Найти необходимую интеграцию с Dependency Track в разделе Можно подключить и нажать кнопку Подключить.

  3. Выбрать вариант Существующий.

  4. Заполнить необходимые параметры в открывшемся окне:

    • ProjectID или ссылка на проект в DepTrack: ссылка на проект или уникальный идентификатор проекта в Dependency Track
    • Ветка: ветка проекта, которую необходимо проанализировать

  5. Нажать кнопку Подключить. В случае успеха Шерлок оповестит о том, что подключение настроено и можно продолжать работу.

Изменение подключения​

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

    к сведению

    При изменении подключения можно указать альтернативную ссылку на проект или уникальный идентификатор проекта в Dependency Track, а также анализируемую ветку.

  2. Нажать кнопку Сохранить после внесения необходимых изменений. В случае успеха Шерлок оповестит о том, что подключение изменено и можно продолжать работу.

Удаление подключения​

  1. Для удаления подключения необходимо нажать на иконку удаления (), расположенную рядом с подключением, которое необходимо удалить.

  2. В открывшейся форме нажать на кнопку Отключить. В случае успеха Шерлок оповестит о том, что подключение удалено и можно продолжать работу.

    внимание

    Сканирование в SCM с использованием Dependency Track для конкретной ветки, что была использована при настройке подключения, будет невозможно в случае отключения подключения.

Запуск сканирования​

Для запуска сканирования Dependency Track необходимо, находясь в таблице ИБ-дефектов проекта, нажать кнопку Сканировать и выбрать Dependency Track (SCA) из предложенных вариантов.