Automatische Überprüfung

Wie Codex Genehmigungsanfragen prüft und wie Sie die Richtlinie des Prüfagenten konfigurieren

Auto-review leitet geeignete Genehmigungsanfragen an einen separaten Prüfagenten weiter. Ihre Sandbox, Befehlsregeln und Werkzeugeinstellungen bestimmen, welche Aktionen eine Genehmigung benötigen. Der Prüfagent entscheidet, ob diese Aktionen ausgeführt werden dürfen.

Wenn Sie in der ChatGPT-Desktop-App ein genehmigtes Daybreak-Modell auswählen, wird die Berechtigungssteuerung automatisch auf Für mich genehmigen umgestellt, sofern dieser Modus für Ihr Konto verfügbar und gemäß den Organisationsrichtlinien zulässig ist. Dies gilt auch, wenn Sie den Befehl /model der Desktop-App verwenden. Wenn dieser Modus nicht verfügbar ist, bleibt der aktuelle Berechtigungsmodus unverändert. Die Modellauswahl setzt verwaltete Organisationsanforderungen niemals außer Kraft.

Bevor Sie Vollzugriff für ein genehmigtes Sicherheitsmodell aktivieren, zeigt die ChatGPT-Desktop-App eine modellspezifische Warnung vor gefährlichen Aktionen an. Die Warnung empfiehlt stattdessen Für mich genehmigen und verlinkt auf die Konfiguration der Prüfrichtlinie. Die Warnung stellt die Sandbox-Grenze nicht wieder her und setzt die Organisationsrichtlinie nicht außer Kraft.

Auto-review auswählen

Wählen Sie in der Desktop-App Für mich genehmigen in der Berechtigungsauswahl unterhalb des Eingabefelds aus. Prüfen Sie, ob die Option für den aktuellen Chat ausgewählt ist. Unter Berechtigungen finden Sie Informationen zur Modusauswahl und Fehlerbehebung.

Legen Sie für die CLI oder eine lokale Codex-Konfiguration approvals_reviewer = "auto_review" zusammen mit einer geeigneten interaktiven Genehmigungsrichtlinie fest, etwa approval_policy = "on-request". Eine Änderung der Genehmigungsrichtlinie allein wählt den Prüfagenten nicht aus. Administratoren können Auto-review vorschreiben für ihre Organisation.

So funktioniert Auto-review

  1. Der Hauptagent schlägt eine Aktion vor, beispielsweise die Ausführung eines Befehls.
  2. Wenn die Aktion eine Genehmigung benötigt, erstellt Codex eine Anfrage.
  3. Wenn approvals_reviewer = "auto_review" gilt, leitet Codex diese Genehmigungsanfrage an einen separaten Prüfagenten weiter, statt auf eine Person zu warten.
  4. Der Prüfagent entscheidet, ob die Aktion ausgeführt werden soll, und gibt eine Begründung zurück.
  5. Wird die Aktion genehmigt, wird die Ausführung fortgesetzt. Wird sie abgelehnt, erhält der Hauptagent die Anweisung, einen wesentlich sichereren Weg zu finden oder anzuhalten und den Benutzer zu fragen.

Wann sie ausgelöst wird

Die automatische Überprüfung bewertet Genehmigungsanfragen, die andernfalls auf eine menschliche Entscheidung warten würden. Dazu gehören:

  • Shell- oder exec-Werkzeugaufrufe, die erweiterte Sandbox-Berechtigungen anfordern.
  • Befehle, die einer Befehlsregel mit decision = "prompt" entsprechen, einschließlich Befehlen innerhalb der Sandbox.
  • Netzwerkanfragen an Ziele, die eine Genehmigung erfordern. Eine explizite Netzwerkregel zur Verweigerung blockiert die Anfrage.
  • Dateiänderungen außerhalb der zulässigen beschreibbaren Stammverzeichnisse.
  • MCP- oder App-Werkzeugaufrufe, die aufgrund ihrer Werkzeugannotationen oder des konfigurierten Genehmigungsmodus eine Genehmigung erfordern.

Aktionen, für deren Ausführung bereits eine Berechtigung vorliegt, werden ohne Prüfung ausgeführt.

