Playbook de l'Agent Sécurisé

Un playbook de sécurité open-source pour les agents IA. Des procédures structurées basées sur l'OWASP qui permettent aux agents d'effectuer des tâches d'ingénierie de sécurité — de la revue de code aux audits de sécurité des agents IA.

Table des matières

• Pourquoi l'utiliser ?
• Ce que c'est
• Démarrage rapide
• Catalogue de compétences
• Agents
• Exemple de résultat
• Procédures
• Architecture
• Fondation OWASP
• Projets connexes
• Contribuer

Pourquoi l'utiliser ?

Sans playbook, demander à un agent IA de « revoir mon code pour la sécurité » donne une liste de contrôle superficielle. Avec ces procédures, l'agent suit une procédure structurée basée sur l'OWASP — testant systématiquement chaque classe de vulnérabilité, produisant des résultats avec des correspondances CWE, des références croisées OpenCRE, des extraits de preuves et un code de correction spécifique.

• Méthodologie cohérente — Chaque évaluation suit une procédure documentée, et non une sollicitation ad hoc. Les résultats sont reproductibles d'une exécution à l'autre et d'un réviseur à l'autre.
• Résultat structuré et exploitable — Les résultats incluent la sévérité, la CWE, les preuves et les étapes de correction avec des exemples de code. Pas d'avertissements vagues.
• Traçabilité inter-normes — Les résultats sont liés à la CWE, à l'ASVS, au WSTG et au NIST 800-53 via OpenCRE pour la cartographie de conformité.
• 17 compétences de sécurité — De l'analyse des CVE des dépendances aux tests d'injection de prompt en passant par la modélisation des menaces multi-agents. Installez-le en tant que plugin Claude Code ou utilisez-le de manière autonome.
• Fonctionne au-delà de Claude Code — Les compétences sont des plugins Claude Code ; les procédures sont des procédures autonomes que tout agent IA peut suivre.

Ce que c'est

Ce n'est pas un framework ni une bibliothèque. Il n'y a pas de code à importer.

Chaque procédure est une procédure de sécurité étape par étape avec des listes de contrôle, des critères de décision et des modèles de sortie. Un agent IA suit la procédure pour produire des résultats cohérents et fondés sur des preuves. Considérez-le comme le playbook d'un analyste SOC — mais écrit pour être exécuté par des agents IA.

Démarrage rapide

Avec Claude Code (recommandé) :

Étape 1 — Enregistrez la place de marché du plugin :

/plugin marketplace add OWASP/secure-agent-playbook

Étape 2 — Installez un ensemble de compétences :

/plugin install code-security-skills@agent-security-playbook
/plugin install ai-security-skills@agent-security-playbook

Étape 3 — Utilisez les compétences en mentionnant la tâche dans la conversation :

« Revois ce code pour les problèmes de sécurité »
« Analyse mes dépendances pour les CVE »
« Audite la configuration de ce serveur MCP »
« Teste ce chatbot pour les injections de prompt »

Claude activera automatiquement la compétence pertinente en fonction du contexte. Voir Catalogue de compétences pour toutes les compétences disponibles et Exemple de résultat pour voir à quoi ressemblent les résultats.

Plugin organisation — Pour les administrateurs d'organisation Claude installant via Plugins d'organisation :

1. Allez sur la dernière version
2. Téléchargez secure-agent-playbook.zip à partir des fichiers de la version
3. Téléchargez le zip à Paramètres de l'organisation > Plugins > Ajouter un plugin

Remarque : N'utilisez pas le bouton « Download ZIP » de GitHub — il imbrique les fichiers dans un sous-répertoire que le validateur de plugin rejette. Utilisez toujours le zip des fichiers de la version.

Développement local — Pour tester à partir d'un clone local au lieu de GitHub :

/plugin marketplace add /path/to/agent-security-playbook
/plugin install code-security-skills@agent-security-playbook
/plugin install ai-security-skills@agent-security-playbook

Sans Claude Code :

Référencez directement les procédures comme procédures pour tout agent IA ou utilisation manuelle :

• Pointez votre agent vers une procédure : « Suis la procédure dans plugins/ai-security-skills/plays/agent-security-audit.md »
• Ou utilisez les procédures comme listes de contrôle pour des revues de sécurité manuelles

Catalogue de compétences

Sécurité du code et de l'infrastructure (code-security-skills)

Sécurité IA et des agents (ai-security-skills)

Agents

Les agents sont des spécialistes de la sécurité autonomes qui invoquent des compétences et produisent des rapports structurés. Chaque agent dispose d'un prompt système ciblé, d'un accès aux outils limité et de compétences préchargées. Utilisez-les individuellement ou en équipe coordonnée.

Utilisation autonome — invoquez n'importe quel agent directement :

« Utilise code-security-reviewer pour revoir src/ »
« Utilise dependency-auditor pour analyser ce projet »

Évaluation en équipe — avec les équipes d'agents activées, le chef d'équipe répartit les spécialistes en parallèle et consolide les résultats dans un seul rapport :

« Effectue une évaluation de sécurité complète de ce projet »

Le chef d'équipe définit le périmètre de la cible, répartit les spécialistes concernés (en ignorant ceux dont le domaine d'intervention n'est pas présent), déduplique les résultats, identifie les chaînes de risques inter-domaines et produit un rapport unifié en utilisant templates/report.md.

Les équipes d'agents nécessitent CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. Voir la documentation Claude Code pour la configuration. Les agents individuels fonctionnent sans ce drapeau.

