dmitryflynn/netlogic
NetLogicは、トラフィック検査、パケット分析、脅威検出のための高度なネットワーク分析およびサイバーセキュリティツールキットです。
クラウドネイティブ攻撃面マッパー＆脆弱性相関ツール — v3.0
NetLogicは、アクティブポートスキャン、CVE相関（ライブNVD API）、SSL/TLS分析、HTTPセキュリティ監査、DNS/メールセキュリティ評価、サブドメイン乗っ取り検出、パッシブOSINT、アクティブ脆弱性プロービング、AI駆動の推論エンジン、クロスホスト攻撃チェーン発見、ディーププローブエージェントアーキテクチャを組み合わせたネットワークセキュリティプラットフォームであり、Webアプリ（Reactダッシュボード＋FastAPI）として提供されます。コアスキャンエンジンは純粋なPython 3.9+ stdlibであり、サードパーティ依存関係はゼロです。
| モジュール | 説明 |
|---|---|
| ポートスキャナー | 43/58ポートに対するTCP接続スキャン、22のサービスプローブ、バナーグラビング |
| CVE相関 | ライブNVD API v2.0 + FIRST.org経由のEPSSエンリッチメント |
| TLSアナライザー | プロトコルバージョン、弱い暗号、POODLE/BEAST/CRIME/DROWN、証明書の有効期限 |
| HTTPヘッダー監査 | HSTS、CSP、X-Frame-Options、CORS、クッキーフラグ；0–100のスコア |
| スタックフィンガープリント | バナー/ヘッダー/ボディからのCMS、フレームワーク、クラウドプロバイダー、CDN、WAF検出 |
| DNSセキュリティ | SPF、DKIM、DMARC、DNSSEC、ゾーン転送、スプーフィング可能性スコア |
| パッシブOSINT | 証明書透過性ログ、DoH DNS、ASNルックアップ — 対象への直接接触なし |
| サービスプローバー | 認証なしのRedis/Mongo/ES/Docker/K8s/etcdプローブ、33の管理パス |
| 乗っ取り検出 | CTログサブドメイン発見 + 25のクラウドプロバイダーCNAMEフィンガープリント |
| Nuclei統合 | 13k以上のコミュニティテンプレート（CVE、技術、露出、設定ミス）のラッパー — MITライセンス |
| フュージョンパイプライン | マルチセンサーシグナルゲート → 決定論的一致 → AI裁定 → 攻撃グラフ → 6セクションレポート |
| Webフィンガープリント | ファビコンハッシュ（Shodan互換 mmh3）、JSシークレット、バージョンマーカー、公開ファイル、デフォルトランダー検出 |
| AI分析 | OpenAI / Anthropic / OpenRouter / Ollama / Gemini / Groq / Kimi / Qwen — トークンストリーミングSSE |
| 推論エンジン | EvidenceGraph、仮説エンジン、信頼度減衰、来歴、スケジューラ、プレイブック、変更検出、アクティブ検証を備えた適応型 observe→reason→act ループ |
| ディーププローブ | サービス別エージェントアーキテクチャ：ScoutAgent（偵察）、ProbeAgent（対象CVEチェック）、Coordinator、Sandbox |
| AI調査エージェント | ReActスタイルループ：ベースラインセンサーの後、AIが厳選されたスコープ制限・監査済みツール表面（約35ツール）を駆動し、リードを検証して攻撃チェーンを構築 — オプトインのアグレッシブツール（クラッシュプローブ、フリーフォームプルーフ、フリーフォームエクスプロイト）を承認された対象に対して提供 |
| 検証エンジン | AI駆動のCVE再検証：CVEコンテキストからraw-HTTPプローブ計画を設計し、stdlibソケット経由で実行 |
| マルチホストオーケストレーション | ホストごとの完全スキャンパイプライン → クロスホストコンテキストと到達可能性マトリックス → 攻撃チェーン発見 |
| AIセンサーディレクター | LLMがオープンポート、技術スタック、CVEに基づいて優先すべきセンサーを決定 |
| 認証付きSSH | 認証情報を使用した ssh サブプロセスが実際のインストール済みパッケージバージョンを読み取る（60以上の製品マッピング） |
| サービス列挙 | プロトコルレベルの属性抽出（SSH KEX、SMBv1、RDP NLA、SNMPコミュニティ、HTTP認証状態） |
| トポロジーマッパー | リバースDNS、IPv6、traceroute、ASN/組織/国（ip-api.com経由） |
| 到達可能性プローバー | サブネット隣接性からの侵害後ラテラルムーブメントマトリックス |
| ネットワークプローバー | 2フェーズ発見（ライブスイープ → フルポートスキャン）によるアクティブサブネットスイープ（/24プライベートネイバー） |
| スキャン差分 | 経時変化：現在のスキャンを対象ごとの最新の以前のJSONレポートと比較 |
| ライセンス管理 | キーアクティベーションによる商用ライセンスシステム（Stripe/Paddle/Lemon Squeezy用スタブ） |
| 組織ごとのAI設定 | 各組織が独自のLLM認証情報をFernetで暗号化して保存 |
| OIDC / Clerk | Clerk発行のセッションJWTを公開JWKSに対して検証し、自動プロビジョニングで人間のログインを実現 |
| PostgreSQL | 自動適用マイグレーション（スキャンジョブ、組織設定、推論状態、監査）を備えた完全なマルチテナント永続化 |
| フュージョンベンチマーク | 記録されたHTTPカセットに対するオフラインベンチマーク；精度/再現率/重要再現率/偽陽性削減メトリクス |
NetLogicを実行するには正確に2つの方法があります:
| モード | コマンド | 動作 |
|---|---|---|
| Webアプリ | netlogic --gui | FastAPIを起動し、React SPAとインプロセススキャンエージェントを提供し、シークレットを自動生成し、ブラウザでダッシュボードを開きます。これがWebアプリを実行する唯一の方法です。 |
| CLI | netlogic <target> [flags] | ワンショットのターミナルスキャン（サーバーなし）、レポートを出力/書き込みます。 |
製品の表面はWebアプリ（Reactダッシュボード＋FastAPI）です。src/のスキャンエンジンはUIから開始されたジョブを実行します。
pip install -r requirements-api.txt pip install -e .
netlogic --gui
netlogic scanme.nmap.org --full
---
## CLIリファレンス```
netlogic [target] [flags]
エントリポイントは api.cli:main (pyproject.toml で定義) であり、netlogic.py:main() に委譲します。すべてのスキャンロジックは src/ にあります。
| 形式 | 例 | モード |
|---|---|---|
| ホスト名 | example.com | 単一ホストスキャン |
| IPv4 | 10.0.0.5 | 単一ホストスキャン |
| CIDR | 192.168.1.0/24 | CIDRスイープ（スキャナーのみ、フュージョンなし） |
| カンマ区切り | target1,target2 | マルチホストオーケストレーション（クロスホストコンテキスト） |
netlogic example.com
netlogic example.com --full
netlogic example.com --tls --headers
netlogic example.com --takeover
netlogic example.com --osint
netlogic example.com --stack
netlogic example.com --dns
netlogic 10.0.0.5 --probe
netlogic example.com --full --probe
### ポート選択```
# Quick — 43 common ports (default)
netlogic example.com --ports quick
# Full — 58 extended ports
netlogic example.com --ports full
# Custom list
netlogic example.com --ports custom=22,80,443,8080,9200
netlogic example.com --ai --ai-key $KEY
netlogic example.com --ai --ai-provider openai --ai-key $KEY --ai-model gpt-4o-mini
netlogic example.com --ai --ai-provider anthropic --ai-key $KEY
netlogic example.com --ai --ai-provider gemini --ai-key $KEY --ai-model gemini-2.0-flash
netlogic example.com --ai --ai-provider ollama
netlogic example.com --ai --ai-provider custom --ai-base-url https://... --ai-model model-name
### 対応AIプロバイダー
| プロバイダー | デフォルトモデル | APIスタイル |
|---|---|---|
| `openrouter` | `anthropic/claude-sonnet-4` | OpenAI |
| `openai` | `gpt-4o-mini` | OpenAI |
| `anthropic` | `claude-3-5-sonnet-20241022` | Anthropic Messages |
| `kimi` (Moonshot) | `kimi-k2.6` | OpenAI |
| `qwen` (Alibaba) | `qwen-plus` | OpenAI |
| `groq` | `llama-3.3-70b-versatile` | OpenAI |
| `gemini` (Google) | `gemini-2.0-flash` | OpenAI |
| `ollama` | `llama3` | OpenAI |
| `custom` | ユーザー指定 | OpenAI |
### 推論エンジン```
# Adaptive observe→reason→act loop (deterministic by default; AI-augmented with --ai)
netlogic example.com --reason
# Multi-host world modeling — discovers in-scope neighbours, reasons per host
netlogic example.com --reason --multi-host
# Change detection — diffs against prior saved report
netlogic example.com --since-last
# Active validation — confirms hypotheses with safe non-destructive GETs
netlogic example.com --reason --active-validate
# Deep probe — per-service agent architecture with context isolation
netlogic example.com --deep-probe
ベースラインセンサーが実行された後、オプションのReActスタイルエージェントにより、AIは自らのツールを駆使してリードを検証し、攻撃チェーンを構築できます。これにより、バージョン/バナーCVEヒットを未検証のリードとして残すことがなくなります。AIはツール呼び出しを提案し、決定論的ランタイムがそれを実行します。すべてのツールはターゲットに対してスコープゲートされ、サニタイズされ、観測として記録されます。AIが直接ワイヤに触れることはありません。```
netlogic example.com --ai --ai-agent
netlogic example.com --ai --agent-depth --agent-max-steps 24 --agent-max-requests 80
このエージェントはデフォルトで約35個の読み取り専用/安全なアクティブツールを備えています: HTTP/TLS/DNSプローブ、`dir_enum`、`confirm_tech`、`timing_probe`、`cve_probe`（キュレーションされた既知CVEマーカーチェック）、`sqli_boolean`/`sqli_time`、`ssrf_canary`、`idor_diff`、`file_disclosure`、`browser_get`（ヘッドレス、JSチャレンジを通過）、さらにHackerOneのブックキーピング（`record_poc`、`severity_suggest`、`submit_readiness`）。
**オプトインの積極的ツール** — デフォルトではオフ、**許可されていてスコープ内の所有ターゲットのみ**（公開または他人のスキャンでは絶対に使用しない）。各ツールには`--ai-agent`が必要です: