
Pipeline automatisé SBOM-to-VEX utilisant un système d'IA multi-agent sécurisé pour analyser les CVE, raisonner sur l'exploitabilité et générer des documents VEX CycloneDX signés conformément aux directives OWASP GenAI.
Générer automatiquement des documents CycloneDX VEX signés à partir de SBOM à l'aide d'un pipeline d'IA multi-agents sécurisé, construit conformément aux directives de l'OWASP GenAI Security Project.
La génération d'un SBOM fait apparaître des centaines de CVE. En pratique, plus de 90 % ne sont pas exploitables dans le contexte d'exécution d'un produit spécifique. Sans document Vulnerability Exploitability eXchange (VEX), chaque outil en aval — Dependency-Track, contrôles de version, listes de vérification d'approvisionnement — se noie dans les faux positifs.
Consultez le WIKI pour plus de détails techniques et les résultats des tests
La génération manuelle de VEX est chronophage et ne passe pas à l'échelle. Un analyste expérimenté peut passer des heures à évaluer un seul composant. Un SBOM de production peut contenir 500 à 2 000 composants.
Ce projet automatise ce pipeline de raisonnement — de manière sécurisée, sans dépendance à un fournisseur, toutes les données restant sur votre infrastructure.
Motivation concrète : En 2024, la chercheuse en sécurité Johanna Curiel a documenté exactement ce problème lors de l'analyse du Kubernetes Java Client. Le scanner OSV a identifié en quelques secondes une CVE à haut risque dans
com.diffplug.spotless:spotless-maven-plugin 1.17.0. Déterminer qu'elle étaitnot_affected(plugin de build, jamais exécuté à l'exécution) a nécessité des heures d'analyse manuelle. Ce projet automatise cette étape de raisonnement.
Quatre zones de sécurité. Rien ne franchit une frontière sans validation explicite.
┌─────────────────────────────────────────────────────────────────┐
│ 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 │
└─────────────────────────────────────────────────────────────────┘
Ce projet est conçu conformément à l'OWASP Top 10 for LLM Applications 2025 et à l'OWASP Top 10 for Agentic Applications 2026.
| Risque OWASP | ID | Atténuation dans ce projet |
|---|---|---|
| Injection de prompt | LLM01 | Tous les champs SBOM sont assainis avant l'injection dans le LLM ; liste de blocage des motifs d'injection |
| Divulgation d'informations sensibles | LLM02 | Filtre de données personnelles (PII) sur toutes les sorties des agents ; filtre des chemins internes |
| Gestion inappropriée des sorties | LLM05 | Validation du schéma CycloneDX avant signature ; nouvelle tentative en cas d'échec |
| Agentivité excessive | LLM06 | Outils en lecture seule pendant l'analyse ; validation humaine (HITL) pour toutes les décisions CVSS ≥ 7.0 |
| Fuite du prompt système | LLM07 | Politiques internes séparées du prompt système |
| Faiblesse des vecteurs / embeddings | LLM08 | Vecteurs stockés signés ; provenance vérifiée avant l'injection dans le contexte |
| Consommation non bornée | LLM10 | MaxMessageTermination(20) ; budget de tokens par composant ; délai d'expiration NVD |
La validation humaine (human-in-the-loop) est obligatoire. Une déclaration VEX
not_affectedpour une CVE de gravité élevée constitue une assertion de niveau juridique. Aucun VEX n'est signé sans l'approbation d'un réviseur humain. Ce comportement n'est pas configurable.
| Composant | Outil | Remarques |
|---|---|---|
| Orchestration des agents | AutoGen AgentChat v0.4 | Multi-agents, utilisation d'outils, hooks de messages |
| LLM (recommandé) | Qwen2.5-Coder-32B | Meilleur raisonnement JSON structuré + sécurité |
| Serveur LLM | vLLM (prod) / Ollama (dev) | API compatible OpenAI |
| Données CVE | API NVD v2 + OSV.dev + EPSS | Tous gratuits, aucune clé API requise |
| Stockage vectoriel | Qdrant | Auto-hébergé, décisions VEX passées |
| Embeddings | all-MiniLM-L6-v2 (sentence-transformers) | Entièrement local |
| Formats SBOM | CycloneDX 1.4–1.7 (JSON/XML), SPDX 2.3/3.0 | Validés par schéma à l'ingestion |
| Sortie VEX | CycloneDX 1.6 VEX | Validé par schéma avant signature |
| Signature | cosign (Sigstore keyless) | Horodaté, journalisé pour audit |
| Journal d'audit | PostgreSQL (append-only, pgaudit) | Chaque décision d'agent enregistrée |
Tout fonctionne sur site. Aucune donnée ne quitte votre infrastructure.
Matériel (production) :
Matériel (développement / petits SBOM) :
llama3.1:8b via OllamaLogiciels :
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
Le pipeline va :
Copiez .env.example vers .env et définissez :