Exemple de résultat

L'exécution de « Revois src/auth/ pour les problèmes de sécurité » sur une base de code Node.js/Express produit des résultats comme ceux-ci :

Revue de sécurité du code — src/auth/
Périmètre : Node.js/Express, côté serveur, traite les identifiants utilisateur
Résultats : CRITIQUE 1 | ÉLEVÉ 2 | MOYEN 1 | FAIBLE 0

[CRITIQUE] Injection SQL dans la recherche d'utilisateur

• CWE : CWE-89
• OpenCRE : CRE-764-507 — Prévention des injections
• Réf. OWASP : A03:2021 Injection
• Emplacement : src/auth/login.js:42
• Impact : L'attaquant peut extraire toute la table des utilisateurs, contourner l'authentification ou exécuter du SQL arbitraire via le paramètre id falsifié
• Preuve :
  root@kitploit:~

  // src/auth/login.js:42
  const user = await db.query("SELECT * FROM users WHERE id=" + req.params.id);
  

• Correction : Utilisez des requêtes paramétrées :
  root@kitploit:~

  const user = await db.query("SELECT * FROM users WHERE id = $1", [req.params.id]);
  

• Confiance : ÉLEVÉE

Chaque compétence produit des résultats structurés avec sévérité, CWE, preuves et code de correction. Voir examples/ pour des exemples complets de rapports d'évaluation.

Procédures

Procédures de sécurité IA/Agent

L'élément différenciateur — des procédures de sécurité conçues sur mesure pour l'ère des agents IA. Regroupées dans le plugin ai-security-skills.

Procédures d'analyse de code et de dépendances

Valeur immédiate et pratique pour toute base de code. Regroupées dans le plugin code-security-skills.

Planifié

• Niveau 2 : Modélisation des menaces, vérification ASVS, durcissement de l'infrastructure
• Niveau 3 : Liste de contrôle des tests WSTG, orchestration DAST, cartographie de la surface d'attaque
• Niveau 5 : Évaluation de maturité SAMM, cartographie de conformité, rapports agrégés

Architecture

Conception en trois couches — chaque couche se trouve dans le dossier source du plugin afin que l'installation via la place de marché regroupe tout ce dont les compétences ont besoin :

• plugins/<name>/agents/ — Spécialistes de la sécurité autonomes avec des prompts système ciblés, situés dans chaque plugin. Chaque agent invoque une ou plusieurs compétences, opère dans un contexte isolé et produit des rapports structurés. Peut travailler seul ou en équipe coordonnée.
• plugins/<name>/skills/ — Fichiers SKILL.md autonomes suivant la spécification Agent Skills. Distribués via plugins/code-security-skills/ et plugins/ai-security-skills/, enregistrés sur la place de marché via .claude-plugin/marketplace.json. Chaque compétence résume une procédure et référence sa procédure correspondante dans le même plugin.
• plugins/<name>/plays/ — Procédures de référence complètes avec listes de contrôle détaillées, tableaux, critères de décision et exemples. Les compétences les référencent pour une couverture exhaustive.
• plugins/<name>/templates/ et plugins/<name>/data/ — Modèles de sortie (finding.md, ) et jeux de données de référence OWASP (FIASSE v1.0.4, ASVS v5.0, prompts de code sécurisé) que les compétences chargent à l'exécution.

Les agents orchestrent, les compétences exécutent, les procédures fournissent la procédure complète. Les contributeurs modifient les procédures. Cela signifie que le playbook fonctionne avec n'importe quel agent IA (il suffit de le pointer vers une procédure), tandis que les utilisateurs de Claude Code bénéficient d'une installation basée sur les plugins avec des agents et des compétences.

Fondation OWASP

Toutes les procédures référencent les normes et jeux de données OWASP :

• OWASP Top 10 — Risques des applications web
• OWASP API Security Top 10 — Risques spécifiques aux API
• OWASP Top 10 pour les Applications LLM — Risques IA/LLM
• OWASP Agentic Security Initiative — Risques des agents autonomes (Top 10 pour les Applications Agentiques)
• OWASP ASVS — Exigences de vérification de sécurité
• OWASP MASVS — Standard de vérification de sécurité des applications mobiles
• OWASP AISVS — Standard de vérification de sécurité de l'IA
• OWASP WSTG — Méthodologie de test
• OWASP SAMM — Modèle de maturité des programmes de sécurité
• OWASP Cheat Sheet Series — Conseils de sécurité pour les développeurs
• OWASP FIASSE — Framework for Inherently Adaptive and Securable Engineering (v1.0.4)

Projets connexes

Contribuer

Voir CONTRIBUTING.md pour les directives détaillées.

Les nouvelles procédures doivent :

• Résoudre une tâche de sécurité bien définie
• Inclure des conditions de déclenchement claires (quand cette procédure doit-elle s'exécuter ?)
• Suivre une procédure structurée avec des points de contrôle
• Produire des résultats en utilisant le format templates/finding.md du plugin
• Référencer les normes OWASP lorsque cela est pertinent
• Privilégier les outils existants (semgrep, trivy, osv-scanner, trufflehog) plutôt que de réimplémenter la détection
• Se trouver dans le dossier plays/ du plugin approprié afin d'être inclus dans l'installation via la place de marché

Licence

Sous licence Creative Commons Attribution 4.0 International (CC-BY-4.0). Voir THIRD_PARTY_NOTICES.md pour l'attribution du contenu des projets OWASP en amont.