Anfragen für den App-Zugriff durch Computer Use gehen direkt an den Benutzer. Geeignete Computer-Use-Werkzeugaufrufe können unabhängig davon Auto-review auslösen.

Was Auto-review blockiert

Auf hoher Ebene ist die automatische Überprüfung dafür vorgesehen, Aktionen wie die folgenden zu blockieren:

  • Senden privater Daten, Geheimnisse oder Anmeldedaten an nicht vertrauenswürdige Ziele
  • Suchen nach Anmeldedaten, Token, Cookies oder Sitzungsmaterial
  • weitreichende oder dauerhafte Schwächung der Sicherheit
  • destruktive Aktionen mit einem erheblichen Risiko irreversibler Schäden

Unter Konfiguration finden Sie die Standardregeln und Informationen zu deren Anpassung.

Was der Prüfer sieht

Der Prüfagent bewertet die konkrete Aktion, die die Genehmigungsanfrage ausgelöst hat.

Der Prüfagent sieht ein kompaktes Protokoll sowie die genaue Genehmigungsanfrage. Dieses enthält in der Regel Benutzernachrichten, angezeigte Statusmeldungen des Assistenten, relevante Werkzeugaufrufe und Werkzeugausgaben sowie die Aktion, für die gerade eine Genehmigung angefragt wird. Er kann auch schreibgeschützte Prüfungen durchführen, etwa ein Verzeichnis untersuchen, bevor er dessen Löschung genehmigt.

Verborgene Überlegungen des Assistenten sind nicht enthalten. Die automatische Überprüfung sieht gespeicherte Chat-Elemente und Werkzeugnachweise, keine privaten Gedankengänge.

Ablehnungen und Verhalten bei Fehlern

Eine ausdrückliche Ablehnung wird nicht wie ein gewöhnlicher Sandbox-Fehler behandelt. Codex gibt die Begründung der Prüfung an den Hauptagenten zurück und fügt eine nachdrücklichere Anweisung hinzu:

  • Verfolgen Sie dasselbe Ziel nicht durch eine Umgehung, indirekte Ausführung oder Umgehung der Richtlinie weiter.
  • Fahren Sie nur mit einer wesentlich sichereren Alternative fort.
  • Halten Sie andernfalls an und fragen Sie den Benutzer.

Bei den meisten Modellen unterbricht die Codex CLI den Durchlauf nach 3 aufeinanderfolgenden Ablehnungen oder 10 Ablehnungen innerhalb der letzten 50 Prüfungen dieses Durchlaufs. Bei Modellen, die für Cybersicherheit vorgesehen sind, unterbricht die CLI den Durchlauf bei der ersten Ablehnung.

Jedes andere Prüfergebnis setzt den Zähler für aufeinanderfolgende Ablehnungen zurück. Wenn Codex einen Ablehnungsgrenzwert erreicht, zeigt es eine Warnung an und beendet den Durchlauf.

Zeitüberschreitungen werden getrennt von ausdrücklichen Ablehnungen angezeigt, und der Hauptagent wird darüber informiert, dass eine Zeitüberschreitung allein kein Beweis dafür ist, dass die Aktion unsicher ist.

Codex bietet außerdem einen expliziten Weg, Ablehnungen von Aktionen zu überstimmen. Führen Sie in der aktuellen Open-Source-TUI /approve aus, um die Auswahl Ablehnungen der automatischen Prüfung zu öffnen, und wählen Sie eine kürzlich abgelehnte Aktion aus, um einen erneuten Versuch zu genehmigen. Codex speichert bis zu 10 aktuelle Ablehnungen pro Aufgabe. Diese Genehmigung ist eng begrenzt: Sie gilt genau für die abgelehnte Aktion, nicht für ähnliche zukünftige Aktionen; sie wird für einen erneuten Versuch im selben Kontext erfasst; und der erneute Versuch durchläuft weiterhin die automatische Prüfung. Im Hintergrund fügt Codex eine Genehmigungsmarkierung auf Entwicklerebene für genau diese Aktion ein. Die Prüfinstanz sieht diese explizite Übersteuerung durch den Benutzer dann als Kontext, befolgt aber weiterhin die Richtlinie und kann die Aktion erneut ablehnen, wenn die Richtlinie festlegt, dass der Benutzer diese Art von Ablehnung nicht überstimmen darf.

