Настройка DefectDojo
Как подключить DefectDojo к ScanSuite, перевести его на свой сертификат и восстановить при сбое.
Результаты AI-сканирований всегда попадают в раздел «Уязвимости» самого ScanSuite. С классическими сканерами иначе: большинство из них выгружает найденное только в отчёты сканирования и в DefectDojo. Поэтому, если вы запускаете классические сканеры, DefectDojo рекомендуется подключить — без него их результаты останутся только в отчётах.
Некоторые классические сканеры умеют сохранять уязвимости и в ScanSuite. Nessus делает это всегда, а Semgrep, KICS, Trivy, Nuclei, ZAP, Wapiti, SSLyze, Dastardly, Acunetix и OpenVAS — если в настройках команды на вкладке Сканирование включён параметр Сохранять уязвимости сканеров (по умолчанию он выключен).
Установщик ставит DefectDojo вместе с платформой. Если он не нужен, запустите установку с флагом --no-dojo; вернуть его можно в любой момент командой ./scansuite update --with-dojo (подробнее — в разделе Параметры настройки и сервисы). Ниже описано, как подключить установленный DefectDojo к ScanSuite, настроить для него TLS и что делать, если он перестал работать.
1. Узнайте пароль администратора DefectDojo
cd /opt/scansuite && ./scansuite dojo password
DefectDojo создаёт пароль не сразу после запуска. Если команда его не показала, подождите минуту и выполните её ещё раз. Если пароля по-прежнему нет, задайте новый: ответьте y на вопрос о смене пароля и введите его.
Пароль выводится только при первом запуске и пропадает после перезапуска DefectDojo. Сразу сохраните его в надёжном месте.
2. Войдите в DefectDojo
Откройте в браузере https://DOJO_HOST_IP:8443 — или домен DefectDojo, если вы его настроили (см. TLS для DefectDojo), — и войдите под пользователем admin:
3. Скопируйте ключ API
Ключ API находится на странице /api/key-v2. Скопируйте его:
4. Подключите ScanSuite к DefectDojo
DefectDojo подключается отдельно для каждой команды, и сделать это могут её администраторы и операторы. Откройте в ScanSuite меню пользователя и выберите Команды:
Перейдите на вкладку Интеграции и найдите блок DefectDojo в карточке Трекеры задач. Впишите в поле Адрес ссылку, по которой открывается DefectDojo, вставьте в поле API-ключ скопированный ключ и нажмите Сохранить. После сохранения блок будет отмечен как подключённый. Сохранённый ключ на странице больше не показывается: если при следующих правках оставить поле пустым, прежний ключ сохранится.
5. Проверьте подключение
Откройте в боковом меню Продукты, нажмите Новый продукт, введите название и нажмите Создать продукт. Если DefectDojo подключён верно, продукт появится и в нём, а в списке продуктов ScanSuite под его названием будет ссылка на engagement в DefectDojo:
Если продукт в DefectDojo не создался, ScanSuite создаст его только у себя и покажет предупреждение. Чаще всего дело в неверном адресе или ключе: проверьте адрес и скопируйте ключ ещё раз.
TLS для DefectDojo
У DefectDojo свой домен и свой сертификат, никак не связанные с сертификатом консоли ScanSuite. Чтобы DefectDojo работал с вашим сертификатом, заведите для него домен (например, dojo.yourdomain.com) и остановите DefectDojo. Затем получите сертификат — во внутреннем удостоверяющем центре или, если сервер доступен из интернета, в Let's Encrypt командой sudo certbot certonly … -d dojo.yourdomain.com. Положите сертификат и ключ в /opt/scansuite/defectdojo/certs под именами nginx.crt и nginx.key, убедитесь, что оба файла доступны для чтения, и снова запустите DefectDojo:
cd /opt/scansuite/defectdojo && docker compose down -t 0
# положите nginx.crt и nginx.key в /opt/scansuite/defectdojo/certs
docker compose up -d
docker compose logs nginx # проверьте, что nginx подхватил сертификатCertbot хранит сертификаты в своём каталоге, а не в certs. Если вы получили сертификат через certbot, укажите путь к нему в конфигурации nginx — см. раздел «Параметры настройки и сервисы».
Перезапуск, сброс и восстановление
Чтобы перезапустить только DefectDojo, не трогая остальную платформу, выполните:
cd /opt/scansuite/defectdojo && sudo docker compose down -t 0
sudo docker compose up -dУзнать или сменить пароль администратора можно той же командой cd /opt/scansuite && ./scansuite dojo password. Помните, что после перезапуска пароль больше не выводится, поэтому сохраните его заранее. Если ничего не помогает, базу данных DefectDojo можно сбросить:
cd /opt/scansuite && ./scansuite reset dojoПри сбросе удаляются все уязвимости и продукты в DefectDojo, а вместо старого администратора создаётся новый. После сброса получите новый ключ API и заново подключите DefectDojo в ScanSuite, как описано выше, — иначе результаты сканирований перестанут выгружаться.
Проверено: 2026-09-30