Nuclei CVE Analyzer

NucleiテンプレートにおけるCVEカバレッジを分析するための高速CLIツールです。

Nuclei CVE AnalyzerはCVE IDのリストを受け取り、ローカルのNucleiテンプレートリポジトリをスキャンして、どのCVEに一致するテンプレートが既に存在するか、またどれがテンプレートカバレッジの潜在的なギャップを表しているかを判定します。

セキュリティ研究者、脆弱性ハンター、そして不足しているCVEカバレッジを素早く特定したいNucleiコントリビューター向けに構築されています。

機能

テキストファイルからCVE IDを解析
ローカルのCVEデータベースからCVEレコードを解析
NucleiのYAML/YMLテンプレートをスキャン
Nucleiテンプレートから参照されているCVEを検出
一致するテンプレートがないCVEを特定
CVEエントリを自動的に重複排除
マルチスレッドによるCVE分析
オプションのシステム全体のCVE検出
結果をJSONおよびCSVにエクスポート
found、missing、template-usageの個別レポートを生成
Richによるクリーンなターミナル出力

このプロジェクトは、外部の脆弱性スコアリングやエンリッチメントサービスではなく、意図的にテンプレートカバレッジに焦点を当てています。

例

入力:

CVE-2021-44228
CVE-2021-45046
CVE-2022-26134
CVE-2023-21840
CVE-2023-22809

出力例:

CVE             STATUS
CVE-2021-44228  FOUND
CVE-2021-45046  FOUND
CVE-2022-26134  FOUND
CVE-2023-21840  MISSING
CVE-2023-22809  MISSING

これにより、新しいNucleiテンプレートの候補となり得るCVEを簡単に見つけることができます。

インストール

リポジトリをクローンします:

git clone https://github.com/YOUR_USERNAME/nuclei-cve-analyzer.git
cd nuclei-cve-analyzer

仮想環境を作成します:

python3 -m venv .venv
source .venv/bin/activate

依存関係をインストールします:

pip install -r requirements.txt

使用方法

CVEリストをスキャンする

python3 nuclei_analyzer.py \
    -f example_cves.txt \
    -n /path/to/nuclei-templates

複数スレッドを使用する

python3 nuclei_analyzer.py \
    -f example_cves.txt \
    -t 16 \
    -n /path/to/nuclei-templates

結果を保存する

python3 nuclei_analyzer.py \
    -f example_cves.txt \
    -t 16 \
    -o output/results.json \
    -n /path/to/nuclei-templates

ローカルシステムをCVE参照についてスキャンする

python3 nuclei_analyzer.py \
    --scan-system \
    -n /path/to/nuclei-templates

ヘルプを表示

python3 nuclei_analyzer.py --help

引数

引数	説明
`-f, --file`	CVE ID を含む入力ファイル
`-n, --nuclei-path`	Nuclei テンプレートディレクトリへのパス
`-c, --cve-path`	ローカル CVE データベースディレクトリ
`-t, --threads`	分析ワーカースレッド数
`-o, --output`	統合 JSON 出力ファイル
`--scan-system`	一般的なシステムロケーションで CVE ID を検索
`-v, --verbose`	詳細ログを有効化
`--log-level`	ログレベルを設定

出力

アナライザーは出力ディレクトリ内に複数のレポートを生成します。

統合結果

完全な分析結果を含みます:

output/results_YYYYMMDD_HHMMSS.json

検出された CVE

入力セットのうち、一致する Nuclei テンプレートが存在する CVE:

output/found_cves.json

テンプレートが見つからない場合

入力セット内で一致するテンプレートがないCVE:

output/missing_templates.json

使用された CVE

スキャンされた Nuclei テンプレートによって参照されるすべての CVE:

output/used_cves.json

優先度レポート

現在テンプレートが不足しているCVEの厳選リスト:

output/priority_report.json

CSV 結果

結果のスプレッドシート向けバージョン:

output/results.csv

ワークフローの例

テンプレートのギャップを特定するための典型的なワークフロー:

# Prepare a list of CVEs
cat example_cves.txt

# Scan the Nuclei repository
python3 nuclei_analyzer.py \
    -f example_cves.txt \
    -t 16 \
    -n ~/nuclei-templates

その後、アナライザーはどの CVE がすでにカバーされているか、またどの CVE に現在一致するテンプレートがないかを報告します。

ユースケース

Nuclei コントリビューター

新しい検出テンプレートが必要となる可能性のある CVE を特定します。

セキュリティ研究者

脆弱性リストを既存の Nuclei カバレッジとすばやく比較します。

脆弱性管理

データセット内のどの脆弱性が Nuclei を使用してすでに検出可能かを判断します。

調査の自動化

生成された JSON または CSV レポートを他の分析パイプラインへの入力として使用します。

プロジェクトのステータス

このプロジェクトは CVE から Nuclei テンプレートへのカバレッジ分析 に積極的に焦点を当てています。

目標は、汎用の脆弱性エンリッチメントプラットフォームに変えるのではなく、ツールを軽量で高速、かつ焦点を絞ったものに保つことです。

ロードマップ

予定されている改善には以下が含まれます:

テンプレート参照検出の改善
テンプレートメタデータの分析
テンプレート品質チェック
重複テンプレート検出の改善
テンプレートインデックス作成の高速化
インクリメンタルスキャン
追加のエクスポート形式
レポートとフィルタリングの改善
テンプレートから CVE へのカバレッジ統計

要件

Python 3.10+
Rich
orjson

依存関係は以下でインストールします:

pip install -r requirements.txt

コントリビューション

コントリビューション、バグ報告、改善提案を歓迎します。

プルリクエストを送信する際は:

変更を焦点を絞ったものにしてください。
変更が意図的に CLI の動作を変更するものでない限り、既存の CLI の動作を維持してください。
変更内容を明確に説明してください。
可能であれば、実際の Nuclei テンプレートリポジトリに対してアナライザーをテストしてください。

免責事項

このプロジェクトは セキュリティ研究、脆弱性分析、および許可されたテスト を目的としています。

分析が許可されているシステム、リポジトリ、およびデータセットに対してのみ使用してください。

ライセンス

ここにプロジェクトのライセンスを追加してください。

Nuclei CVE Analyzer
Nuclei テンプレートの CVE カバレッジ分析

nuclei-cve-analyzer

人気