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
- Der Hauptagent schlägt eine Aktion vor, beispielsweise die Ausführung eines Befehls.
- Wenn die Aktion eine Genehmigung benötigt, erstellt Codex eine Anfrage.
- Wenn
approvals_reviewer = "auto_review"gilt, leitet Codex diese Genehmigungsanfrage an einen separaten Prüfagenten weiter, statt auf eine Person zu warten. - Der Prüfagent entscheidet, ob die Aktion ausgeführt werden soll, und gibt eine Begründung zurück.
- 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_rootsfü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 mitallowund berücksichtigt Regeln mitpromptundforbidden.
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.