Berechtigungen für Coding-Agents: Modi, Allow- und Deny-Regeln

OHarness prüft jeden Tool-Aufruf gegen Allow-, Ask- und Deny-Regeln und danach gegen einen Berechtigungsmodus. deny schlägt alles – auch den Bypass-Modus –, ein ausdrückliches Verbot ist also die eine Grenze, auf die Sie sich verlassen können.

Aktualisiert am

Die fünf Modi

ModusVerhalten
default (Manuell)Fragt vor allem nach, was einen Zustand ändert
acceptEditsDateiänderungen gehen durch, alles andere wird nachgefragt
planNur lesen; jede Änderung wird abgelehnt
autoÄnderungen und Routinebefehle gehen durch, riskante werden nachgefragt
bypassPermissionsAlles freigeben – außer dem, was eine Deny-Regel verbietet

Wählen Sie einen Modus mit /mode in einer Sitzung oder mit --permission-mode auf der Kommandozeile. auto ist eine Abwägung der Kosten, keine Sicherheitsprüfung: Es bewertet den möglichen Schaden (rm, sudo, git push, kubectl, npm publish, Schreibzugriffe außerhalb des Projekts) und fragt bei allem nach, was es nicht als Routine erkennt.

Regeln

Regeln passen auf den Tool-Namen oder auf eine Form Tool(argument) mit Platzhaltern:

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

Wo Regeln liegen

GeltungsbereichDateiFür
user~/.oharness/settings.jsonEine persönliche Gewohnheit
project.oharness/settings.jsonGehört zum Repository, überprüfbar
local.oharness/settings.local.jsonNur dieser Checkout, in gitignore

Verbote summieren sich über alle Geltungsbereiche und werden nie überschrieben, sodass ein Projekt verbieten kann, was ein Nutzer global erlaubt hat. „Immer erlauben“ in einer Rückfrage schreibt das spezifischste Muster – wer Bash(npm test) freigibt, erlaubt damit nicht jedes Bash(...). /permissions zeigt die geltenden Regeln.

Was ein Berechtigungssystem nicht ist

Die Prüfung der beschreibbaren Wurzelverzeichnisse (workspaceMode) lehnt Pfade außerhalb des Projekts ab, bevor nachgefragt wird, aber sie prüft Argumente; den Prozess schließt sie nicht ein. Ein Shell-Befehl erreicht alles, was Sie erreichen. Für echte Isolation betreiben Sie den Agenten in einem Container oder einer VM und betrachten die Regeln als Schutz vor Fehlern.

Häufige Fragen

Wie verhindere ich, dass ein Coding-Agent gefährliche Befehle ausführt?

Fügen Sie Deny-Regeln hinzu. In OHarness lehnt eine Regel wie "deny": ["Bash(rm -rf *)", "Bash(git push*)"] diese Befehle in jedem Modus ab, auch in bypassPermissions. Deny-Regeln sind die Grenze; Modi sind Bequemlichkeit.

Ignoriert der Bypass-Modus Deny-Regeln?

Nein. In OHarness schlägt Deny alles, auch bypassPermissions. Ein ausdrückliches Verbot ist die eine Regel, auf die sich ein Nutzer uneingeschränkt verlassen kann.

Kann ein Repository Berechtigungen für alle festlegen, die es nutzen?

Ja. Regeln in .oharness/settings.json werden mit dem Projekt committet. Verbote aus allen Geltungsbereichen summieren sich, sodass ein Projekt etwas verbieten kann, selbst wenn ein Nutzer es global erlaubt hat.

Verwandte Themen