LLI Wiki — My Digital Knowledge Base

Garde-fous pour Claude Code : hooks, permissions et accès lecture seule à la production

Permissions allow/ask/deny, hooks qui avertissent des secrets et motifs interdits, lecture libre et écriture sur accord pour les outils MCP, jamais de SQL contre la production depuis l'IA.

Donner un assistant IA à un dépôt de DBA n'est raisonnable que si les actions dangereuses sont rendues difficiles, et pas seulement déconseillées. Les instructions de CLAUDE.md sont des conseils : un modèle peut les mal lire ou les oublier. Pour ce qui compte, je m'appuie sur des garde-fous en couches : permissions, hooks, périmètre des outils et quelques règles absolues.

Le principe : conseil, avertissement, blocage

Niveau Mécanisme Pour
Conseil une phrase dans CLAUDE.md ou une règle conventions, style
Avertissement un hook qui signale et laisse Claude corriger secrets dans un fichier, motifs interdits
Approbation une permission ask force push, reset hard, tout ce qui se rattrape difficilement
Blocage une permission deny ou un hook bloquant scripts qui modifient la production, commandes destructrices

Plus l'action est irréversible, plus elle descend dans le tableau.

Permissions : allow, ask, deny

Le settings.json partagé a trois listes. Je garde celui qui est versionné conservateur.

{
  "permissions": {
    "allow": [
      "Bash(git status *)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "PowerShell(Invoke-ScriptAnalyzer *)",
      "PowerShell(Invoke-Pester *)"
    ],
    "ask": [
      "Bash(git push *--force*)",
      "Bash(git reset --hard*)"
    ],
    "deny": [
      "Bash(*deploy-to-prod.ps1*)",
      "PowerShell(*-File *deploy-to-prod.ps1*)"
    ]
  }
}

Ce que j'ai appris à mes dépens :

Jamais de SQL contre la production depuis l'IA

C'est ma règle la plus stricte :

Outils en lecture seule ou en écriture via MCP

Le même partage s'applique aux serveurs MCP. Je connecte Grafana par MCP, en développement et en production :

Hooks : avertir des secrets et des motifs interdits

Un hook est une commande exécutée sur un événement. Un hook PostToolUse qui sort avec le code 2 renvoie sa sortie d'erreur à Claude comme retour, et le modèle corrige sa propre modification. Un hook PreToolUse qui sort avec 2 bloque l'appel.

Voici un contrôle générique avant écriture pour les secrets dans les fichiers de configuration (mon propre croquis) :

# pre-write-secret-check.ps1 : block obvious secrets written into config files
$event = [Console]::In.ReadToEnd() | ConvertFrom-Json
$path  = $event.tool_input.file_path
$text  = "$($event.tool_input.content)$($event.tool_input.new_string)"

if ($path -notmatch '\.(json|ya?ml|config|xml|ini|env|psd1)$') { exit 0 }

$patterns = @(
    '(?i)(password|pwd|secret|api_?key)\s*[:=]\s*["'']?[^\s"'',;<{$]{8,}',
    '(?i)accountkey=[A-Za-z0-9+/=]{20,}',
    '(?i)(server|data source)=[^;]+;.*password='
)
foreach ($p in $patterns) {
    if ($text -match $p) {
        [Console]::Error.WriteLine('Possible secret in a config file. Use a Key Vault reference instead.')
        exit 2
    }
}
exit 0

Je l'enregistre sous PreToolUse avec un matcher sur les outils d'édition et d'écriture. Une version plus douce de la même idée, un avertissement plutôt qu'un blocage, peut s'écrire comme règle de plugin (un fichier Markdown avec une expression régulière sur le chemin et sur le contenu). J'utilise des avertissements pour les motifs de style, comme une commande de journalisation interdite, et des blocages pour les secrets.

Mon autre hook est un linter PostToolUse qui lance l'analyseur PowerShell sur chaque script modifié et renvoie les constats avec le code 2 : Claude corrige les erreurs de lint sans que je le demande. Deux détails de sécurité : il sort avec 0 si l'analyseur est absent, et avec 0 sur une erreur d'analyse du JSON, pour qu'un hook cassé ne bloque jamais le travail.

Retour d'expérience

Mastodon LLIMastodon SocialFosstodon