Windows 工件分析工具包,可将 AV 检测映射到 PE 偏移、节区、RVA/VA 和字符串,支持 YARA、AMSI、capa 和多引擎扫描,并生成 JSON/HTML 报告。
将静态发现和本地安全引擎的判定结果与分析师可审查的精确文件偏移、PE 地址、函数、符号和源代码位置相关联。
由 St0rn / CybersecurIT 创建
[!NOTE] SigLens 会保留被分析的工件。它区分原生偏移、精确的 YARA 匹配、推断的边界和候选区域,从而使下游决策始终与可用证据的强度挂钩。
SigLens 是一个本地 Windows 分析工具包,用于工件分类、误报调查、签名诊断和检测工程。它将 PE 检查、YARA、AMSI、本地安装的 AV 引擎、符号解析和取证报告整合到一个 CLI 和桌面工作流中。
| 分析 | 关联 | 审查 | 报告 |
|---|---|---|---|
| PE 结构、字符串、熵、IOC、脚本 | 文件偏移 → 节 → RVA → VA → 函数 → PDB/源代码 | 十六进制上下文、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 JSON 契约和独立 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
报告以 JSON 和 HTML 格式写入 reports\。
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\ 下包含引擎配置模板和报告 schema。
每个 Ghidra 位置都带有分类、可用时的置信度值以及来源信息。
| 分类 | 含义 | 证据强度 |
|---|---|---|
EXACT_MATCH | 由 YARA 输出的精确偏移 | 精确 |
NATIVE_ENGINE_OFFSET | 由已配置的引擎适配器输出的偏移 | 该引擎原生 |
INFERRED_BOUNDARY | 由前缀测量界定的可复现转换点 | 实验性 |
CANDIDATE_REGION | 检测到的或结构上相关的区域 | 区域级 |
CONTEXT_DEPENDENT | 测量结果不支持单一责任位置 | 不确定 |
前缀收窄会记录重复的判定结果和受控检查点。如果同一前缀产生相互冲突的结果,或者较短前缀被检测到而较长前缀为干净,SigLens 会报告 CONTEXT_DEPENDENT,而不是给出单一的推断边界。
生成分析报告,对照精确的产物进行验证,并导出审查位置:
siglens scan C:\Samples\sample.exe --yara .\rules --engines .\engines.json
siglens verify-report .\reports\sample.json `
--artifact C:\Samples\sample.exe
siglens ghidra-offsets C:\Samples\sample.exe .\reports\sample.json `
--output .\reports\sample-ghidra.csv `
--script .\reports\ImportSigLens.py
导出器在使用任何位置之前会校验产物的 SHA-256。生成的脚本会在 Ghidra 内部执行相同的检查,针对当前程序映像基址解析每个 RVA,并创建一个 SigLens/<classification> 书签。原始 overlay 偏移量仍保留在 CSV 中,因为它们没有已加载的内存地址。
有关导入说明和解读指南,请参阅 Ghidra 位置工作流。
为已知构建保留一份基线报告,在相同的实验条件下分析下一个构建,并比较记录的证据:
siglens compare-reports .\reports\baseline.json .\reports\candidate.json `
--output .\reports\evidence-diff.json
比较结果记录了引擎判定与签名状态变化、AMSI 变更、新增或移除的 YARA 规则、PE 导入与安全态势变化,以及按分类统计的 Ghidra 位置数量。结果描述的是实验室中观察到的证据;它们不会将某个构建标记为规避性,也不会生成变换。当两份报告之间的工具版本、引擎集合或 AMSI 覆盖范围存在差异时,SigLens 会发出警告。
将候选证据导出为 SARIF 2.1.0,以供 CI 和分析平台摄取:
siglens export-sarif .\reports\candidate.json `
--output .\reports\candidate.sarif
SARIF 结果保留字节偏移、置信度、RVA/VA 数据、引擎签名、来源信息以及用于结果跟踪的确定性指纹。
将每个已验证或推断的报告位置映射回原生符号、托管方法和候选源文件:
siglens attribute-source C:\Samples\sample.exe .\reports\sample.json `
--symbol-path .\symbols `
--linker-map .\build\sample.map `
--source-map .\build\sample.siglens-source-map.json `
--source-root C:\Code\Project
原生 C/C++ 构建使用 DbgHelp PDB 行信息和 MSVC MAP 符号。托管 C# 构建可通过 siglens-source-map/v1 提供绑定 SHA-256 的方法 RVA 和 Portable PDB 序列点数据。回退源搜索会被明确归类为低置信度候选。归因报告还可以导出为 SARIF,并附带相关的二进制和源位置。参见源归因工作流。
| 命令 | 用途 |
|---|---|
scan | 整合静态、YARA、引擎、IOC、PE 和报告工作流 |
multi-scan | 通过已配置的本地安全引擎进行全文件扫描 |
amsi-scan | 通过 Windows AMSI 提交一个完整的文件缓冲区 |
script-analyze | 全缓冲区 AMSI 加结构化脚本诊断 |
component-scan | 扫描固定的 PE 节区和覆盖层 |
narrow | 界定可复现的 AV 前缀检测转变 |
dissect | 检查 PE 节区、资源、哈希、熵和覆盖层 |
pe-security | 审查 PE 缓解措施、权限、签名元数据、TLS 和 PDB 数据 |
inspect-offset | 映射偏移量并显示其本地字节和字符串 |
locate | 将偏移量与 PE 函数、PDB 和源关联 |
ghidra-offsets | 导出经验证的分析位置和书签脚本 |
verify-report | 验证模式、哈希、范围和地址一致性 |
compare-reports | 比较 AV、AMSI、YARA、导入和位置证据 |
export-sarif | 将发现和来源信息导出为 SARIF 2.1.0 |
attribute-source | 将报告位置映射到 C/C++/C# 函数和源 |
compare | 比较两个构建并报告变更的二进制范围 |
path-test | 诊断 Windows 路径和文件访问行为 |
doctor | 检查运行时和集成可用性 |
gui | 启动桌面分析界面 |
about | 显示版本和项目归属信息 |
运行 siglens COMMAND --help 查看命令特定选项。
# Map a known offset and inspect nearby content
siglens inspect-offset C:\Samples\sample.exe 0x005C0000 --preview-bytes 512
# Resolve the containing function and local symbols
siglens locate C:\Samples\sample.exe 0x18A20 --symbol-path .\symbols
# Inspect PE structure
siglens dissect C:\Samples\sample.exe
# Review PE mitigations and anomalous permissions
siglens pe-security C:\Samples\sample.exe --output .\reports\sample-pe.json
# Compare two builds
siglens compare .\old.exe .\new.exe
# Analyze a PowerShell script
siglens script-analyze C:\Samples\sample.ps1 --context-lines 5 --json
# Narrow a reproducible engine transition
siglens narrow C:\Samples\sample.exe --engines .\engines.json
将 engines.example.json 复制为本地配置,并仅启用工作站上已安装且已获得许可的扫描器。