
DakshSCRA v0.38-beta
Инструмент статического анализа кода с учётом фреймворков для автоматизированного ревью исходного кода, включающий платформозависимые правила, анализ потоков данных (taint analysis), оценку трудозатрат и базовые линии подавления предупреждений.
Daksh SCRA (Помощник по проверке исходного кода)
Author:
- Debasis Mohanty ([email protected])
- Twitter / X: @coffeensecurity
- www.coffeeandsecurity.com
О Daksh SCRA
Daksh SCRA (Source Code Review Assist) создан для повышения эффективности процесса проверки исходного кода, обеспечивая хорошо структурированный и организованный подход для ревьюеров кода.
Вместо того чтобы без разбора помечать всё как потенциальную проблему, Daksh SCRA поощряет вдумчивый анализ, побуждая к исследованию и подтверждению потенциальных проблем. Этот подход снижает спешку с пометкой каждой потенциальной проблемы как бага, сокращая путаницу и потери времени на ложные срабатывания.
Дебют
Daksh SCRA был впервые представлен во время обучающей сессии по проверке исходного кода на Black Hat USA 2022 (6–9 августа), где он был ненавязчиво продемонстрирован определённой аудитории. Его официальный публичный дебют состоялся на Black Hat USA 2023 в Лас-Вегасе.
Возможности и функциональность
DakshSCRA объединяет отличительные возможности для ручной проверки исходного кода — от областей интереса по путям к файлам и оценки трудозатрат до разведки программного обеспечения, контекстных правил и межфайлового анализа.
| Возможность | Метка | Почему это важно |
|---|---|---|
| Области интереса по путям к файлам | Первые в мире* | Сканирует сами имена файлов и каталогов наряду с кодом, чтобы помечать подозрительные пути, такие как резервные копии, отладочные эндпоинты, дампы конфигураций и файлы учётных данных, которые ревьюеры часто пропускают. |
| Научная оценка трудозатрат | Первые в мире* | Формирует количественную оценку трудозатрат на ручную проверку на основе размера кодовой базы и сигналов проекта. Настраиваемые допущения делают планирование работ явным и воспроизводимым. |
| Разведка программного обеспечения | Вторые в мире* | Определяет языки, фреймворки и инфраструктуру по содержимому файлов и структуре проекта до сканирования. Связывает инвентаризацию технологий с автоматическим выбором правил, семантическим анализом и планированием проверки. |
| Продвинутый семантический и межфайловый анализ | Самый продвинутый open source на момент выпуска* | Отслеживает контролируемые пользователем данные от источника до стока через границы поддерживаемых файлов с помощью специализированного анализа. Advanced Analysis вышел вместе с оригинальным RDL в марте 2026 года; RDL v2 расширяет семантическую оценку правил на несколько файлов. |
- На основе общих поисков на момент введения каждой возможности. Похожая возможность не была найдена в open source инструментах проверки безопасности кода. Для оценки трудозатрат похожий подход не был найден и в коммерческих инструментах. Recon занял второе место после Microsoft Application Inspector. Межфайловый анализ был самым продвинутым среди open source инструментов проверки кода на момент его выпуска.
История возможностей и подтверждения
| Возможность / веха | Дата | Релиз | Подтверждение / охват |
|---|---|---|---|
| Начальная бета и правила путей к файлам | 22 октября 2022 | v0.1-beta | Первоначальный выпуск; сохранённый исходный код включает выделенный перечень правил для путей к файлам. |
| Разведка программного обеспечения (опубликованное представление) | 9 июля 2023 | v0.3-beta | Примечания к выпуску представляют recon; более ранний код репозитория является отдельным подтверждением реализации. |
| Оценка трудозатрат на ручную проверку (реализация) | 29 июля 2023 | Коммит реализации | Добавлен выделенный модуль оценки; это не дата последующего релиза с исправлениями. |
| Оригинальный RDL и межфайловый Advanced Analysis | 2 марта 2026 | v0.31-beta | Условная логика правил и независимый межфайловый анализ выпущены вместе. Отображаемая дата релиза — 2 марта; метка времени публикации — 1 марта 2026 года, 18:39 UTC. |
Сравнительные подтверждения
- Предшественник recon: Microsoft Application Inspector (16 января 2020) описывает более ранний инструмент анализа характеристик исходного кода. Recon в Daksh SCRA поставлен вторым после него.
Даты обозначают вехи репозитория или релиза.
DakshSCRA был представлен во время обучения на Black Hat USA 2022 и публично дебютировал на Black Hat USA 2023. Эти даты описывают представление проекта, а не все текущие функции.
Активные улучшения продолжаются. В ближайших выпусках запланировано множество новых функций и улучшений.
Не стесняйтесь вносить вклад в обновление или добавление новых правил и будущую разработку.
Если вы обнаружите какие-либо ошибки, сообщите о них на [email protected].
Подробная документация: https://dakshlabs.com/#docs
Начало работы
Есть два способа запустить Daksh SCRA — выберите тот, который лучше подходит для вашего рабочего процесса:
| Лучше всего подходит для | Перейти к | |
|---|---|---|
| 🌐 Веб-интерфейс (Docker) | Самый простой способ начать — одна команда, панель управления в браузере, отображение хода сканирования в реальном времени и просмотр отчётов/артефактов. Рекомендуется для большинства пользователей. | Веб-интерфейс (Docker) |
| 💻 CLI (Python) | Скриптинг, CI-конвейеры или запуск сканирований без Docker. | Настройка CLI |
Оба способа запускают один и тот же движок сканирования — веб-интерфейс является браузерным фронтендом поверх того же CLI, поэтому результаты в любом случае идентичны.
Веб-интерфейс (Docker)
Самый быстрый способ запустить Daksh SCRA — через его браузерный веб-интерфейс, запускаемый с помощью Docker-скрипта запуска с учётом хоста. Он предоставляет вам средство запуска сканирования, живой поток консоли и просматриваемую историю прошлых отчётов. Скрипту запуска требуется Python 3 (только стандартная библиотека); приложение и его зависимости работают в Docker.
Настройка Docker запускает веб-интерфейс и CLI как независимые сервисы, собранные из одного образа, поэтому вы можете использовать любой из них (или оба) из одного контейнера.
Запуск веб-интерфейса
После загрузки Daksh SCRA с GitHub сначала распакуйте ZIP-архив.
Откройте терминал (PowerShell или командную строку в Windows) внутри распакованной
папки проекта, содержащей docker-compose.yml и dakshscra.py.
Выполняйте все команды запуска и Docker Compose, приведённые ниже, из этой папки.
Если ваш терминал открывается в другом месте, сначала перейдите в распакованную папку:
cd "path/to/extracted/DakshSCRA-folder"
Замените пример пути на фактическое место загрузки и имя папки.
Если вы вместо этого клонировали репозиторий, выполните cd DakshSCRA из его родительской папки.
Помощник запуска распознаёт Windows, WSL, Linux и macOS, затем монтирует корень хоста, доступные диски Windows и общие папки в режиме только для чтения перед запуском контейнеров. Запускайте его на компьютере, где работает Docker.
Linux, macOS или WSL (в foreground):
python3 tools/start_webui.py
Windows PowerShell или командная строка (на переднем плане):
py tools/start_webui.py
Для запуска в отсоединённом (фоновом) режиме добавьте --detach. Контейнеры продолжат работать
после возврата команды запуска, оставляя ваш терминал доступным.
Linux, macOS или WSL (отсоединённый режим):
python3 tools/start_webui.py --detach
Windows PowerShell или командная строка (в отдельном окне):
py tools/start_webui.py --detach