Настройка через конфигурационный файл
Управлять параметрами консольного агента можно через добавление файла конфигурации codescoring-johnny-config.yaml в директорию с агентом. Ниже представлен список доступных параметров и пример конфиг-файла.
Список параметров
Параметры композиционного анализа
- project – название проекта в платформе CodeScoring;
- save-results – сохранение результатов в платформе CodeScoring. Используется в паре с названием проекта. Значение по умолчанию –
false; - license – лицензия анализируемого проекта, например
mit; - stage – этап разработки. Возможные значения:
build,dev,source,stage,test,prod,proxy; - bom-path – путь (с названием файла), по которому будет сохраняться сформированный файл
bom.json; - bom-format – формат формируемого SBOM. Возможные значения:
cyclonedx_v1_6_json,cyclonedx_v1_5_json,cyclonedx_v1_4_json,cyclonedx_v1_6_ext_json,cyclonedx_v1_7_json. Значение по умолчанию:cyclonedx_v1_6_json; - timeout – ограничение по времени ожидания анализа (в секундах);
- 2024.52.0 branch-or-tag – ссылка на ветку репозитория или тег, например
refs/tags/v1.0(для командscan dirиscan file); - 2024.52.0 commit – хэш коммита в системе контроля версий (для команд
scan dirиscan file); - 2024.52.0 hash – хэш образа (для команды
scan image); - 2025.7.0 cloud-resolve – использование разрешения зависимостей в облаке. По умолчанию значение
false.
Общие параметры сканирования
- ignore – директории, которые будут игнорироваться при сканировании;
- no-summary – скрытие сводной информацию по проведенному сканированию в консоли. По умолчанию значение
false; - only-hashes – поиск только прямых включений Open Source библиотек по хэшам. По умолчанию значение
false; - with-hashes – поиск прямых включений Open Source библиотек по хэшам. По умолчанию значение
false; - no-recursion – выключение рекурсивного скана для команды
scan dir. По умолчанию значениеfalse; - block-on-empty-result – блокирование сборки при получении пустого результата. При активации агент возвращает exit code 3 в случае отсутствия артефактов для анализа;
- 2026.20.0 include-envs – включение в результат только указанных окружений зависимостей, через запятую, например
compile,runtime. Взаимоисключается сexclude-envs; - 2026.20.0 exclude-envs – исключение указанных окружений зависимостей из результата, через запятую, например
test,dev. Взаимоисключается сinclude-envs.
Параметры сканирования Docker-образов
- scan-files – сканирование файловой системы внутри образа. По умолчанию значение
false; - insecure-skip-tls-verify – пропуск TLS верификации при подключении к реестру образов. По умолчанию значение
false; - insecure-use-http – использование протокола http при подключении к реестру образов. По умолчанию значение
false; - registries – список конфигураций для подключения к нескольким реестрам образов. Каждый элемент списка может содержать:
- authority – URL реестра (например,
docker.io,localhost:5000); - login – имя пользователя для подключения к реестру;
- password – пароль для подключения к реестру;
- token – токен для подключения к реестру. Взаимоисключается с параметрами
loginиpassword.
- authority – URL реестра (например,
Параметры сканирования сборки C и C++
- build-result – флаг, указывающий, что входными данными являются результаты предыдущей сборки, включая скомпилированные артефакты. По умолчанию значение
false; - lib-versions – путь к JSON-файлу со списком версий анализируемых библиотек;
- output – путь к файлу, в который будут сохранены результаты анализа сборки;
- unresolved-file – путь к файлу, в который будет сохранена информация о библиотеках с неразрешёнными версиями.
Параметры парсинга для разных технологий
Общие параметры
- enabled – включение парсеров для данной технологии;
- parsers – набор парсеров для манифестов.
Параметры парсеров
- enabled – включение данного парсера;
- match – условие для определения подходящих манифестов, может быть по названию (
equal) или расширению (extension); - properties – дополнительные свойства для парсеров окружения, такие как путь к исполняемым файлам;
- dotnet-path, maven-path, gradle-path, yarn-path, go-path, sbt-path, npm-path, pnpm-path, composer-path, pip-path, poetry-path, conda-lock-path – пути к пакетным менеджерам для разрешения зависимостей в окружении;
- 2026.20.0 pdm-path – путь к
pdmдля разрешения зависимостей в окружении; - 2025.45.0 pipdeptree-path – путь к
pipdeptreeдля разрешения зависимостей в окружении; - 2026.3.0 bun-path – путь к
bunдля разрешения зависимостей в окружении; - 2025.45.0 uv-path – путь к
uvдля разрешения зависимостей в окружении; - 2025.13.0 swift-path – путь к
swiftдля разрешения зависимостей в окружении; - resolve-enabled – разрешение зависимостей в окружении. По умолчанию значение
false; - dotnet-args, gradle-args, maven-args, sbt-args, npm-args, yarn-args, pnpm-args, composer-args, pip-args, poetry-args, conda-args – аргументы для передачи соответствующим пакетным менеджерам при разрешении зависимостей в окружении;
- 2026.20.0 pdm-args – аргументы для передачи
pdmпри разрешении зависимостей в окружении; - 2025.45.0 pipdeptree-args – аргументы для передачи
pipdeptreeпри разрешении зависимостей в окружении; - 2026.3.0 bun-args – аргументы для передачи
bunпри разрешении зависимостей в окружении; - 2025.45.0 uv-args – аргументы для передачи
uvпри разрешении зависимостей в окружении; - 2025.13.0 swift-args – аргументы для передачи
swiftпри разрешении зависимостей в окружении; - configuration – конфигурация для парсера
gradle-dependency-tree_txt; - depth – глубина парсинга для парсера
jar. По умолчанию значение1; - python-version – версия Python, используемая для разрешения зависимостей в окружении.
Параметры сканирования архивов
- scan – сканирование архивов. По умолчанию значение
false; - depth – глубина сканирования архивов. По умолчанию значение
1.
Параметры вывода результатов
- 2023.48.0 format – формат вывода найденных уязвимостей. По умолчанию
coloredtable. Возможна выгрузка в форматыtable,text,junit,sarif,csv,gl-dependency-scanning-report,gl-code-quality-report; - 2023.48.0 group-vulnerabilities-by – переменная для группировки уязвимостей в таблице;
- 2023.48.0 sort-vulnerabilities-by – порядок переменных для сортировки уязвимостей в таблице;
- 2025.29.0 alerts-format – формат вывода отчёта по срабатываниям политик. Поддерживаются форматы:
coloredtable,table,text,json,csv. Значение по умолчанию –coloredtable.
Параметры платформы
- api_url – адрес платформе;
- api_token – токен для доступа к платформе;
- 2026.3.0 localization — язык локализации вывода CLI. Возможные значения:
en,ru. Значение по умолчанию —en.
Параметры запуска поиска секретов
- 2025.13.0 gitleaks-path – путь к исполняемому файлу gitleaks, который будет использоваться при сканировании;
- 2025.13.0 gl-secrets-report – включение формирования отчета о найденных секретах в формате GitLab. По умолчанию
false; - 2025.13.0 gl-secrets-report-filename – имя формируемого файла для отчета в формате GitLab. По умолчанию
gl-secrets-report.json.
Параметры инструмента поиска секретов Gitleaks
- 2025.13.0 baseline-path – путь к baseline файлу отчета gitleaks. Все обнаруженные ранее секреты, зафиксированные в этом файле, будут проигнорированы при повторном сканировании;
- 2025.13.0 enable-rule – список ID правил, которые будут включены при сканировании;
- 2025.13.0 gitleaks-ignore-path – путь к файлу .gitleaksignore или директории, содержащей его. По умолчанию
.(текущая директория); - 2025.13.0 ignore-gitleaks-allow – игнорирование комментариев gitleaks:allow. По умолчанию
false; - 2025.13.0 log-level – уровень логирования. Возможные значения:
trace, debug, info, warn, error, fatal. По умолчаниюinfo; - 2025.13.0 max-decode-depth – максимальная глубина рекурсивного декодирования. Значение
0отключает декодирование; - 2025.13.0 max-target-megabytes – максимальный размер файлов (в мегабайтах), которые будут обрабатываться. Файлы, превышающие этот размер, будут пропущены. По умолчанию 0 (ограничение отсутствует);
- 2025.13.0 no-banner – отключение баннера gitleaks при запуске. По умолчанию
false; - 2025.13.0 no-color – отключение цветного вывода для подробного (verbose) режима. По умолчанию
false; - 2025.13.0 redact – маскирование найденных секретов в логах и консоли. Значение 0 полностью отображает секреты, 100 – полностью скрывает. Можно задать промежуточное значение, например, 20 (маскирует 20% секрета). По умолчанию
0; - 2025.13.0 verbose – включение подробного (verbose) вывода при сканировании. По умолчанию
false.
Пример файла
Приоритет настроек
Поскольку параметры запуска агента можно настроить несколькими способами, при одновременном использовании двух и более способов агент будет принимать параметры в следующем порядке приоритетов:
- Значение команды scan-technology (если она используется);
- Значение флага команды;
- Значение переменной окружения;
- Значение из конфиг-файла.
Страница была полезна?
