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 :
- Un deny pour chaque façon de lancer le script. Un script peut être appelé avec
&, en dot-sourcing,-File,Start-ProcessouInvoke-Expression, depuis PowerShell ou Bash. Un motif par forme. - Les approbations sont personnelles. Mes choix « toujours autoriser » vont dans le fichier de réglages local, jamais commité : la base d'équipe reste en lecture seule.
- Les réglages sont lus depuis la racine du projet. Une session lancée dans un sous-dossier ne reçoit pas la liste deny racine. Démarrez à la racine.
Jamais de SQL contre la production depuis l'IA
C'est ma règle la plus stricte :
- Claude écrit et relit du SQL ; il n'exécute pas de DDL ni de DML sur un serveur de production. Les changements de production suivent le processus de changement normal, exécutés par un humain.
- Les requêtes de diagnostic en lecture seule sont acceptables, mais je préfère que Claude me donne la requête et que je l'exécute, ou qu'il utilise un login en lecture seule.
- La validation passe par des mocks et des tests : des tests Pester qui simulent l'accès aux données et les commandes destructrices et vérifient qu'elles ne sont jamais appelées quand elles ne doivent pas l'être.
- Les scripts qui peuvent nuire (suppression, copie, mise à jour massive) sont dans la liste deny et ont un mode
-WhatIf. - Aucune chaîne de connexion ni identifiant dans un prompt, un brief ou un fichier de configuration. Key Vault et identité managée.
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 :
- Lire librement. Chercher des dashboards, lire les requêtes des panneaux, exécuter des requêtes de métriques ou de logs : pré-approuvé dans
allow. - Écrire seulement avec accord explicite. Modifier un dashboard, créer une règle d'alerte, un silence ou un incident, changer une source de données : jamais dans la liste allow. En production, chaque écriture attend mon « oui ».
- Mieux encore, utiliser un jeton au rôle minimal. Un jeton lecteur rend l'écriture impossible ; un jeton éditeur n'est employé que lorsque je veux écrire.
- Les pipelines qui écrivent dans un outil de supervision gardent un dry-run par défaut.
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
- Des hooks et des règles deny, pas de la prose. Si le coût d'une erreur est élevé, imposez-le par du code.
- Échouer ouvert sur les erreurs d'outillage, fermé sur la politique. Un linter absent ne doit pas vous arrêter ; un secret détecté, si.
- Testez vos garde-fous. Demandez à Claude de faire la chose interdite dans un dossier jetable et vérifiez qu'il est arrêté.
- Renouvelez tout secret écrit, même brièvement. Un hook vous prévient, mais la valeur est peut-être déjà dans un journal ou un diff.
- Soyez honnête sur la limite. Ces mesures réduisent le risque ; elles ne remplacent ni les comptes à moindre privilège ni la relecture.