Compétence d'Analyse de Sécurité
Auditez votre configuration Claude Code pour détecter les problèmes de sécurité avec AgentShield.
Quand l'Activer
- Lors de la configuration d'un nouveau projet Claude Code
- Après avoir modifié
.claude/settings.json,CLAUDE.mdou les configurations MCP - Avant de valider les modifications de configuration
- Lors de l'intégration dans un nouveau dépôt avec des configurations Claude Code existantes
- Pour des contrôles d'hygiène de sécurité périodiques
Ce Qu'il Analyse
| Fichier | Vérifications |
|---|---|
CLAUDE.md | Secrets codés en dur, instructions d'exécution automatique, schémas d'injection d'instructions |
settings.json | Listes d'autorisation trop permissives, listes de refus manquantes, indicateurs de contournement dangereux |
mcp.json | Serveurs MCP risqués, secrets d'environnement codés en dur, risques de chaîne d'approvisionnement npx |
hooks/ | Injection de commande via interpolation, exfiltration de données, suppression silencieuse d'erreurs |
agents/*.md | Accès aux outils sans restriction, surface d'injection d'instructions, spécifications de modèle manquantes |
Prérequis
AgentShield doit être installé. Vérifiez et installez si nécessaire :
# Vérifier si installé
npx ecc-agentshield --version
# Installer globalement (recommandé)
npm install -g ecc-agentshield
# Ou exécuter directement via npx (pas d'installation nécessaire)
npx ecc-agentshield scan .
Utilisation
Analyse de Base
Exécutez l'analyse sur le répertoire .claude/ du projet courant :
# Analyser le projet courant
npx ecc-agentshield scan
# Analyser un chemin spécifique
npx ecc-agentshield scan --path /chemin/vers/.claude
# Analyser avec un filtre de sévérité minimum
npx ecc-agentshield scan --min-severity medium
Formats de Sortie
# Sortie terminal (par défaut) — rapport coloré avec note
npx ecc-agentshield scan
# JSON — pour intégration CI/CD
npx ecc-agentshield scan --format json
# Markdown — pour documentation
npx ecc-agentshield scan --format markdown
# HTML — rapport auto-contenu avec thème sombre
npx ecc-agentshield scan --format html > security-report.html
Correction Automatique
Appliquez automatiquement les correctifs sécurisés (seulement ceux marqués comme auto-corrigibles) :
npx ecc-agentshield scan --fix
Cela va :
- Remplacer les secrets codés en dur par des références de variables d'environnement
- Restreindre les permissions génériques à des alternatives ciblées
- Ne jamais modifier les suggestions manuelles uniquement
Analyse Approfondie Opus 4.6
Exécutez le pipeline adversarial à trois agents pour une analyse plus approfondie :
# Nécessite ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY=votre-clé
npx ecc-agentshield scan --opus --stream
Cela exécute :
- Attaquant (Red Team) — trouve des vecteurs d'attaque
- Défenseur (Blue Team) — recommande le renforcement
- Auditeur (Verdict Final) — synthétise les deux perspectives
Initialisation d'une Configuration Sécurisée
Génère une nouvelle configuration .claude/ sécurisée à partir de zéro :
npx ecc-agentshield init
Crée :
settings.jsonavec des permissions ciblées et une liste de refusCLAUDE.mdavec les bonnes pratiques de sécurité- Emplacement réservé pour
mcp.json
Action GitHub
Ajoutez à votre pipeline CI :
- uses: affaan-m/agentshield@v1
with:
path: '.'
min-severity: 'medium'
fail-on-findings: true
Niveaux de Sévérité
| Note | Score | Signification |
|---|---|---|
| A | 90-100 | Configuration sécurisée |
| B | 75-89 | Problèmes mineurs |
| C | 60-74 | Nécessite attention |
| D | 40-59 | Risques significatifs |
| F | 0-39 | Vulnérabilités critiques |
Interprétation des Résultats
Résultats Critiques (corriger immédiatement)
- Clés API ou jetons codés en dur dans les fichiers de configuration
Bash(*)dans la liste d'autorisation (accès shell sans restriction)- Injection de commande dans les hooks via l'interpolation
${file} - Serveurs MCP exécutant des commandes shell
Résultats Élevés (corriger avant la production)
- Instructions d'exécution automatique dans CLAUDE.md (vecteur d'injection d'instructions)
- Listes de refus manquantes dans les permissions
- Agents avec accès Bash inutile
Résultats Moyens (recommandé)
- Suppression silencieuse d'erreurs dans les hooks (
2>/dev/null,|| true) - Hooks de sécurité PreToolUse manquants
- Installation automatique
npx -ydans les configurations de serveurs MCP
Résultats Informatifs (sensibilisation)
- Descriptions manquantes sur les serveurs MCP
- Instructions prohibitives correctement signalées comme bonne pratique
Liens
- GitHub : github.com/affaan-m/agentshield
- npm : npmjs.com/package/ecc-agentshield