> [!IMPORTANT]
> **`sources/*.json`ファイルは自動生成されたアーティファクトです。直接編集しないでください。**
> すべてのソースの追加と変更は`build_sources.py`で行い、`python build_sources.py`を実行して適用する必要があります。手動で編集すると、次回のビルドで上書きされます。

#### ソーススキーマ```json
{
  "name": "MyPrivateDB",
  "endpoint": "https://api.myprivatedb.com/search?q={target}",
  "method": "GET",
  "headers": { "Authorization": "Bearer {MY_API_KEY}" },
  "regex_pattern": "([\\w.+-]+@[\\w-]+\\.[\\w.]+):([\\S]+)",
  "required_api_key_name": "MY_API_KEY",
  "api_key_slots": ["{MY_API_KEY}"],
  "input_type": "email",
  "output_type": ["username", "ip"],
  "pivot_types": ["email", "username"],
  "confidence": 0.9
}

`scan`（`--autoscan`なし）はフェーズ1のみ実行 — 情報漏洩ソース、ピボット/ドーク/スクレイピングなし。

---

### 再帰的アバランチエンジン

スキャン中に発見されたすべての識別子（漏洩レコード、ドークヒット、またはスクレイピングされたペースト/Telegramコンテンツから）は、新しいインテリジェンスシードとして扱われます。各アセットに対し、エンジンは4つのフェーズを順次実行します：漏洩スキャン → ハッシュクラック → ドーク → スクレイピング。**全4フェーズ**から抽出された識別子は収集され、新しいシードとして再注入されます。子アセットはその後、`asyncio.gather` を介して同時に処理されます。```
[email protected]
  └─► [Breach] username: j.doe      ──► [Breach + Crack + Dork + Scrape]
  │         └─► github.com/jdoe     ──► [Breach + Crack + Dork + Scrape]
  └─► [Breach] hash: 5f4dcc...      ──► [AutoCrack] → "password123"
  │         └─► [Breach] password-recycling scan across all sources
  └─► [Dork] [email protected]          ──► [Breach + Crack + Dork + Scrape]
  └─► [Scrape/paste] [email protected] ──► [Breach + Crack + Dork + Scrape]

JSONエクスポートには、`scan_id`、`target`、`timestamp`、`nox_version`、`pivot_depth_reached`を含む`_meta`ブロックが含まれます。これにより、各エクスポートが自己記述的になり、ケース管理プラットフォームへの取り込みが容易になります。

すべての出力はサニタイズされています。プロキシエラー、タイムアウト、トレースバックは除去され、実用的なインテリジェンスのみが含まれます。

---

## ファイルシステムのレイアウト```
~/.nox/
├── sources/               # Auto-generated JSON source plugins
├── reports/               # Generated forensic reports
├── logs/                  # Runtime log (nox.log)
├── wordlists/             # Hash cracking wordlists
├── vault/                 # Secure storage
└── nox_cache.db           # Forensic persistence database (SQLite)

~/.config/nox-cli/
├── apikeys.json           # API keys — chmod 0600, never committed to VCS
└── logs/
    └── nox_system.log     # Silent system log: API events, rate-limits, crack attempts

# .deb install (isolated venv)
/opt/nox-cli/
├── nox.py
├── build_sources.py
├── requirements.txt
├── sources/
└── .venv/                 # Isolated Python environment (PEP 668 compliant)

ポストインストールスクリプトは自動的に以下の処理を行います：
1. `/opt/nox-cli/.venv` に分離された仮想環境を作成
2. PEP 668 準拠の venv 内にすべての Python 依存関係をインストール（システム汚染ゼロ）
3. 124 個のソースプラグインをビルド
4. `/usr/bin/nox-cli` → `/opt/nox-cli/nox-wrapper.sh` にリンク

### オプション 2: ソースから```bash
git clone https://github.com/nox-project/nox-framework.git
cd nox-framework
pip install -r requirements.txt
python build_sources.py
python3 nox.py

**ステップ2 — APIキーの設定**

`build_sources.py` は初回実行時に `~/.config/nox-cli/apikeys.json` を作成し、サポートされているすべてのサービスがあらかじめ入力されています。このファイルは `chmod 0600` に設定され、VCSにコミットされることはありません。

