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
acceptEditsLe modifiche ai file passano, tutto il resto chiede
planSola lettura; ogni modifica viene rifiutata
autoModifiche e comandi di routine passano, quelli rischiosi chiedono
bypassPermissionsApprova 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

AmbitoFilePer
user~/.oharness/settings.jsonUn'abitudine personale
project.oharness/settings.jsonAppartiene al repository, revisionabile
local.oharness/settings.local.jsonSolo 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.

Correlati