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

ModeComportement
default (Manuel)Demande avant toute action qui modifie un état
acceptEditsLes modifications de fichiers passent, tout le reste demande
planLecture seule ; toute modification est refusée
autoLes modifications et les commandes courantes passent, les risquées demandent
bypassPermissionsTout 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éeFichierPour
user~/.oharness/settings.jsonUne habitude personnelle
project.oharness/settings.jsonAppartient au dépôt, peut être relu
local.oharness/settings.local.jsonCette 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.

Voir aussi