これが **唯一の正規キーストア** です。すべてのソースは実行時にここから読み取ります。```bash
# Edit the file directly
nano ~/.config/nox-cli/apikeys.json

# Or inspect plugin status and key configuration
nox-cli --list-sources

## CLIリファレンス```
usage: nox-cli [-h] [-t TARGET] [-i] [--version]
               [--autoscan] [--fullscan] [--no-pivot] [--depth N]
               [--dork TARGET] [--scrape TARGET]
               [--crack HASH] [--no-online-crack]
               [--analyze PASS] [--list-sources] [--reset-sources]
               [--tor] [--proxy URL] [--guardian-off] [--allow-leak]
               [--threads N] [--timeout N]
               [-o FILE] [--format {json,csv,html,md,pdf}]
               [--diff]

  -t, --target TARGET     Target to scan (auto-detected type)
  -i, --interactive       Launch interactive REPL
  --version               Show version and exit
  --autoscan              Full pipeline: breach + pivot + dork + scrape
  --fullscan              Breach + pivot only (no dork/scrape)
  --no-pivot              Disable recursive pivot enrichment
  --depth N               Avalanche pivot depth (default: 2)
  --dork TARGET           Google/Bing/SearXNG dorking for leaked documents
  --scrape TARGET         Paste site + Telegram scraping
  --crack HASH            Identify and crack a hash
  --no-online-crack       Local wordlist only — no data sent to third-party APIs
  --analyze PASS          Deep password strength analysis
  --list-sources          Plugin debug: input type, confidence, key status
  --reset-sources         Force resync of source plugins from package
  --tor                   Route all traffic through Tor (port 9050)
  --proxy URL             HTTP/S or SOCKS5 proxy URL
  --guardian-off          Bypass OPSEC kill-switch (direct connection)
  --allow-leak            Allow direct connection if proxy/Tor is unavailable
  --threads N             Concurrency limit (default: 20)
  --timeout N             Request timeout in seconds (default: 15)
  -o, --output FILE       Output file path
  --format FORMAT         Output format: json, csv, html, md, pdf
  --diff                  Show only new findings vs last cached scan

はい、こちらが翻訳結果です。

---

| 機能 | 説明 | ステータス |
|------|------|------------|
| ログ分析 | ログファイルを解析し、疑わしいパターンを抽出します | ✅ 実装済み |
| リアルタイム監視 | システムイベントをリアルタイムで監視します | ✅ 実装済み |
| レポート生成 | 詳細なセキュリティレポートを生成します | ✅ 実装済み |
| 脅威インテリジェンス統合 | 外部の脅威フィードと統合します | 🚧 開発中 |

```bash
python3 threat-hunter.py --mode analyze --log /var/log/syslog

**例:**```
nox> autoscan [email protected]
nox> graph
nox> visualize
nox> pivot 3
nox> search admin
nox> export pdf investigation.pdf
nox> sources
nox> config threads 30
nox> config depth 3
nox> proxy socks5://127.0.0.1:1080
nox> tor

**2. 再構築:**```bash
python build_sources.py

---

## 法的免責事項

> [!WARNING]
> **NOXは以下の用途にのみ使用することを意図しています:**
> - 明示的な書面による同意を得た、正規の侵入テストおよびレッドチーム演習
> - あなたが所有する、または評価を委託された資産に対する企業の露出分析
> - デジタルフォレンジックおよびインシデント対応
> - 管理された隔離環境における学術およびセキュリティ研究
>
> **明示的な書面による許可なく、このツールをシステム、ネットワーク、または個人に対して不正に使用することは刑事犯罪となります**（コンピュータ詐欺および不正利用防止法（CFAA、18 U.S.C. § 1030）、コンピュータ不正使用法1990（CMA）、および世界のすべての主要な法域における同等の法律に基づく）。
>
> NOXの作成者および貢献者は、本ソフトウェアの誤使用に起因する直接的、間接的、偶発的、または結果的な損害について**一切の責任を負いません**。NOXをダウンロード、インストール、または実行することにより、お客様は適用されるすべての地域、国内、国際法を遵守し、明示的かつ文書化された許可を保持するシステムおよびデータのみを対象とすることを無条件に同意したものとみなされます。
>
> **これらの条件に同意しない場合は、本ソフトウェアを使用しないでください。**

---

## ライセンス

[Apache License 2.0](https://github.com/nox-project/nox-framework/blob/HEAD/LICENSE.txt)