Sécurité · 7 min
Shannon : l'agent IA qui pirate ton propre site avant les hackers
L'agent IA open source qui analyse ton code, attaque ton site comme le ferait un vrai hacker, et te ressort la liste des failles qu'il a trouvées (avec la démonstration pour chacune).
Ce qu’il y a dedans
- Le problème que tout le monde a
- Shannon, c'est quoi exactement
- Le calcul
- Prérequis
L'agent IA open source qui analyse ton code, attaque ton site comme le ferait un vrai hacker, et te ressort la liste des failles qu'il a trouvées (avec la démonstration pour chacune). Tu pirates ton site avant qu'un autre le fasse, et tu corriges les failles avant qu'elles coûtent cher.
Le problème que tout le monde a
Quand tu découvres une faille sur ton site, c'est souvent qu'il est trop tard : t'as un client qui te signale un problème, ou ta base est déjà fuitée, ou un script kiddie a déjà défacé ta page.
Les solutions classiques :
- Faire un vrai pentest pro : 5 000 à 15 000 € la mission, 2 semaines de délai. Inaccessible pour un solo ou une early-stage.
- Utiliser des scanners auto comme Burp ou OWASP ZAP : nombreux faux positifs, manquent les vraies failles métier, demandent un expert pour interpréter.
- Ne rien faire et croiser les doigts : tactique populaire mais coûteuse (RGPD = jusqu'à 4 % du CA mondial en amende).
Shannon résoud ça en simulant un vrai pentester. Pas un scanner bête qui balance des requêtes au hasard : un agent IA qui lit ton code, comprend ta logique métier, et tente vraiment d'exploiter les failles. Quand il en trouve une, il te livre la preuve de concept fonctionnelle.
Shannon, c'est quoi exactement
Open source AGPL-3.0 sur GitHub : github.com/KeygraphHQ/shannon. 41 900 stars sur GitHub, c'est devenu la référence open source du pentest IA en 2026.
Trois choses qui le différencient :
- Il lit ton code source. C'est pas un scanner externe qui balance des requêtes en aveugle. Tu lui donnes l'accès à ton repo, il comprend ton architecture, ta logique métier, tes routes API. C'est ce qu'on appelle du pentest white-box (boite blanche, par opposition au black-box où le pentester sait rien).
- Il exécute de vrais exploits. Quand il pense qu'il y a une faille, il essaie vraiment de l'exploiter contre ton site (en environnement de test). S'il y arrive, il garde la preuve. S'il n'y arrive pas, il jette l'hypothèse. Résultat : zero faux positif. Chaque faille rapportée vient avec sa preuve fonctionnelle.
- Il cherche les failles qui coûtent cher. Shannon cible les 5 catégories OWASP les plus dangereuses :
- Injection SQL (la base de données peut être dumpée)
- XSS (un attaquant peut exécuter du code dans le navigateur d'un visiteur)
- Broken Authentication (un visiteur peut se faire passer pour un autre)
- Authorization flaws (un user peut accéder à des données d'un autre user)
- SSRF (le serveur peut être forcé à attaquer des ressources internes)
C'est ce trio (injection + auth + autz) qui fait 80 % des breaches qui finissent dans la presse.
Le calcul
Tu peux scanner ton site 4 fois par an pour environ 200 € d'API. Au lieu de 8 000 € pour un pentest annuel + 50 semaines où tu te demandes si t'as une faille.
Prérequis
Shannon tourne dans un terminal (Mac, Linux, ou Windows via WSL). Tu vas avoir besoin de :
- Docker installé (c'est ce qui isole les tests pour pas casser ton vrai système). Lien d'install
- Node.js 18 ou plus installé. nodejs.org
- Une clé API Anthropic (~50 $ par scan complet en consommation). Tu la crées sur console.anthropic.com
- Le code source de ton site cloné en local (pour que Shannon puisse le lire)
- Une URL de test (pas ton site en prod, on va y revenir)
Si t'as jamais touché à Docker, compte 30 min pour la première install. Ensuite, c'est une commande.
Setup en 10 minutes
Étape 1 — Configure ta clé API Anthropic
Dans ton terminal :
export ANTHROPIC_API_KEY=sk-ant-ta-cle-ici
Pour la rendre permanente, ajoute cette ligne à ton ~/.zshrc (Mac) ou ~/.bashrc (Linux).
Étape 2 — Déploie une copie de test de ton site
C'est clé : ne JAMAIS scanner ton site en prod. Tu déploies une copie sur un environnement de staging (Vercel, Netlify, ou un VPS).
Étape 3 — Lance le scan
Une seule commande :
npx @keygraph/shannon start -u https://staging.tonsite.com -r /chemin/vers/ton/repo
Où :
- -u est l'URL de ton site de staging
- -r est le chemin local vers ton code source
Shannon télécharge ses dépendances la première fois (Docker images), puis lance le scan. Compte 1 à 1,5h. Tu peux laisser tourner et faire autre chose.
Étape 4 — Lire le rapport
Le rapport sort dans :
workspaces/[hostname]_[sessionId]/deliverables/comprehensive_security_assessment_report.md
C'est un fichier Markdown avec :
- Chaque faille trouvée
- Le niveau de sévérité (critique / haute / moyenne / basse)
- L'emplacement dans ton code source
- La preuve d'exploitation fonctionnelle (étapes copier-coller pour reproduire)
Tu corriges les failles dans ton code, tu redeploys, tu reslances Shannon pour vérifier que tout est patché.
3 use cases concrets
1. Audit avant lancement
Avant ton premier lancement public, fais un scan complet. Tu paies 50 $ d'API et tu évites le risque de te faire défoncer la base 3 jours après ton Product Hunt.
2. Scan après chaque release majeure
Chaque fois que tu sors une nouvelle feature critique (auth, paiement, gestion de fichiers, API client), relance Shannon sur staging. Tu attrapes les régressions sécu avant qu'elles partent en prod.
3. Audit trimestriel automatique
Programme un scan tous les trimestres sur ton staging à jour. Coût annuel : 200 €. C'est moins cher que ton abo Adobe et ça peut t'éviter une amende CNIL.
Mes 3 conseils pour bien l'utiliser
- Toujours scanner un environnement de staging, JAMAIS la prod. Shannon exécute de vrais exploits. Sur ton site prod, il pourrait corrompre des données, envoyer des mails aux vrais clients, ou créer des effets de bord gênants. Sur staging, t'as pas ce risque.
- Réserve un budget API dédié. ~50 $ par scan, c'est l'ordre de grandeur. Si t'as un mois chargé et que tu scannes 4 fois, t'es à 200 $ rien que sur Shannon. Ouvre un projet Anthropic dédié pour suivre ce coût séparément de tes autres usages Claude.
- Combine avec un fichier config.yaml pour les apps avec auth. Beaucoup de failles sont derrière un login. Sans creds, Shannon ne les voit pas. Donne-lui un user de test dans la config pour qu'il scanne aussi les pages connectées. Documentation dans le repo GitHub.
⚠️ Le truc légal à absolument retenir
Shannon doit être utilisé uniquement sur tes propres sites, ou des sites pour lesquels tu as une autorisation écrite explicite du propriétaire.
Scanner un site sans autorisation = intrusion dans un système de traitement automatisé de données. En France, c'est jusqu'à 3 ans de prison et 100 000 € d'amende (article 323-1 du code pénal). Aux US et au UK, similaire ou pire.
C'est un outil offensif. Utilisé sur ton propre code, c'est une protection. Utilisé sur autrui, c'est illégal. Garde ça en tête.
Les limites à garder en tête
- Ça couvre pas tout. Shannon cible 5 catégories OWASP critiques. Il ne détecte pas tout : CVEs sur tes dépendances, headers de sécurité manquants, mauvaise config TLS, secrets dans le code, etc. Pour ces angles, combine avec d'autres outils (Snyk, Trivy, GitGuardian).
- Ça marche pas en boite noire pure. Shannon a besoin du code source. Si tu n'as pas accès au code (site WordPress hébergé chez quelqu'un, app SaaS tierce), ce n'est pas pour toi.
- C'est seulement supporte les modèles Claude. Pas de fallback OpenAI ou Gemini officiel. Si Anthropic a un désastre de service, Shannon est down avec.
- Ça peut casser des trucs sur staging. Shannon est destructif par design. Sur staging, ce n'est pas grave (tu peux reset), mais si tu n'as pas vraiment un staging isolé, tu peux te taper des effets de bord (mails de notif envoyés en boucle, webhooks déclenchés, etc.). Isole bien ton staging avant.
Le mot de la fin
La sécurité web, c'est comme l'assurance : t'en parles jamais jusqu'au jour où tu en as besoin. Sauf qu'avec le RGPD et les amendes à 4 % du CA, le « je verrai plus tard » peut tuer une boîte en quelques heures.
Shannon résoud le problème d'accès : avant lui, un vrai pentest coûtait 5-15k€. Maintenant, pour 50 $ d'API, tu fais un scan plus approfondi que beaucoup d'audits faits par des humains payés 1000 € la journée. C'est pas magique, c'est pas parfait, mais c'est radicalement plus accessible.
Lance ton premier scan ce week-end sur un staging. Tu vas trouver des trucs. Tu vas les corriger. Et tu vas dormir un peu mieux.
