Permissions d'un agent de code : modes, règles allow et deny
OHarness vérifie chaque appel d'outil au regard des règles allow, ask et deny, puis d'un mode de permission. deny l'emporte sur tout — y compris le mode bypass — : un refus explicite est donc la seule frontière sur laquelle vous pouvez compter.
Mis à jour le
Les cinq modes
| Mode | Comportement |
|---|---|
default (Manuel) | Demande avant toute action qui modifie un état |
acceptEdits | Les modifications de fichiers passent, tout le reste demande |
plan | Lecture seule ; toute modification est refusée |
auto | Les modifications et les commandes courantes passent, les risquées demandent |
bypassPermissions | Tout approuver — sauf ce qu'une règle deny interdit |
Choisissez-en un avec /mode dans une session ou --permission-mode en ligne de commande. auto est une appréciation du coût, pas un contrôle de sécurité : il mesure l'étendue des dégâts possibles (rm, sudo, git push, kubectl, npm publish, écritures hors du projet) et demande pour tout ce qu'il ne reconnaît pas comme courant.
Les règles
Les règles portent sur le nom de l'outil, ou sur une forme Tool(argument) avec des jokers :
{
"allow": ["Bash(npm run test:*)", "mcp__github__get_*"],
"ask": ["Bash(git push*)"],
"deny": ["Bash(rm -rf *)", "write(.env*)"]
}Où se trouvent les règles
| Portée | Fichier | Pour |
|---|---|---|
| user | ~/.oharness/settings.json | Une habitude personnelle |
| project | .oharness/settings.json | Appartient au dépôt, peut être relu |
| local | .oharness/settings.local.json | Cette copie de travail uniquement, ignorée par git |
Les refus se cumulent d'une portée à l'autre et ne sont jamais annulés : un projet peut donc interdire ce qu'un utilisateur a autorisé globalement. « Toujours autoriser » dans une demande d'autorisation enregistre le motif le plus précis — approuver Bash(npm test) n'accorde pas tous les Bash(...). /permissions affiche les règles en vigueur.
Ce qu'un système de permissions n'est pas
Le contrôle des racines accessibles en écriture (workspaceMode) refuse les chemins hors du projet avant même de demander, mais il inspecte les arguments ; il ne confine pas le processus. Une commande shell peut atteindre tout ce que vous pouvez atteindre. Pour un vrai confinement, faites tourner l'agent dans un conteneur ou une VM, et considérez les règles comme une protection contre les erreurs.
Questions fréquentes
Comment empêcher un agent de code d'exécuter des commandes dangereuses ?
Ajoutez des règles deny. Dans OHarness, une règle comme "deny": ["Bash(rm -rf *)", "Bash(git push*)"] refuse ces commandes dans tous les modes, y compris bypassPermissions. Les règles deny sont la frontière ; les modes sont une commodité.
Le mode bypass ignore-t-il les règles deny ?
Non. Dans OHarness, deny l'emporte sur tout, y compris bypassPermissions. Un refus explicite est la seule règle sur laquelle un utilisateur peut compter de façon absolue.
Un dépôt peut-il définir des permissions pour tous ceux qui l'utilisent ?
Oui. Les règles de .oharness/settings.json sont commitées avec le projet. Les refus de toutes les portées se cumulent : un projet peut donc interdire quelque chose même si un utilisateur l'a autorisé globalement.