Behörigheter för kodagenter: lägen, allow- och deny-regler

OHarness kontrollerar varje verktygsanrop mot allow-, ask- och deny-regler och sedan mot ett behörighetsläge. deny slår allt — även bypass-läget — så ett uttryckligt nej är den enda gräns du kan lita på.

Uppdaterad

De fem lägena

LägeBeteende
default (Manuellt)Fråga före allt som ändrar tillstånd
acceptEditsFiländringar släpps igenom, allt annat frågar
planSkrivskyddat; varje ändring nekas
autoÄndringar och rutinkommandon släpps igenom, riskabla frågar
bypassPermissionsGodkänn allt — utom det som en deny-regel förbjuder

Välj ett med /mode i en session eller --permission-mode på kommandoraden. auto är en bedömning av kostnad, inte en säkerhetskontroll: den mäter sprängradie (rm, sudo, git push, kubectl, npm publish, skrivningar utanför projektet) och frågar om allt den inte känner igen som rutin.

Regler

Regler matchar verktygsnamnet, eller en Tool(argument)-form med jokertecken:

{
  "allow": ["Bash(npm run test:*)", "mcp__github__get_*"],
  "ask":   ["Bash(git push*)"],
  "deny":  ["Bash(rm -rf *)", "write(.env*)"]
}

Var reglerna finns

OmfångFilFör
user~/.oharness/settings.jsonEn personlig vana
project.oharness/settings.jsonHör till repositoryt, kan granskas
local.oharness/settings.local.jsonBara den här utcheckningen, i gitignore

Nekanden ackumuleras över omfången och åsidosätts aldrig, så ett projekt kan förbjuda det som en användare har tillåtit globalt. ”Tillåt alltid” i en fråga skriver det mest specifika mönstret — att godkänna Bash(npm test) ger inte tillstånd till varje Bash(...). /permissions visar reglerna som gäller.

Vad ett behörighetssystem inte är

Kontrollen av skrivbara rotkataloger (workspaceMode) nekar sökvägar utanför projektet innan den frågar, men den granskar argument; den spärrar inte in processen. Ett skalkommando når allt som du når. För verklig isolering, kör agenten i en container eller virtuell maskin och se reglerna som ett skydd mot misstag.

Vanliga frågor

Hur hindrar jag en kodagent från att köra farliga kommandon?

Lägg till deny-regler. I OHarness nekar en regel som "deny": ["Bash(rm -rf *)", "Bash(git push*)"] de kommandona i alla lägen, även bypassPermissions. Deny-regler är gränsen; lägena är bekvämlighet.

Ignorerar bypass-läget deny-regler?

Nej. I OHarness slår neka allt, även bypassPermissions. Ett uttryckligt nej är den enda regel en användare kan lita på helt och hållet.

Kan ett repository sätta behörigheter för alla som använder det?

Ja. Regler i .oharness/settings.json committas med projektet. Nekanden från alla omfång ackumuleras, så ett projekt kan förbjuda något även om en användare har tillåtit det globalt.

Relaterat