Aller au contenu
Mastering Claude

Le cours175 leçons

Accueil / Sécurité et données

Sécurité et données9 minApplication

Une garde par motif de texte n'est pas une frontière de sécurité

Une garde qui refuse un mot dans le texte d'une commande juge une écriture et non un effet : toute écriture qui évite ce mot passe, et même une liste de commandes admises à l'égalité exacte laisse passer le code qu'une commande admise lit dans un fichier que l'agent peut modifier.

Une garde refuse toute commande qui contient le mot rm. Trois façons d'écrire la même suppression la traversent, et la démonstration suivante le vérifie dans un dossier jetable.

La garde et ses quatre essais

mkdir -p demo-garde && cd demo-garde
touch cible1.txt cible2.txt cible3.txt cible4.txt
cat > garde.sh << 'EOF'
#!/bin/bash
cmd="$1"
if echo "$cmd" | grep -qw 'rm'; then
  echo "REFUSÉ : motif interdit détecté dans la commande tapée"
  exit 1
fi
echo "AUTORISÉ : aucun motif interdit trouvé, exécution"
eval "$cmd"
EOF
chmod +x garde.sh
./garde.sh "rm cible1.txt"
./garde.sh "r'm' cible2.txt"
./garde.sh 'A=r; B=m; $A$B cible3.txt'
ENC=$(printf 'rm cible4.txt' | base64)
./garde.sh "echo $ENC | base64 -d | bash"
ls -1
REFUSÉ : motif interdit détecté dans la commande tapée
AUTORISÉ : aucun motif interdit trouvé, exécution
AUTORISÉ : aucun motif interdit trouvé, exécution
AUTORISÉ : aucun motif interdit trouvé, exécution
cible1.txt
garde.sh

Le premier essai est refusé et cible1.txt survit. Le deuxième coupe le mot par des apostrophes, que l'interpréteur retire. Le troisième l'assemble à partir de deux variables d'une lettre. Le quatrième encode la commande en base64, que base64 -d | bash décode puis exécute.

Pourquoi corriger au cas par cas ne ferme rien

Interdire l'apostrophe, les variables ou base64 ferme trois portes, pas les écritures suivantes. La page des permissions de Claude Code le dit de ses règles : un refus Bash(rm *) arrête rm -rf build/ mais laisse passer /bin/rm -rf build/, et n'est pas une frontière de sécurité (voir une règle de lecture).

L'égalité exacte réduit la surface sans la fermer

Une liste de commandes admises tient mieux quand elle exige l'égalité exacte de chaîne et n'admet aucun programme lanceur, qui exécute une autre commande qu'on lui passe : bash, sh -c, eval, find -exec, xargs. Elle ferme alors les réécritures. Elle laisse ouvert le code qu'une commande admise lit ailleurs. Git lance le programme nommé par le réglage core.fsmonitor du dépôt quand il rafraîchit son index, lors d'un git status.

mkdir -p demo-fsmonitor && cd demo-fsmonitor
git init -q
git config core.fsmonitor 'echo EXECUTE_PAR_GIT_STATUS > temoin.txt; false'
git status > /dev/null 2>&1
cat temoin.txt
EXECUTE_PAR_GIT_STATUS

Un git status identique à l'entrée admise a exécuté ce qu'un agent peut écrire dans .git/config. L'autre voie n'inspecte plus le texte : le bac à sable, isolation que le système d'exploitation impose aux commandes shell et à leurs processus enfants, borne fichiers et réseau quelle que soit la commande qui a lancé le code. Il tourne sur macOS, Linux et WSL2, pas sous Windows natif.

Le bac à sable ne remplace pas la demande d'autorisation. Depuis la version 2.1.325 du journal, une commande Bash en bac à sable suit le flux de permissions normal par défaut ; sandbox.autoAllowBashIfSandboxed: true rétablit l'exécution sans demande.

Une garde trop stricte refuse aussi à tort

