
AI 기반의 자동 위협 분석 파이프라인으로, 파일, URL, IP, 도메인 또는 이미지를 전문 보안 분석 도구로 라우팅하고 통합된 YARA 및 Sigma 규칙을 사용하여 전문적인 PWNDoc 보고서를 생성합니다.
파일, URL, IP, 도메인 또는 이미지를 제출하세요. SecFlow는 이를 적절한 분석기로 라우팅하고, AI 모델이 다음에 무엇을 조사할지 결정하도록 하며, YARA 규칙, SIGMA 규칙, MITRE ATT&CK 매핑 및 인쇄 가능한 PDF 내보내기가 포함된 보고서를 생성합니다.
SecFlow는 보안 분석가, SOC 팀 및 연구자를 위한 오픈소스 위협 분석 파이프라인입니다. 여러 도구를 수동으로 실행하고 그 출력을 직접 상호 연관시키는 대신, SecFlow에 하나의 입력을 전달하면 다음과 같이 동작합니다:
오케스트레이터는 단일 LangGraph.js 상태 그래프 위에 구축된 TypeScript 서비스입니다. 모델은 네트워크나 파일 시스템에 직접 접근하지 않습니다. 백엔드가 이미 검증한 대상 카탈로그에서만 선택할 수 있습니다.
| 기능 | 세부 사항 |
|---|---|
| AI 기반 라우팅 | OpenRouter 모델(기본값 nvidia/nemotron-3-ultra-550b-a55b:free, 구성 가능)이 구조화된 출력을 사용하여 각 패스 후 다음 분석기를 선택합니다 |
| 다섯 가지 특화 분석기 | 악성코드, 스테가노그래피, 정찰, 웹 취약점, 매크로/오피스 |
| 결정론적 첫 번째 패스 | 파일 및 대상 규칙이 첫 번째 분석기를 선택합니다. 모델은 유형이 모호할 때만 참조됩니다 |
| 다운로드 및 분석 | 분석기 출력에서 발견된 페이로드를 다운로드하여 적절한 분석기로 라우팅함으로써 IOC를 추적합니다 |
| 증거 기반 YARA | 분석당 2–5개의 규칙으로, YARA-X로 컴파일되며, 각 규칙은 이를 생성한 증거를 인용합니다 |
| 증거 기반 SIGMA | 서로 다른 로그 소스를 다루는 2–4개의 규칙으로, 구조적으로 검증되며, 지표는 증거와 대조하여 확인됩니다 |
| MITRE ATT&CK 매핑 | 발견 사항은 전술 이름과 함께 기법 ID에 매핑됩니다 |
| 이중 보고서 형식 | 자체 포함 HTML(PDF로 인쇄) 및 구조화된 JSON |
| SSRF 보호 | 사설, 루프백, 링크 로컬 및 클라우드 메타데이터 대상은 분석 전과 분석 중에 차단됩니다 |
| 제한된 실행 | 패스, 모델 사이클, 도구 호출 및 실제 경과 시간 예산과 기록된 종료 사유 |
| React 대시보드 | 분석을 제출하고, 파이프라인 진행 상황을 추적하며, 분석기별 결과를 탐색합니다 |
| 독립 실행형 분석기 | 각 마이크로서비스는 자체 REST API를 노출하며 단독으로 사용할 수 있습니다 |
SecFlow는 하나의 Docker 네트워크에서 오케스트레이터와 다섯 개의 독립적인 분석기 컨테이너로 구성됩니다. 오케스트레이터는 라우팅, 상태, 예산 및 보고를 담당합니다. 분석기는 파이프라인에 대해 아무것도 알지 못합니다.
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, worker 컨테이너를 시작합니다.
| 서비스 | 포트 | 역할 |
|---|---|---|
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이 필요합니다.
파일 분석:
curl -X POST http://localhost:5000/api/smart-analyze \
-F "file=@/path/to/suspicious.exe" \
-F "passes=3"