Сканирование файла
При необходимости сканирования отдельного манифеста внутри директории можно использовать команду scan file.
При запуске агент:
- Идентифицирует формат указанного файла и производит разбор содержимого.
- Формирует запрос к платформе для анализа содержимого.
- После получения результатов отображает общую информацию о найденных манифестах, зависимостях, уязвимостях и сработавших политиках.
- Дополнительно в текущей директории создается файл
bom.json, содержащий полный Software Bill of Materials в формате CycloneDX.
В зависимости от параметров запуска агент возвращает соответствующий exit code:
- 0 – успешное сканирование, проблемы не были выявлены;
- 1 – в результате сканирования найдены проблемы, соответствующие настроенным политикам безопасности, необходимо действие пользователя;
- 2 – ошибка сканирования;
- 3 – пустой результат, не были найдены артефакты для анализа. Возвращается только если параметр
--block-on-empty-resultимеет значениеtrue.
Пример запуска команды
Для сканирования только одного файла без обработки вложенных директорий или других манифестов, необходимо указать путь к файлу при запуске команды.
Параметры команды
Команда scan file имеет три уникальных параметра, помимо общих настроек команды сканирования:
--branch-or-tag– ссылка на ветку или тег репозитория в формате^refs/(heads|tags)/.+(например,refs/tags/v1.0);--commit– указание хэша коммита;--parser– используемый парсер.
Для сводки доступных параметров команды и инструкции по использованию можно вызвать команду с флагом -h, --help.
Доступные парсеры
Страница была полезна?
