Une règle deny est la seule frontière dont vous disposez
· 5 min de lecture
Tout ce qu'un harnais d'agent appelle par ailleurs une permission est un jugement sur le coût. Cela mérite d'être dit clairement, car l'interface ne le dit pas : une demande d'approbation, un mode nommé Auto et un réglage de répertoires accessibles en écriture ont l'air de la même nature, et un seul d'entre eux est une limite que le système tiendra quoi qu'il arrive.
OHarness propose cinq modes de permission. Manuel demande avant toute action qui modifie l'état. Accepter les modifications laisse passer les écritures de fichiers et demande pour le reste. Plan refuse toute modification et se contente de lire. Auto laisse passer les modifications et les commandes courantes et demande pour les commandes risquées. Bypass approuve tout.
Quatre de ces cinq modes ne sont qu'un curseur réglant la fréquence de vos interruptions. Le cinquième n'est pas du tout un mode.
Ce que mesure réellement le classifieur
Auto est le mode où la plupart des gens s'installent ; il vaut donc la peine de savoir ce qui décide. Le classifieur qui le sous-tend mesure le rayon d'impact, pas l'intention : rm, sudo, git push, kubectl, npm publish, une écriture vers un chemin absolu hors de /tmp. Tout ce qu'il ne reconnaît pas comme courant demande quand même.
Ce biais est délibéré, et c'est le seul raisonnable. L'erreur qui coûte, c'est d'approuver une commande qui détruit du travail. L'erreur dans l'autre sens, c'est d'être sollicité pour un ls de plus, ce qui coûte une frappe de touche. Un classifieur réglé pour être astucieux sur le second cas finira tôt ou tard par se tromper sur le premier.
Mais un classifieur prudent reste un classifieur. Il lit une commande et devine. bash -c 'python -c "..."' est une ligne de shell dont le rayon d'impact n'apparaît absolument pas dans ses arguments, et aucun travail sur les motifs n'y changera rien, car l'information n'est tout simplement pas là.
Les règles qui ne sont pas des suppositions
Sous les modes se trouvent trois listes, comparées à la fois à un nom d'outil et à une forme Tool(argument) :
{
"allow": ["Bash(npm run test:*)", "mcp__github__get_*"],
"ask": ["Bash(git push*)"],
"deny": ["Bash(rm -rf *)", "write(.env*)"]
}
deny l'emporte sur tout, y compris sur le mode bypass. C'est la seule phrase du système de permissions sur laquelle on peut compter absolument : aucun mode, aucune approbation, aucun « toujours autoriser » ne rouvre un chemin qu'une règle de refus a fermé. Tout ce qui se trouve au-dessus — les modes, le classifieur, les demandes — n'est qu'un échafaudage autour d'une question : combien de fois voulez-vous être sollicité ?
Les approbations sont conservées, et l'endroit où elles le sont compte. « Toujours autoriser » est écrit dans un fichier de paramètres, dans l'une de trois portées : ~/.oharness/settings.json pour une habitude personnelle, .oharness/settings.json pour ce qui appartient au dépôt et peut être relu dans une pull request, et .oharness/settings.local.json pour un choix propre à une copie de travail qui reste hors de Git. Les refus s'accumulent dans les trois portées et ne sont jamais annulés par une portée plus étroite, car un projet doit pouvoir interdire ce qu'un utilisateur a autorisé globalement.
Ce qui est écrit, c'est le motif le plus spécifique couvrant ce que vous avez approuvé. Approuver Bash(npm test) ne doit pas accorder discrètement tous les Bash(...), et approuver un outil d'une application connectée ne doit pas accorder le reste de cette application, encore moins toutes les applications que vous avez connectées. Un système de permissions qui s'élargit tout seul pendant que vous cliquez est pire que pas de système du tout, car il produit un fichier de paramètres qui se lit comme une politique et se comporte comme un bypass.
Les répertoires accessibles en écriture sont un garde-fou, pas un bac à sable
workspaceMode vaut read-only, workspace-write ou full-access, et la vérification a lieu avant la demande d'approbation — proposer un choix que la politique interdit déjà est un bon moyen d'apprendre à quelqu'un que les demandes sont décoratives.
Il faut être précis sur ce qu'est cette vérification. Elle inspecte les arguments des outils et refuse les chemins situés hors des racines autorisées. Elle ne confine pas le processus. Une commande shell peut atteindre tout chemin que vous pouvez atteindre, et le cas python -c ci-dessus déjoue entièrement l'inspection des arguments. Le véritable confinement est une fonction du système d'exploitation — un conteneur, une VM, un compte utilisateur aux droits réduits — et un harnais qui prétend le contraire vend l'impression d'une frontière.
Donc : une protection contre les erreurs, qui représentent l'essentiel de ce qui tourne mal. Pas une protection contre une commande déterminée, ce que les gens croient avoir acheté.
La trace est ce que vous voudrez plus tard
Chaque décision de permission est enregistrée à côté de la transcription qui l'a produite, sous forme de deux lignes appariées par id :
{"kind":"decision","id":"dec_9f2c","tool":"bash","behavior":"ask","principal":"Bash(npm test)"}
{"kind":"answer","id":"dec_9f2c","outcome":"allowed","remembered":"Bash(npm test)"}
La décision, c'est ce que disaient les règles. La réponse, c'est ce qu'a dit la personne. Un ask sans réponse signifie que le processus s'est arrêté alors que la question était encore à l'écran — précisément l'état qu'on ne peut pas reconstituer de mémoire une semaine plus tard. outcome: "unavailable" est le cas de fermeture par défaut : rien n'a pu poser la question, l'appel a donc été refusé sans personne dans la boucle.
Elle est active sauf si vous la désactivez, car la trace coûte quelques lignes courtes par tour, et l'état où elle manque est invariablement celui où l'on s'aperçoit qu'on en aurait eu besoin. Elle reste sur la machine qui a pris les décisions : la synchronisation envoie les transcriptions et les artefacts, et délibérément pas cette trace, qui est supprimée avec sa session.
Les écritures sont asynchrones, sans attente de confirmation, mais sérialisées. C'est un compromis voulu : l'enregistrement ne doit ni retarder ni faire échouer un appel d'outil, si bien qu'une écriture ratée est un avertissement dans le journal plutôt qu'une commande refusée. Cette trace décrit ce qui s'est passé. Elle ne le contrôle pas. C'est, une fois encore, la même distinction : savoir lesquels de vos contrôles sont des jugements, et lequel est une frontière.
OHarness est un harnais d'agent open source, sous licence MIT. La référence des permissions contient le tableau complet des modes, des portées et des formes de règles, et la référence d'architecture montre où se situe la couche de permissions par rapport au modèle et aux outils.