Permessi di un agente di codice: modalità, regole allow e deny
OHarness confronta ogni chiamata di strumenti con le regole allow, ask e deny e poi con una modalità di permesso. deny batte tutto, compresa la modalità bypass, quindi un divieto esplicito è l'unico confine su cui puoi contare.
Aggiornato il
Le cinque modalità
| Modalità | Comportamento |
|---|---|
default (Manuale) | Chiede prima di qualsiasi cosa che modifichi lo stato |
acceptEdits | Le modifiche ai file passano, tutto il resto chiede |
plan | Sola lettura; ogni modifica viene rifiutata |
auto | Modifiche e comandi di routine passano, quelli rischiosi chiedono |
bypassPermissions | Approva tutto, tranne ciò che una regola deny vieta |
Scegline una con /mode in una sessione o con --permission-mode dalla riga di comando. auto è una valutazione dei costi, non un controllo di sicurezza: misura il raggio dei danni possibili (rm, sudo, git push, kubectl, npm publish, scritture fuori dal progetto) e chiede per tutto ciò che non riconosce come routine.
Regole
Le regole corrispondono al nome dello strumento, o a una forma Tool(argument) con caratteri jolly:
{
"allow": ["Bash(npm run test:*)", "mcp__github__get_*"],
"ask": ["Bash(git push*)"],
"deny": ["Bash(rm -rf *)", "write(.env*)"]
}Dove stanno le regole
| Ambito | File | Per |
|---|---|---|
| user | ~/.oharness/settings.json | Un'abitudine personale |
| project | .oharness/settings.json | Appartiene al repository, revisionabile |
| local | .oharness/settings.local.json | Solo questo checkout, in gitignore |
I divieti si sommano tra gli ambiti e non vengono mai scavalcati, quindi un progetto può vietare ciò che un utente ha consentito a livello globale. “Consenti sempre” in una richiesta scrive il pattern più specifico: approvare Bash(npm test) non concede ogni Bash(...). /permissions mostra le regole in vigore.
Cosa non è un sistema di permessi
Il controllo delle radici scrivibili (workspaceMode) rifiuta i percorsi fuori dal progetto prima di chiedere, ma ispeziona gli argomenti; non confina il processo. Un comando di shell può raggiungere tutto ciò che puoi raggiungere tu. Per un vero isolamento, esegui l'agente in un container o in una VM e considera le regole una protezione contro gli errori.
Domande frequenti
Come impedisco a un agente di codice di eseguire comandi pericolosi?
Aggiungi regole deny. In OHarness, una regola come "deny": ["Bash(rm -rf *)", "Bash(git push*)"] rifiuta quei comandi in ogni modalità, compresa bypassPermissions. Le regole deny sono il confine; le modalità sono una comodità.
La modalità bypass ignora le regole deny?
No. In OHarness deny batte tutto, compresa bypassPermissions. Un divieto esplicito è l'unica regola su cui un utente può contare in modo assoluto.
Un repository può impostare i permessi per tutti quelli che lo usano?
Sì. Le regole in .oharness/settings.json vengono committate con il progetto. I divieti di qualsiasi ambito si sommano, quindi un progetto può vietare qualcosa anche se un utente lo ha consentito a livello globale.