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

Solar appScreener

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

к сведению

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

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

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

Подключение проекта Solar appScreener

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

Создание проекта в Solar appScreener из Шерлока

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

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

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

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

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

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

      к сведению

      После создания проекта Solar appScreener автоматически начнет сканирование, что обусловлено логикой работы сканера.

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

Использование существующего проекта Solar appScreener

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

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

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

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

    • ProjectID или ссылка на проект в appScreener: ссылка на проект или уникальный идентификатор проекта в Solar appScreener

      внимание

      При использование существующего проекта убедитесь, что в его настройках явно указан параметр Ветка в репозитории Git.
      Для этого в проекте Solar appScreener необходимо перейти в Настройки -> Общие -> Настройки репозитория Git.
      Если параметр Ветка в репозитории Git не будет указан явно, при запуске сканирования из Шерлока будет возвращена ошибка.

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

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

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

    к сведению

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

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

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

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

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

    внимание

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

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

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

Отмена сканирования

  1. Для отмены сканирования Solar appScreener необходимо, находясь в таблице ИБ-дефектов проекта, нажать кнопку Сканировать, найти запущенное сканирование Solar appScreener (SAST) и нажать на иконку отмены ().

  2. Указать причину отмены сканирования в открывшемся окне.

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