Une garde qui refuse tout ce qui ressemble à une écriture apprend à la contourner : elle bloque une redirection vers un fichier neuf, un heredoc de pure donnée, un grep dont le motif cite une commande dangereuse. Corrigez par des exemptions étroites et un banc de tests qui garde un témoin : un écart connu détecté, tous les refus tenus. N'activez pas sandbox.allowNestedUserNamespaces : il laisse des commandes sandboxées sous Linux contourner les protections de fichiers du bac à sable.

Mesurer la garde, surveiller ce dont elle dépend

Journalisez chaque refus et ce qui le suit : un refus levé par le rejeu identique n'a rien évité. Préférez une garde limitée à l'effet destructif, suppression ou écrasement, plutôt qu'à un mot du texte.

Une garde qui s'appuie sur un drapeau de Claude Code casse en silence si une mise à jour le renomme. Une sentinelle, lancée depuis un crochet SessionStart, affiche les drapeaux absents de claude --help. Son témoin, un drapeau inexistant, doit être signalé, sinon le détecteur est cassé.

Figure 1

Une correction de plus contre une liste par égalité exacte

Garde par motif, une correction de plus
Ajout : refuser aussi l'apostrophe isolée.
Contournement suivant : deux variables collées, toujours autorisé.
Liste par égalité exacte
Autorisé : git status
Refusé : bash -c 'git status'
Reste ouvert : le programme que core.fsmonitor nomme dans .git/config
À gauche, chaque correction laisse la suivante ouverte. À droite, les réécritures de la commande sont refusées, et la commande admise exécute encore ce que la configuration du dépôt lui fait lancer.
Figure 2

Trois contournements, ce que la garde voit, ce qui s'exécute

ContournementCe que la garde voitCe qui s'exécute réellement
Coupure par apostrophes, r'm'Les lettres r et m séparées par une apostrophe, aucun mot rm entierLa suppression, une fois les apostrophes retirées par l'interpréteur
Concaténation de variables, $A$BDeux variables d'une lettre, jamais r et m côte à côte dans le texteLa suppression, une fois les variables assemblées à l'exécution
Encodage base64Une suite de caractères sans rapport visible avec le mot interditLa suppression, une fois décodée puis transmise à l'interpréteur
Pour chacun des trois contournements exécutés, le texte que la garde a inspecté et la commande réellement lancée une fois interprétée.
Calibrez vous-même

Un administrateur écrit une garde qui refuse d'exécuter toute commande contenant le mot rm, pour empêcher un script automatisé de supprimer des fichiers. Il la teste avec la commande rm notes.txt, qui est refusée. Il déploie ensuite la garde sur son système de production.

Écrivez en une phrase ce que cette situation établit, et en une phrase ce qu'elle n'établit pas.

Ce qu’il faut retenir
  • Une garde qui cherche un mot dans le texte d'une commande juge une écriture, pas l'effet que l'interpréteur produira.
  • Chaque contournement corrigé laisse ouvertes les écritures que la correction n'a pas prévues.
  • Une liste admise à l'égalité exacte, sans programme lanceur, ferme les réécritures d'une commande mais pas le code que cette commande lit dans sa configuration.
  • Le bac à sable borne fichiers et réseau par le système d'exploitation, quelle que soit la commande qui a lancé le code, et ses commandes Bash passent par la demande d'autorisation sauf si vous réglez autoAllowBashIfSandboxed.
  • Une garde trop stricte refuse à tort et apprend à la contourner : on la corrige par des exemptions étroites, on la mesure en journalisant ses refus, et une sentinelle de drapeaux, testée sur un drapeau inexistant, signale la panne silencieuse.
À faire maintenant

Rejouez la démonstration core.fsmonitor dans un dossier neuf et vérifiez que temoin.txt contient la ligne attendue. Écrivez ensuite une garde de quelques lignes qui refuse une commande contenant un mot de votre choix, testez-la avec ce mot écrit tel quel puis coupé par des apostrophes, et notez lequel des deux essais elle laisse passer.

Vérifier à la source

Chaque affirmation datable de cette leçon renvoie ici au texte public qui la porte. Une source qui ne s’ouvre pas ne prouve rien.