Eine Deny-Regel ist die einzige echte Grenze

· 5 Min. Lesezeit

Alles andere, was ein Agent-Harness als Berechtigung bezeichnet, ist eine Abwägung von Kosten. Das sollte man klar sagen, weil die Oberfläche es nicht tut: eine Freigabe-Rückfrage, ein Modus namens Auto und eine Einstellung für beschreibbare Wurzelverzeichnisse sehen alle gleichartig aus, und nur eines davon ist eine Linie, die das System in jedem Fall hält.

OHarness hat fünf Berechtigungsmodi. Manuell fragt vor allem nach, was einen Zustand ändert. Änderungen annehmen lässt Dateischreibvorgänge durch und fragt beim Rest nach. Plan lehnt jede Änderung ab und liest nur. Auto lässt Änderungen und Routinebefehle passieren und fragt bei riskanten nach. Bypass gibt alles frei.

Vier dieser fünf sind ein Regler dafür, wie oft Sie unterbrochen werden. Der fünfte ist gar kein Modus.

Was der Klassifikator tatsächlich misst

Auto ist der Modus, bei dem die meisten bleiben, deshalb lohnt es sich zu wissen, was dort entscheidet. Der Klassifikator dahinter misst den möglichen Schaden, nicht die Absicht: rm, sudo, git push, kubectl, npm publish, ein Schreibvorgang in einen absoluten Pfad außerhalb von /tmp. Alles, was er nicht als Routine erkennt, wird weiterhin nachgefragt.

Diese Ausrichtung ist bewusst gewählt, und sie ist die einzig vernünftige. Der Fehler, der etwas kostet, ist die Freigabe eines Befehls, der Arbeit zerstört. Der Fehler in der anderen Richtung ist eine Rückfrage zu einem weiteren ls, die einen Tastendruck kostet. Ein Klassifikator, der beim zweiten Fall clever sein soll, wird sich irgendwann beim ersten irren.

Aber auch ein konservativer Klassifikator bleibt ein Klassifikator. Er liest einen Befehl und rät. bash -c 'python -c "..."' ist eine Zeile Shell, deren möglicher Schaden an ihren Argumenten überhaupt nicht ablesbar ist, und keine noch so ausgefeilte Mustererkennung behebt das, weil die Information zum Ablesen schlicht nicht da ist.

Die Regeln, die nicht raten

Unter den Modi liegen drei Listen, die sowohl gegen einen Tool-Namen als auch gegen eine Form Tool(argument) abgeglichen werden:

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

deny schlägt alles, auch den Bypass-Modus. Das ist der eine Satz im Berechtigungssystem, auf den man sich uneingeschränkt verlassen kann: Es gibt keinen Modus, keine Freigabe und kein „Immer erlauben“, das einen Pfad wieder öffnet, den eine Deny-Regel geschlossen hat. Alles darüber – die Modi, der Klassifikator, die Rückfragen – ist Gerüst um die Frage, wie oft Sie gefragt werden möchten.

Freigaben bleiben bestehen, und wo sie gespeichert werden, ist wichtig. „Immer erlauben“ wird in eine Einstellungsdatei in einem von drei Geltungsbereichen geschrieben: ~/.oharness/settings.json für eine persönliche Gewohnheit, .oharness/settings.json für etwas, das zum Repository gehört und in einem Pull Request geprüft werden kann, und .oharness/settings.local.json für eine Entscheidung pro Checkout, die nicht in Git landet. Verbote summieren sich über alle drei und werden nie von einem engeren Geltungsbereich überschrieben, denn ein Projekt muss verbieten können, was ein Nutzer global erlaubt hat.

Geschrieben wird das spezifischste Muster, das abdeckt, was Sie freigegeben haben. Die Freigabe von Bash(npm test) darf nicht stillschweigend jedes Bash(...) erlauben, und die Freigabe eines Tools einer verbundenen App darf nicht den Rest dieser App freigeben, geschweige denn jede App, die Sie verbunden haben. Ein Berechtigungssystem, das sich ausweitet, während Sie sich durchklicken, ist schlimmer als gar keines, weil es eine Einstellungsdatei erzeugt, die sich wie eine Richtlinie liest und wie ein Bypass verhält.