Konfiguration

Die Vorlage für den Prüfagenten gibt dem Prüfagenten vor, wie er eine Aktion bewerten soll. Codex fügt die Sicherheitsrichtlinie in diese Vorlage ein und legt das Antwortformat separat fest. Die CLI verwendet die Standardrichtlinie des Prüfmodells, sofern verfügbar. Andernfalls verwendet sie die mitgelieferte Richtlinie (policy.md).

Um Regeln hinzuzufügen, setzen Sie extra_policy unter [auto_review] in der lokalen config.toml oder setzen Sie guardian_extra_policy auf oberster Ebene in der verwalteten requirements.toml. Codex wendet diese Regeln zusätzlich zur aktiven Richtlinie an.

Um die Richtlinie zu ersetzen, kopieren Sie die vollständige Richtlinie, die Sie anpassen möchten. Wenn Sie den mitgelieferten Standard verwenden, kopieren Sie den gesamten Inhalt von policy.md. Bearbeiten Sie die Regeln, die Sie ändern möchten, und hinterlegen Sie dann den vollständigen Text lokal in [auto_review].policy oder in der verwalteten Einstellung guardian_policy_config. Ausgelassene Regeln entfallen in der Ersatzrichtlinie. Codex verwendet weiterhin die Vorlage und das Antwortformat des Prüfagenten.

Codex wertet die beiden Einstellungen unabhängig voneinander aus und ignoriert leere Werte. Die verwaltete Einstellung guardian_policy_config hat Vorrang vor der lokalen Einstellung [auto_review].policy. Die verwaltete Einstellung guardian_extra_policy hat Vorrang vor der lokalen Einstellung [auto_review].extra_policy. Wenn Ihre Organisation beispielsweise nur eine Ersatzrichtlinie festlegt, fügt Ihre lokale Einstellung extra_policy dieser weiterhin Regeln hinzu.

Informationen zur organisationsweiten Einrichtung finden Sie unter Auto-review-Richtlinie konfigurieren.

Einen autorisierten Cybersicherheitseinsatz konfigurieren

Kombinieren Sie für autorisierte Sicherheitsarbeiten Auto-review mit einem schriftlich festgelegten Auftragsumfang und einem Berechtigungsprofil nach dem Prinzip der geringsten Rechte. Verwenden Sie ein genehmigtes Testziel in einer Laborumgebung, dokumentieren Sie die Aktionen und das Zeitfenster des Auftrags und schließen Sie Produktionssysteme, unbeteiligte Hosts, Zugangsdaten und dauerhafte Änderungen vom Auftragsumfang aus, sofern sie nicht ausdrücklich autorisiert sind.

Dieses Beispiel für die lokale config.toml aktiviert Auto-review und fügt der aktiven Richtlinie Regeln für den Auftrag hinzu. Ersetzen Sie das Beispielziel und die Beispielaktionen durch Ihren genehmigten Auftragsumfang.

approval_policy = "on-request"
approvals_reviewer = "auto_review"
default_permissions = ":workspace"

[auto_review]
extra_policy = """
## Environment Profile
- Authorized target: lab.example.com.
- Approved actions: inspect the target, reproduce authorized vulnerabilities,
  and validate fixes within the documented engagement window.

## Tenant Risk Taxonomy and Allow/Deny Rules
- Allow only actions against the approved target that match the documented
  engagement scope and approved actions.
- Deny out-of-scope or unknown hosts, production access, credential theft,
  persistence, data exfiltration, destructive operations, and policy bypass.
- Deny ambiguous actions and high-impact changes until a human explicitly
  approves the exact target, action, and side effects.
"""

Setzen Sie Zielbeschränkungen mit unabhängigen Dateisystem- und Netzwerkregeln durch. Hinterlegen Sie für eine Organisation dieselben Auftragsregeln in der Einstellung guardian_extra_policy auf oberster Ebene der verwalteten requirements.toml. Die folgenden Anforderungen wählen Auto-review aus und beschränken die verfügbaren Berechtigungsprofile.

