
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/ソース | 16 進コンテキスト、Ghidra ブックマーク、エンジンの来歴 | バージョン管理された JSON とスタンドアロン HTML |
SigLens は 2 つの帰属モデルを使用する:
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 コンソールコマンドをインストールし、ローカル統合を検出し、-SkipAVInstall が指定されない限りポータブル ClamAV をインストールまたは更新します。ライセンスされた商用製品は存在する場合に検出され、サイレントにインストールされることはありません。
現在の 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\ 配下のエンジン設定テンプレートとレポートスキーマが含まれています。
すべての 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> ブックマークを作成します。生のオーバーレイオフセットは、ロードされたメモリアドレスを持たないため、CSV に残ります。
インポート手順と解釈のガイダンスについては、Ghidra location workflow を参照してください。
既知のビルドのベースラインレポートを保持し、同じラボ条件下で次のビルドを分析し、記録された証拠を比較します:
siglens compare-reports .\reports\baseline.json .\reports\candidate.json `
--output .\reports\evidence-diff.json
比較では、エンジンの判定とシグネチャの遷移、AMSI の変更、追加または削除された YARA ルール、PE インポートとセキュリティ態勢の変化、および分類別の Ghidra ロケーション数を記録します。結果は観測されたラボの証拠を記述するものであり、ビルドを回避的とラベル付けしたり、変換を生成したりするものではありません。SigLens は、2 つのレポート間でツールのバージョン、エンジンセット、または AMSI カバレッジが異なる場合に警告を発します。
候補の証拠を、CI および分析プラットフォームでの取り込み用に SARIF 2.1.0 へエクスポートします:
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# ビルドでは、SHA-256 にバインドされたメソッド RVA と Portable PDB のシーケンスポイントデータを siglens-source-map/v1 経由で提供できます。フォールバックのソース検索は、低信頼度の候補として明示的に分類されます。アトリビューションレポートは、関連するバイナリおよびソースの位置情報とともに SARIF へエクスポートすることもできます。詳細はソースアトリビューションのワークフローを参照してください。