
SBOM-to-VEX 파이프라인을 자동화하며, CVE를 분석하고, 악용 가능성을 추론하며, OWASP GenAI 지침을 준수하는 서명된 CycloneDX VEX 문서를 생성하는 안전한 다중 에이전트 AI 시스템입니다.
OWASP GenAI Security Project 가이드라인에 따라 구축된 안전한 멀티 에이전트 AI 파이프라인을 사용하여 SBOM으로부터 서명된 CycloneDX VEX 문서를 자동으로 생성합니다.
SBOM을 생성하면 수백 개의 CVE가 드러납니다. 실제로 90% 이상은 특정 제품의 런타임 컨텍스트에서 악용 가능하지 않습니다. VEX(Vulnerability Exploitability eXchange) 문서가 없으면 Dependency-Track, 릴리스 게이트, 조달 체크리스트 등 모든 다운스트림 도구가 오탐으로 넘쳐나게 됩니다.
더 자세한 기술 정보와 테스트 결과는 WIKI를 참고하세요
수동 VEX 생성은 시간이 많이 걸리고 확장이 불가능합니다. 숙련된 분석가는 단일 컴포넌트를 평가하는 데 몇 시간을 소비할 수 있습니다. 프로덕션 SBOM에는 500~2,000개의 컴포넌트가 포함될 수 있습니다.
이 프로젝트는 그러한 추론 파이프라인을 자동화합니다 — 안전하게, 벤더 종속 없이, 모든 데이터가 사용자의 인프라에 남도록 합니다.
실제 사례 동기: 2024년 보안 연구원 Johanna Curiel은 Kubernetes Java Client를 분석하면서 바로 이 문제를 문서화했습니다. OSV 스캐너는
com.diffplug.spotless:spotless-maven-plugin 1.17.0에서 고위험 CVE를 몇 초 만에 식별했습니다. 그것이not_affected(빌드 시점 플러그인으로 런타임에 실행되지 않음)임을 판별하는 데는 몇 시간의 수동 분석이 필요했습니다. 이 프로젝트는 그 추론 단계를 자동화합니다.
네 개의 보안 영역. 명시적 검증 없이는 어떤 것도 경계를 넘지 않습니다.
┌─────────────────────────────────────────────────────────────────┐
│ ZONE 1 — Input ingestion (no LLM) │
│ SBOM upload → Schema validate → Sanitise → SHA-256 audit hash │
└────────────────────────────┬────────────────────────────────────┘
│
┌────────────────────────────▼────────────────────────────────────┐
│ ZONE 2 — OWASP guardrail middleware │
│ Prompt guard (LLM01) · Output filter (LLM02/05) │
│ Agency limiter (LLM06) · Token budget (LLM10) │
└────────────────────────────┬────────────────────────────────────┘
│
┌────────────────────────────▼────────────────────────────────────┐
│ ZONE 3 — Multi-agent pipeline (AutoGen AgentChat) │
│ │
│ Orchestrator │
│ ├── CVE Analyst NVD v2 + OSV + EPSS per component │
│ ├── Exploit Reasoner Call graph · LLM reasoning · RAG │
│ └── VEX Writer CycloneDX 1.6 schema-validated │
│ │
│ Vector store (Qdrant) — signed past VEX decisions │
└────────────────────────────┬────────────────────────────────────┘
│
┌────────────────────────────▼────────────────────────────────────┐
│ ZONE 4 — Output, signing, audit │
│ Human-in-the-loop gate → cosign/GPG sign → audit log │
└─────────────────────────────────────────────────────────────────┘
이 프로젝트는 OWASP Top 10 for LLM Applications 2025 및 OWASP Top 10 for Agentic Applications 2026을 기준으로 설계되었습니다.
| OWASP 위험 | ID | 이 프로젝트에서의 완화 조치 |
|---|---|---|
| 프롬프트 인젝션 | LLM01 | LLM 주입 전 모든 SBOM 필드 정제; 인젝션 패턴 차단 목록 |
| 민감 정보 노출 | LLM02 | 모든 에이전트 출력에 PII 스크러버 적용; 내부 경로 필터 |
| 부적절한 출력 처리 | LLM05 | 서명 전 CycloneDX 스키마 검증; 실패 시 재시도 |
| 과도한 권한 | LLM06 | 분석 중 읽기 전용 도구 사용; CVSS ≥ 7.0인 모든 판정에 HITL 게이트 적용 |
| 시스템 프롬프트 유출 | LLM07 | 내부 정책을 시스템 프롬프트와 분리 |
| 벡터 / 임베딩 취약점 | LLM08 | 저장된 벡터에 서명; 컨텍스트 주입 전 출처 확인 |
| 무제한 소비 | LLM10 | MaxMessageTermination(20); 컴포넌트별 토큰 예산; NVD 타임아웃 |
휴먼 인 더 루프(Human-in-the-loop)는 필수입니다. 고위험 CVE에 대한 VEX
not_affected진술은 법적 수준의 단언입니다. 사람 검토자의 승인 없이는 어떤 VEX도 서명되지 않습니다. 이는 구성 가능한 사항이 아닙니다.
| 구성 요소 | 도구 | 비고 |
|---|---|---|
| 에이전트 오케스트레이션 | AutoGen AgentChat v0.4 | 멀티 에이전트, 도구 사용, 메시지 훅 |
| LLM (권장) | Qwen2.5-Coder-32B | 구조화된 JSON + 보안 추론에 최적 |
| LLM 서버 | vLLM (프로덕션) / Ollama (개발) | OpenAI 호환 API |
| CVE 데이터 | NVD v2 API + OSV.dev + EPSS | 모두 무료, API 키 불필요 |
| 벡터 저장소 | Qdrant | 자체 호스팅, 과거 VEX 결정 저장 |
| 임베딩 | all-MiniLM-L6-v2 (sentence-transformers) | 완전 로컬 |
| SBOM 형식 | CycloneDX 1.4–1.7 (JSON/XML), SPDX 2.3/3.0 | 수집 시 스키마 검증 |
| VEX 출력 | CycloneDX 1.6 VEX | 서명 전 스키마 검증 |
| 서명 | cosign (Sigstore 키리스) | 타임스탬프 적용, 감사 로그 기록 |
| 감사 로그 | PostgreSQL (추가 전용, pgaudit) | 모든 에이전트 결정 기록 |
모든 것이 온프레미스에서 실행됩니다. 어떤 데이터도 인프라 외부로 나가지 않습니다.
하드웨어 (프로덕션):
하드웨어 (개발 / 소규모 SBOM):
llama3.1:8b 사용소프트웨어:
git clone https://github.com/your-org/sbom-vex-agent
cd sbom-vex-agent
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
# Development — Ollama (CPU/GPU, any laptop)
ollama pull llama3.1
ollama serve
# Production — vLLM (GPU required)
python -m vllm.entrypoints.openai.api_server \
--model Qwen/Qwen2.5-Coder-32B-Instruct \
--gpu-memory-utilization 0.90 \
--host 0.0.0.0 --port 8000
docker compose up -d # starts Qdrant + PostgreSQL
python -m vex_agent analyse \
--sbom path/to/your-sbom.cdx.json \
--output path/to/output.vex.json
파이프라인은 다음을 수행합니다:
.env.example을 .env로 복사한 후 다음을 설정하세요:
# LLM backend
VLLM_BASE_URL=http://localhost:8000/v1 # or Ollama: http://localhost:11434/v1
LLM_MODEL=Qwen2.5-Coder-32B-Instruct # or llama3.1 for dev
# Services
QDRANT_URL=http://localhost:6333
AUDIT_DB_URL=postgresql://audit:secret@localhost:5432/audit
# Signing (leave blank to use cosign keyless via Sigstore OIDC)
GPG_KEY_ID= # optional: use GPG instead
sbom-vex-agent/
├── vex_agent/
│ ├── ingest.py # Zone 1: SBOM validation and sanitisation
│ ├── guardrails.py # Zone 2: OWASP middleware (GuardrailedAgent)
│ ├── agents/
│ │ ├── orchestrator.py
│ │ ├── cve_analyst.py
│ │ ├── exploit_reasoner.py
│ │ └── vex_writer.py
│ ├── tools/
│ │ ├── nvd.py # NVD v2 API client
│ │ ├── osv.py # OSV.dev client
│ │ └── epss.py # EPSS scoring
│ ├── vector_store.py # Qdrant integration + provenance signing
│ ├── hitl.py # Human-in-the-loop review gate
│ └── sign.py # Zone 4: cosign / GPG signing
├── schemas/
│ ├── cdx-1.6.schema.json
│ └── cdx-1.6-vex.schema.json
├── tests/
├── docker-compose.yml
├── .env.example
└── requirements.txt
에이전트는 CycloneDX 1.6 VEX 문서를 생성합니다. 단일 컴포넌트에 대한 출력 예시는 다음과 같습니다:
{
"bomFormat": "CycloneDX",
"specVersion": "1.6",
"version": 1,
"metadata": {
"timestamp": "2026-04-26T10:00:00Z",
"tools": [{ "name": "sbom-vex-agent", "version": "1.0.0" }]
},
"vulnerabilities": [
{
"id": "CVE-2021-37714",
"affects": [{ "ref": "pkg:maven/com.diffplug.spotless/[email protected]" }],
"analysis": {
"state": "not_affected",
"justification": "vulnerable_code_not_in_execute_path",
"detail": "Plugin executes only at build time; not present in deployed runtime."
}
}
]
}
유효한 state 값: affected · not_affected · fixed · under_investigation