allowed_approval_policies = ["on-request"]
allowed_approvals_reviewers = ["auto_review"]
allowed_sandbox_modes = ["read-only", "workspace-write"]
default_permissions = ":workspace"

[allowed_permission_profiles]
":read-only" = true
":workspace" = true
# ":danger-full-access" is omitted, so it is denied.

allowed_permission_profiles steuert die aktuellen Berechtigungsprofile. allowed_sandbox_modes verhindert außerdem den Vollzugriff in Bereitstellungen, die noch den veralteten sandbox_mode verwenden.

Behalten Sie approval_policy = "on-request" oder eine andere geeignete interaktive Genehmigungsrichtlinie sowie eine durchsetzbare Sandbox-Grenze bei. Mit approval_policy = "never", :danger-full-access oder --yolo kann eine Aktion vermeiden, dass die für die Prüfung erforderliche Genehmigungsanfrage zum Überschreiten der Sandbox-Grenze erstellt wird.

Ein Netzwerkziel auf der Zulassungsliste löst nicht von sich aus eine Überprüfung aus. Fügen Sie explizite Befehlsregeln mit decision = "prompt" hinzu oder konfigurieren Sie vertrauliche MCP-Tools so, dass sie eine Genehmigung erfordern, wenn Aktionen innerhalb der Sandbox weiterhin dem Prüfer vorgelegt werden müssen.

Informationen zum Modellzugriff, zur Einrichtung von Aufträgen und zu benutzerdefinierten Agenten-Workflows finden Sie unter Modelle und Trusted Access und empfohlene Konfiguration. Für benutzerdefinierte API- oder Agents SDK-Ausführungsumgebungen verwenden Sie Schutzmechanismen und menschliche Prüfung.

Prüfaufwand reduzieren, ohne die Sicherheit zu schwächen

Die automatische Überprüfung funktioniert am besten, wenn die Sandbox Ihre üblichen sicheren Arbeitsabläufe bereits abdeckt. Wenn zu viele alltägliche Aktionen eine Überprüfung erfordern, passen Sie zunächst die Grenze an, anstatt dem Prüfer dauerhaft beizubringen, unnötige Eskalationen zu genehmigen.

In der Praxis haben die folgenden Änderungen die größte Wirkung:

  • Ergänzen Sie eng begrenzte writable_roots für temporäre Arbeitsverzeichnisse oder benachbarte Repositorys, die Sie gezielt verwenden.
  • Fügen Sie eng gefasste Präfixregeln hinzu. Bevorzugen Sie präzise Befehlspräfixe wie ["cargo", "test"] oder ["pnpm", "run", "lint"] gegenüber weit gefassten Mustern wie ["python"] oder ["curl"]. Weit gefasste Regeln heben oft die Grenze auf, die Auto-review schützen soll. Bei Cybersicherheitsmodellen ignoriert die CLI Präfixregeln mit allow und berücksichtigt Regeln mit prompt und forbidden.

Sitzungstranskripte der automatischen Überprüfung werden standardmäßig unter ~/.codex/sessions gespeichert. Daher können Sie Codex bitten, dort den bisherigen Datenverkehr zu analysieren, bevor Sie Richtlinien oder Berechtigungen ändern.

Einschränkungen

Die automatische Überprüfung verbessert den standardmäßigen Betriebsmodus für lang andauernde agentengestützte Aufgaben, ist jedoch keine deterministische Sicherheitsgarantie.

  • Sie bewertet nur geeignete Genehmigungsanfragen, einschließlich Anfragen, die durch explizite Befehlsregeln oder Einstellungen zur Tool-Genehmigung ausgelöst werden.
  • Sie kann weiterhin Fehler machen, insbesondere in adversarialen oder ungewöhnlichen Kontexten.
  • Sie sollte ein gutes Sandbox-Design, Überwachung und organisationsspezifische Richtlinien ergänzen, nicht ersetzen.

Die wissenschaftliche Begründung und die veröffentlichten Bewertungsergebnisse finden Sie im Alignment Research-Beitrag zur automatischen Überprüfung.