
AI駆動の自動脅威分析パイプラインで、ファイル、URL、IP、ドメイン、画像を専門のセキュリティアナライザーにルーティングし、統合されたYARAおよびSigmaルールを使用してプロフェッショナルなPWNDocレポートを生成します。
ファイル、URL、IP、ドメイン、または画像を送信します。SecFlow はそれを適切なアナライザーにルーティングし、AI モデルに次に何を調査するかを判断させ、YARA ルール、SIGMA ルール、MITRE ATT&CK マッピング、および印刷可能な PDF エクスポートを含むレポートを生成します。
SecFlow は、セキュリティアナリスト、SOC チーム、研究者向けのオープンソースの脅威分析パイプラインです。個別のツールを手動で実行してその出力を自分で相関させる代わりに、SecFlow に 1 つの入力を渡すだけで、次のことを行います:
オーケストレーターは、単一の LangGraph.js ステートグラフ上に構築された TypeScript サービスです。モデルはネットワークやファイルシステムに直接アクセスすることはありません。バックエンドがすでに検証済みのターゲットのカタログからのみ選択できます。
| 機能 | 詳細 |
|---|---|
| AI駆動ルーティング | OpenRouterモデル(デフォルト nvidia/nemotron-3-ultra-550b-a55b:free、設定可能)が、各パスの後に構造化出力を使用して次のアナライザーを選択します |
| 5つの専門アナライザー | マルウェア、ステガノグラフィー、偵察、Web脆弱性、マクロ/Office |
| 決定論的な初回パス | ファイルとターゲットのルールが最初のアナライザーを選択します。モデルはタイプが曖昧な場合にのみ参照されます |
| ダウンロードと分析 | アナライザーの出力で見つかったペイロードをダウンロードしてIOCを追跡し、適切なアナライザーにルーティングします |
| エビデンスに基づくYARA | 分析ごとに2~5個のルールをYARA-Xでコンパイルし、それぞれが生成の根拠となったエビデンスを引用します |
| エビデンスに基づくSIGMA | 異なるログソースをカバーする2~4個のルールを構造的に検証し、インジケーターをエビデンスと照合します |
| MITRE ATT&CKマッピング | 検出結果は戦術名とともにテクニックIDにマッピングされます |
| デュアルレポート形式 | 自己完結型HTML(PDFに印刷可能)と構造化JSON |
| SSRF保護 | プライベート、ループバック、リンクローカル、およびクラウドメタデータのターゲットは、分析前および分析中にブロックされます |
| 制限付き実行 | パス、モデルサイクル、ツール呼び出し、および実時間の予算と、記録された終了理由 |
| Reactダッシュボード | 分析を送信し、パイプラインの進捗を追跡し、アナライザーごとに結果を閲覧します |
| スタンドアロンアナライザー | 各マイクロサービスは独自のREST APIを公開し、単独で使用できます |
SecFlowは、1つのDockerネットワーク上にあるオーケストレーターと5つの独立したアナライザーコンテナで構成されています。オーケストレーターはルーティング、状態、予算、およびレポートを管理します。アナライザーはパイプラインについて何も知りません。
flowchart TD
U["Input: file, URL, IP, domain, image"] --> C["Input Classifier<br/>magic bytes + routing rules"]
C -->|"rule matched (no AI)"| A1["First analyzer"]
C -->|"ambiguous"| M["Model decision"]
subgraph LOOP ["LangGraph loop (3, 4 or 5 passes, bounded)"]
A1 --> S[("Findings + raw-output store")]
S --> M
M -->|"analyze_* + targetId"| T["Analyzer tool<br/>HTTP to microservice"]
T --> S
M -->|"finish"| X(("exit loop"))
end
X --> F["Finalize"]
F --> Y["generate_yara<br/>YARA-X compile check"]
Y --> G["generate_sigma<br/>structural validation"]
G --> R["generate_report<br/>JSON + HTML"]
flowchart LR
O["Orchestrator<br/>:5000"] -->|HTTP| MW["Malware<br/>:5001"]
O -->|HTTP| ST["Steg<br/>:5002"]
O -->|HTTP| RC["Recon<br/>:5003"]
O -->|HTTP| WB["Web<br/>:5005"]
O -->|HTTP| MC["Macro<br/>:5006"]
O -->|"chat completions"| OR["OpenRouter"]
MW --> VT["VirusTotal"]
MC --> VT
sequenceDiagram
participant Client
participant Orch as Orchestrator
participant An as Analyzer
participant LLM as OpenRouter model
Client->>Orch: POST /api/smart-analyze
Orch->>Orch: Classify input + SSRF guard
Orch->>An: Pass 1 (deterministic, no model call)
An-->>Orch: findings + raw_output
loop until finish or a budget is reached
Orch->>LLM: bounded evidence summary + allowed tools
LLM-->>Orch: action + targetId + reasoning
Orch->>Orch: validate action and resolve targetId
Orch->>An: run selected analyzer
An-->>Orch: findings + raw_output
end
Orch->>Orch: YARA, SIGMA, report
Orch-->>Client: job id, risk score, report URLs
{ targetId } を受け入れます。IDは信頼された実行ごとのカタログで解決でき、ツールの許可されたターゲット種別に一致する必要があります。モデルはURL、パス、コマンド、サービスアドレスを提供できません。<untrusted_evidence> 境界で囲まれます。モデルは境界付きの要約と参照を受け取り、生のサンプルバイトや無制限のダンプを受け取ることはありません。プロンプトはあくまでガイダンスです。実際の制限はスキーマとコードによって強制されます。500 を返します。アナライザーの出力が捏造されることはありません。すべての実行は記録された理由とともに終了します。
| 理由 | 意味 |
|---|---|
model_finished | モデルが推論とともに finish を返した |
no_artifacts | 未試行のツール/ターゲットのペアが残っていない |
max_passes | 要求されたパス予算(3、4、または5)に達した |
max_cycles | MODEL_MAX_CYCLES 回のモデル決定が使用された |
max_tool_calls | MODEL_MAX_TOOL_CALLS 回のアナライザー実行が使用された |
duplicate_analysis | モデルがすでに試行済みのツール/ターゲットのペアを要求した |
unsupported_input | 入力を受理するアナライザーが存在しない |
fatal_error | モデル契約の失敗または無効なツール出力 |
git clone https://github.com/aradhyacp/SecFlow.git
cd SecFlow/backend
cp .env.example .env
.env を編集します:
# Core keys
OPENROUTER_API_KEY=your_openrouter_api_key_here # Required
VIRUSTOTAL_API_KEY=your_vt_api_key_here # Recommended
# Optional: additional OSINT capabilities
NUMVERIFY_API_KEY=your_numverify_key # Phone number lookups
THREATFOX_API_KEY=your_threatfox_key # Higher ThreatFox rate limits
ipAPI_KEY=your_ipapi_key # Higher ip-api.com rate limits
# Orchestrator model and limits
OPENROUTER_MODEL=nvidia/nemotron-3-ultra-550b-a55b:free
MODEL_MAX_CYCLES=12
TOTAL_ANALYSIS_TIMEOUT_MS=600000
ALLOW_PRIVATE_TARGETS=false # true only for local demos
docker compose up -d
これにより、6つのコアサービスに加え、Stegアナライザーが使用するPostgreSQL、Redis、ワーカーのコンテナが起動します。
| サービス | ポート | 役割 |
|---|---|---|
orchestrator | 5000 | パイプラインコントローラーおよびメインエントリーポイント |
malware-analyzer | 5001 | Ghidraによる逆コンパイル + VirusTotal |
steg-analyzer | 5002 | binwalk、zsteg、steghide、ExifTool |
recon-analyzer | 5003 | ip-api、ThreatFox、OSINT |
web-analyzer | 5005 | HTTP脆弱性スキャナー + ヘッダー監査 |
macro-analyzer | 5006 | oletools (olevba) + VirusTotal |
注記: 初回起動には数分かかる場合があります。Malware AnalyzerはGhidra 12.0.1(約500 MB)をダウンロードし、JDK 21のJVMが必要です。
ファイルを分析する: