Набор инструментов для анализа артефактов Windows, который сопоставляет обнаружения антивирусов со смещениями PE, секциями, RVA/VA и строками, с поддержкой YARA, AMSI, capa и многодвижкового сканирования, а также отчётов в форматах JSON/HTML.
Сопоставляйте статические находки и вердикты локальных антивирусных движков с точными смещениями в файле, адресами PE, функциями, символами и исходными локациями, которые аналитик может проверить.
Создано St0rn / CybersecurIT
Обзор · Возможности · Быстрый старт · Ghidra · Команды · Разработка
[!NOTE] SigLens сохраняет анализируемый артефакт неизменным. Он различает нативные смещения, точные совпадения YARA, выведенные границы и области-кандидаты, чтобы последующие решения оставались привязанными к силе имеющихся доказательств.
SigLens — это локальный набор инструментов для анализа Windows, предназначенный для триажа артефактов, исследования ложных срабатываний, диагностики сигнатур и разработки правил обнаружения. Он объединяет инспекцию PE, YARA, AMSI, локально установленные антивирусные движки, разрешение символов и криминалистическую отчётность в одном CLI- и настольном рабочем процессе.
| Анализ | Сопоставление | Проверка | Отчёт |
|---|---|---|---|
| Структура PE, строки, энтропия, IOC, скрипты | Смещение в файле → секция → RVA → VA → функция → PDB/исходник | Hex-контекст, закладки Ghidra, происхождение вердикта движка | Версионированный JSON и автономный HTML |
SigLens использует две модели атрибуции:
flowchart LR
A[Artifact] --> B[Static analysis]
A --> C[Local security engines]
B --> D[Offsets and PE mapping]
C --> E[Verdicts and provenance]
D --> F[Function, PDB, source]
D --> G[Ghidra locations]
E --> H[Evidence classification]
F --> I[JSON and HTML report]
G --> I
H --> I
CLEAN, DETECTED, UNKNOWN, UNAVAILABLE и ERROR.siglens-report/v1 и автономные HTML-отчёты.git clone https://github.com/St0rn/SigLens.git
cd SigLens
.\scripts\Install.ps1 -Dev -AddToUserPath
Установщик создаёт изолированное окружение .venv, устанавливает SigLens и его консольную команду siglens, обнаруживает локальные интеграции и устанавливает или обновляет портативный ClamAV, если не указан параметр -SkipAVInstall. Лицензированные коммерческие продукты обнаруживаются при их наличии и никогда не устанавливаются без уведомления.
Если текущая политика PowerShell блокирует локальные скрипты, примените политику, разрешённую вашей организацией для этого процесса, перед запуском установщика.
siglens scan C:\Samples\sample.exe
siglens scan C:\Samples\sample.exe `
--yara .\rules `
--symbol-path .\symbols `
--iocs `
--dissect `
--capa `
--amsi `
--engines .\engines.json
Отчёты записываются в reports\ в форматах JSON и HTML.
siglens pe-security C:\Samples\sample.exe
siglens pe-security C:\Samples\sample.exe --output .\reports\sample-pe.json
Команда сообщает о средствах защиты образа и доказательствах, необходимых для их интерпретации, включая сведения о том, имеет ли ASLR пригодные для использования перемещения. Она выделяет исполняемые и записываемые секции, точки входа за пределами исполняемых секций, некорректные границы таблицы сертификатов, TLS-колбэки, записи отладки/PDB и данные оверлея. Наличие таблицы сертификатов является лишь метаданными; SigLens не утверждает, что подписант или цепочка доверия были проверены.
siglens gui
siglens gui C:\Samples\sample.exe
.\scripts\Build.ps1
.\dist\SigLens.exe --help
Сборка включает шаблоны конфигурации движка и схему отчёта в каталоге
dist\.
Каждое местоположение в Ghidra имеет классификацию, значение уверенности (если доступно) и происхождение.
| Классификация | Значение | Доказательная сила |
|---|---|---|
EXACT_MATCH | Точное смещение, выданное YARA | Точное |
NATIVE_ENGINE_OFFSET | Смещение, выданное настроенным адаптером движка | Нативное для этого движка |
INFERRED_BOUNDARY | Воспроизводимый переход, ограниченный измерениями префикса | Экспериментальное |
CANDIDATE_REGION | Обнаруженная или структурно значимая область | На уровне области |
CONTEXT_DEPENDENT | Измерения не позволяют определить одно ответственное местоположение | Неопределённое |