Beschreibbare Wurzeln sind eine Richtlinienprüfung, keine Sandbox

workspaceMode ist read-only, workspace-write oder full-access, und die Prüfung läuft vor der Freigabe-Rückfrage – jemandem eine Wahl anzubieten, die die Richtlinie ohnehin verbietet, ist ein guter Weg, ihm beizubringen, dass die Rückfragen nur Dekoration sind.

Man sollte genau sein, was diese Prüfung ist. Sie untersucht Tool-Argumente und lehnt Pfade außerhalb der erlaubten Wurzeln ab. Sie schränkt den Prozess nicht ein. Ein Shell-Befehl erreicht jeden Pfad, den Sie erreichen, und der oben genannte Fall python -c hebelt die Argumentprüfung vollständig aus. Echte Einschränkung ist eine Funktion des Betriebssystems – ein Container, eine VM, ein Benutzerkonto mit weniger Rechten –, und ein Harness, das etwas anderes behauptet, verkauft das Gefühl einer Grenze.

Also: ein Schutz vor Fehlern, und das ist das meiste, was schiefgeht. Kein Schutz vor einem entschlossenen Befehl, und genau das glauben viele gekauft zu haben.

Das Protokoll ist der Teil, den Sie später brauchen werden

Jede Berechtigungsentscheidung wird neben dem Verlauf aufgezeichnet, der sie ausgelöst hat, als zwei Zeilen, die über eine ID verknüpft sind:

{"kind":"decision","id":"dec_9f2c","tool":"bash","behavior":"ask","principal":"Bash(npm test)"}
{"kind":"answer","id":"dec_9f2c","outcome":"allowed","remembered":"Bash(npm test)"}

Die Entscheidung ist, was die Regeln gesagt haben. Die Antwort ist, was der Mensch gesagt hat. Ein ask ohne Antwort bedeutet, dass der Prozess anhielt, während die Frage noch auf dem Bildschirm stand – genau der Zustand, den Sie eine Woche später nicht aus dem Gedächtnis rekonstruieren können. outcome: "unavailable" ist der Fail-closed-Fall: Nichts konnte nachfragen, also wurde der Aufruf abgelehnt, ohne dass ein Mensch beteiligt war.

Es ist eingeschaltet, solange Sie es nicht abschalten, denn das Protokoll kostet ein paar kurze Zeilen pro Runde, und der Zustand, in dem es fehlt, ist zuverlässig der Zustand, in dem man es sich gewünscht hätte. Es bleibt auf dem Rechner, der die Entscheidungen getroffen hat: Die Synchronisierung überträgt Verläufe und Artefakte, dieses Protokoll aber bewusst nicht, und es wird mit seiner Sitzung gelöscht.

Schreibvorgänge darauf sind Fire-and-forget, aber serialisiert. Das ist ein bewusster Kompromiss – die Aufzeichnung darf einen Tool-Aufruf weder verzögern noch scheitern lassen, deshalb ist ein fehlgeschlagener Schreibvorgang eine Warnung im Log und kein abgelehnter Befehl. Dieses Protokoll beschreibt, was passiert ist. Es steuert es nicht. Und das ist, noch einmal, dieselbe Unterscheidung: Wissen Sie, welche Ihrer Kontrollen Abwägungen sind und welche eine Grenze ist.


OHarness ist ein quelloffenes Agent-Harness unter MIT-Lizenz. Die Berechtigungsreferenz enthält die vollständige Tabelle der Modi, Geltungsbereiche und Regelformen, und die Architekturreferenz zeigt, wo die Berechtigungsschicht im Verhältnis zum Modell und zu den Tools sitzt.