Документация / Руководство администратора / Настройки платформы
Настройки сканеров в Core
Сканер в Core - это источник уязвимостей: его имя указывают при загрузке отчёта, по нему выбирается логика разбора. В настройках сканера задают тип, разбор отчёта, автозакрытие исчезнувших уязвимостей и своё описание для задач Jira.
Раздел: "Глобальные настройки" → "Сканеры", вкладки "Встроенные сканеры" и "Свои сканеры". Нужна роль с правом "Глобальные настройки": "Просмотр" для чтения, "Изменение" для правки.
Список сканеров с форматами отчётов и джобами Radar: Справочник сканеров.
Поля сканера
| Поле | Что задаёт | По умолчанию |
|---|---|---|
| "Название" | имя сканера; уникально | - |
| "Тип сканера" | "Не указан", "Секреты", SAST, SCA, DAST, "Инфра", "Облако" | "Не указан" |
| "Теги" | теги сканера | - |
| "Критичность по умолчанию" | критичность сканера по умолчанию | "Низкая" |
| "Настройка логики разбора отчётов" | каким парсером разбирать отчёт | зависит от сканера |
| "Автозакрытие" | что делать с уязвимостью, которой нет в новом отчёте | выключено |
| "Своё описание Jira" | текст для задач Jira по уязвимостям сканера | - |
Название - это ключ импорта
"Название" должно совпадать с полем scanner_name при загрузке отчёта и с переменной SCAN_TYPE джобы Radar. Отчёт с неизвестным именем Core отклоняет с ответом 400. После переименования сканера обновите джобы Radar и шаблоны CI, которые отправляют отчёты под старым именем.
"Тип сканера" используется в дашбордах, метриках по типам сканеров и в условии правил "Тип сканера".
Логика разбора отчётов
Блок "Настройка логики разбора отчётов" показывает карточки доступных парсеров:
| Парсер | Карточка | Когда доступен |
|---|---|---|
| встроенный | "Встроенный парсер" | у сканера есть встроенная логика разбора |
| вендорский | "Парсер вендора" | у сканера есть парсер поставщика |
| свой | "Свой парсер" | настроен свой разбор JSON-отчёта |
| нет | - | парсер не выбран, отчёты не разбираются |
- "Использовать по умолчанию" делает парсер активным. Выбрать парсер, которого у сканера нет, нельзя: 400 "This scanner does not have a built-in parser." или "This scanner does not have a vendor parser.".
- "Настроить свою логику разбора" открывает мастер своего формата: Свой и коммерческий сканер.
- Форма предупреждает: меняйте парсер с осторожностью, небольшое различие даст дубликаты. Разные парсеры по-разному заполняют поля уязвимости, и уязвимости из нового отчёта могут не совпасть с прежними при дедупликации.
Свой парсер требует платной лицензии.
Своё сопоставление критичности
"Своё сопоставление критичности" переводит текст критичности из отчёта в критичность Core. Используется только встроенным парсером. Сопоставления для встроенных сканеров заводятся при установке. В форме их можно изменить или удалить.
Автозакрытие
Автозакрытие решает, что делать с ранее найденной уязвимостью, которой нет в новом отчёте этого сканера.
| Поле | Значения | По умолчанию |
|---|---|---|
| "Включить автозакрытие" | включено или выключено | выключено |
| "Выберите действие автозакрытия" | "Решить" или "Удалить" | "Решить" |
| Действие | Результат |
|---|---|
| "Решить" | уязвимость получает статус "Решено" и тег auto-closed, её задачи в Jira переходят в статус решения. История разбора сохраняется: если сканер найдёт уязвимость снова, она вернётся в статус "Не обработано" |
| "Удалить" | уязвимость удаляется из Core вместе с историей разбора, её задачи в Jira тоже удаляются |
Уязвимости, закрытые автоматикой, находит фильтр списка уязвимостей "Автоматически решено настройками сканера".
Неполный отчёт закрывает уязвимости
Автозакрытие срабатывает, когда в новом отчёте сканера нет ранее найденной уязвимости. Если сканер упал и выдал пустой или неполный отчёт, уязвимости будут решены или удалены. Включайте "Удалить" только для сканеров со стабильным полным отчётом.
Если в последовательности Radar несколько джоб отправляют отчёты под одним именем сканера, отчёт одной джобы может закрыть уязвимости другой. Core предупреждает об этом в форме последовательности: "Предупреждение об импортере". Последовательности: Джобы и последовательности.
Список сканеров показывает колонки автозакрытия и фильтр по включённому автозакрытию.
Своё описание Jira
Блок "Своё описание Jira" задаёт текст для разработчика вместо технического описания сканера в задачах Jira.
| Поле | Что задаёт |
|---|---|
| "Выберите действие" | "Дополнить" или "Заменить" |
| "Своё описание" | текст, до 3000 символов |
| Действие | Результат |
|---|---|
| "Дополнить" | описание уязвимости от сканера остаётся, ваш текст встаёт под ним отдельным блоком |
| "Заменить" | описание от сканера в задачу не попадает, остаётся только ваш текст |
Технический блок со ссылкой на уязвимость, файлом, строкой и CVSS есть в задаче в обоих вариантах. Интеграция с Jira: Jira.
Свои сканеры
Свой сканер нужен для инструмента, которого нет во встроенном списке.
- Откройте вкладку "Свои сканеры" и создайте сканер: "Создать сканер".
- Укажите "Название" - то же, что будет в
scanner_nameилиSCAN_TYPE. - Выберите "Тип сканера".
- Настройте свою логику разбора.
"Удалить сканер" удаляет сканер, его парсер и сопоставления критичности. Уязвимости сканера не удаляются: они переходят к сканеру "Manual". Статистика сканера в аудитах удаляется.
API
| Метод и путь | Назначение |
|---|---|
GET /api/v1/scanners/ |
список сканеров с фильтрами scanner_type, name__icontains, auto_closer_enabled, has_built_in, has_vendor_importer |
POST /api/v1/scanners/ |
создать сканер |
PATCH /api/v1/scanners/<id>/ |
изменить поля сканера |
DELETE /api/v1/scanners/<id>/ |
удалить сканер |
GET, PATCH, DELETE /api/v1/scanner-finding-mappings/ |
сопоставления критичности, фильтры scanner, severity |
Поля автозакрытия в API: auto_closer_enabled, auto_closer_action (0 - удалить, 1 - решить). Своё описание Jira: jira_task_description_formation_action (0 - дополнить, 1 - заменить), jira_task_description_appendix.