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. Заполнить необходимые параметры в открывшемся окне:

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

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

   • 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) из предложенных вариантов.