Mit der verwalteten Konfiguration können Enterprise-Admins unterstützte Anforderungen und Standardwerte für ChatGPT Work und Codex festlegen. Anforderungen begrenzen, welche Aktionen Personen und Aufgaben ausführen können. Standardwerte geben die Ausgangseinstellungen vor. Welche Einstellungen unterstützt werden, hängt vom Produkt, der Clientversion und der Ausführungsumgebung ab.
Öffne in der Admin-Konsole die Agentensicherheit, um unterstützte Einstellungen über die Cloud zu verwalten. Für häufige Aufgaben kannst du die Bedienelemente im Editor verwenden. Wähle Als TOML bearbeiten, um den Konfigurationstext zu prüfen, zu kopieren oder zu bearbeiten. In beiden Ansichten bearbeitest du dieselbe Richtlinie. In der TOML-Ansicht sind auch unterstützte Felder ohne eigenes Bedienelement zugänglich. Für cloudverwaltete Einstellungen brauchst du keine lokale Datei zu verteilen. Für Anmeldebeschränkungen und geräteverwaltete Bereitstellungen gibt es ein separates lokales Setup.
Enterprise-Admins können das Verhalten unterstützter lokaler Clients auf folgende Weise steuern:
-
Anforderungen: Von Admins erzwungene Beschränkungen, die sich durch persönliche Einstellungen nicht außer Kraft setzen lassen.
-
Konfigurationsstandardwerte: Einstellungen in
config.toml, die das System oder die Cloud vorgibt. Nutzende können diese Werte überschreiben. -
Verwaltete Standardwerte für ältere Bereitstellungen: Ausgangswerte aus
managed_config.toml, die ein unterstützter Client beim Start übernimmt. Nutzende können die Einstellungen während der Ausführung ändern. Beim nächsten Start übernimmt der Client erneut die Standardwerte.
Informationen zur globalen Basiskonfiguration, zu umgebungsspezifischen Überschreibungen und zu den Feldern für Orchestrator und Executor findest du unter Agentensicherheit.
Wenn sich deine Teammitglieder ohne ChatGPT bei Codex anmelden, kannst du Standardwerte und Anforderungen über einen selbst betriebenen HTTPS-Endpunkt an Codex CLI und die Desktop-App verteilen. Siehe Codex-Konfiguration für dein Team selbst hosten.
Eine Richtlinie in der Agentensicherheit konfigurieren
Wenn die Agentensicherheit aktiviert ist, können Personen mit der Rolle „Workspace Owner“ oder „Workspace Admin“ sowie Mitglieder mit Codex-Adminrechten Richtlinien verwalten. Der Zugriff auf den Richtlinieneditor gewährt Mitgliedern keinen Zugriff auf die Funktionen, die eine Richtlinie steuert.
Verwende Workspace-Standard für die Basiskonfiguration des Workspace. Verwende Überschreibungen, wenn bestimmte Personen, Gruppen oder Rollen andere Einstellungen benötigen. Mit einer Überschreibung für eine Zielgruppe legst du fest, wer eine Richtlinie erhält. Mit einer Umgebungseinstellung bestimmst du, wo die unterstützten Ausführungseinstellungen gelten.
- Öffne Admin-Konsole > Agentensicherheit. Wähle Workspace-Standard oder unter Überschreibungen die Richtlinie, die du bearbeiten möchtest.
- Öffne Anforderungen, um verbindliche Grenzen festzulegen, oder Standardwerte, um Ausgangswerte vorzugeben, die Mitglieder innerhalb dieser Grenzen ändern können.
- Belasse Einstellungen für Genehmigungen, die Websuche und andere agentenweit geltende Funktionen unter Global. Wähle, sofern verfügbar, auf der entsprechenden Karte Umgebungseinstellungen hinzufügen. Füge Lokale Umgebungen oder Codex Cloud-Umgebungen hinzu, um unterstützte Ausführungseinstellungen festzulegen. Ein leeres Umgebungsdokument erbt die globalen Einstellungen. Es kopiert die aktuelle Basiskonfiguration nicht und schreibt sie auch nicht fest.
- Verwende die in diesem Leitfaden beschriebenen Bedienelemente. Für erweiterte Felder wählst du Als TOML bearbeiten und bearbeitest
requirements.tomloderconfig.tomlim passenden Geltungsbereich. Mit Bedienelemente verwenden kehrst du zum visuellen Editor zurück. - Prüfe die Validierungsmeldungen und wähle Änderungen speichern. Wenn du eine Regel im Regeleditor anwendest, aktualisierst du den Entwurf. Die Richtlinie musst du separat speichern.
- Prüfe die Richtlinienauswahl und das Verhalten der unterstützten Clients wie unter Richtlinien aus Sicht von Admins und Mitarbeitenden prüfen beschrieben.
Welche Umgebungseditoren und Felder verfügbar sind, hängt vom Workspace und von der Richtlinie ab. Lies Geltungsbereiche der Einstellungen, bevor du eine globale Einstellung in eine Umgebung verschiebst. Globale Einstellungen gelten nicht zwangsläufig für jedes Produkt und jeden Ausführungspfad.
Eine Konfiguration kopieren oder wiederverwenden
TOML bleibt auch mit dem visuellen Editor verfügbar. Wähle Als TOML bearbeiten, um eine Konfiguration zu kopieren, eine Referenzkopie aufzubewahren oder Einstellungen in einer anderen Richtlinie wiederzuverwenden. Mit Bedienelemente verwenden wechselst du zurück zum visuellen Editor.
- Öffne die Quellrichtlinie und wähle Als TOML bearbeiten.
- Wähle den Geltungsbereich, den du kopieren möchtest: Global oder einen verfügbaren Umgebungstab. Kopiere je nach Bedarf den Text aus Anforderungen (
requirements.toml), Standardwerte (config.toml) oder aus beiden Bereichen. - Öffne die Zielrichtlinie, wähle Als TOML bearbeiten und dann den entsprechenden Geltungsbereich. Füge Anforderungen in
requirements.tomlund Standardwerte inconfig.tomlein. Prüfe vor dem Ersetzen des Textes die vorhandenen Einstellungen der Zielrichtlinie. Behalte andere Einstellungen bei, die weiterhin gelten sollen. - Prüfe die Validierungsmeldungen, die Zielgruppen und die Priorität der Zielrichtlinie. Wähle Änderungen speichern. Teste das Verhalten des Clients, bevor du dich auf die kopierte Richtlinie verlässt.
Der kopierte Text enthält die Einstellungen, die für diese Richtlinie und diesen Geltungsbereich ausdrücklich festgelegt wurden. Zuweisungen, die Reihenfolge der Richtlinien und andere Umgebungsdokumente sind darin nicht enthalten. Auch die effektive Konfiguration, in die weitere Richtlinien und Geräteeinstellungen einfließen, wird nicht kopiert. Kopiere Umgebungseinstellungen bei Bedarf separat. Ein Ansichtswechsel oder das Kopieren von Text speichert keine Richtlinienänderung.
Probiere es im folgenden Beispiel aus: Ändere eine Einstellung und wähle Als TOML bearbeiten, um die zugehörige Konfiguration zu sehen. Mit Bedienelemente verwenden wechselst du zurück und kannst weitere Einstellungen ausprobieren.
Beispielrichtlinie
Ändere eine Beispieleinstellung und wechsle die Ansicht, um dieselbe Konfiguration als TOML zu sehen.
Anforderungen · Global
Nur ein Beispiel. Änderungen gelten nur auf dieser Seite und wirken sich auf keinen Workspace aus. Die TOML-Ansicht hebt das zuletzt geänderte Feld hervor.
Die passende Einstellung wählen
| Aufgabe | Wo du sie konfigurierst | Wirkung |
|---|---|---|
| Zugriff auf Browser und native Apps beschränken | Anforderungen > Verfügbarkeit von Desktop-Funktionen, Site-Regeln und App-Regeln | Legt fest, welche unterstützten Desktop-Funktionen verfügbar sind und auf welche Sites oder Apps sie zugreifen dürfen. |
| Optionen für Genehmigungen, Sandbox oder Websuche begrenzen | Anforderungen > Richtliniengrenzen | Beschränkt die Auswahl in unterstützten Clients. |
| Ausgangswerte für Genehmigungen, Berechtigungen, Suche oder Tools festlegen | Standardwerte | Legt Werte fest, die Mitglieder im Rahmen der verbindlichen Anforderungen ändern können. |
| Netzwerkziele für Befehle beschränken | Anforderungen > Netzwerknutzung | Wendet verwaltete Netzwerkregeln auf unterstützten Befehlsverkehr an. Der Internetzugriff für den gesamten Workspace wird damit nicht ein- oder ausgeschaltet. |
| Plugins und verwaltete Hooks konfigurieren | Als TOML bearbeiten | Ermöglicht die Konfiguration unterstützter Richtlinienfelder ohne eigenes Bedienelement. |
| Anmeldemethoden oder Workspaces vor der Anmeldung beschränken | Lokale Systemanforderungen oder macOS-MDM | Wendet Anmeldebeschränkungen an, bevor die Cloud-Richtlinie geladen wird. |
Browserzugriff und Computernutzung steuern
Verwalte den Zugriff auf Browser und native Apps für unterstützte Desktop-Clients unter Agentensicherheit in der Admin-Konsole. Beginne mit den Bedienelementen in der Oberfläche. Die folgenden TOML-Beispiele dienen als Referenz für die Bereitstellung von Richtlinien über Dateien und für Einstellungen, die den TOML-Editor erfordern.
Die Funktion Browser steuert Aktionen, die der Agent in einem Browser ausführt. Die Computernutzung steuert seine Aktionen in nativen Desktop-Apps. Für den integrierten Browserbereich gelten separate Einstellungen. Die Unterschiede zwischen den Zugriffswegen findest du unter Browsersitzungen und bestehende Anmeldungen.
Vorbereitungen
Verwende ein Konto, das Richtlinien für die Agentensicherheit verwalten darf. Prüfe, wer die Richtlinie erhält und welche Clientversionen und Betriebssysteme du unterstützen musst. Informationen zu Richtlinienzuweisungen, globalen Einstellungen und unterstützten umgebungsspezifischen Überschreibungen findest du unter Agentensicherheit.
Verwende Anforderungen für Grenzen, die Nutzende nicht aufheben können. Standardwerte legen die Ausgangswerte innerhalb dieser Grenzen fest. Wenn du eine Site oder App zulässt, wird dadurch weder ein Plugin installiert noch eine Betriebssystemberechtigung erteilt. Die Freigabe meldet auch niemanden an und genehmigt keine Aktion, die noch geprüft werden muss.
Prüfe unter Verfügbarkeit von Desktop-Funktionen die Einstellungen Browser, Externe Browsernutzung und Computernutzung. Deaktivierung erzwingen schaltet die jeweilige Funktion ab. Eine Freigaberegel für eine Site oder App kann sie nicht wieder aktivieren. Prüfe Vollständiger CDP-Zugriff separat. Aktivierung durch Nutzende blockieren verhindert, dass Nutzende diesen Zugriff einschalten.
Diese Desktop-Einstellungen konfigurieren den gehosteten Browser von Work Cloud nicht. Verwalte Cloud-Browsernutzung und Cloud-Netzwerkzugriff separat unter Admin-Konsole > Berechtigungen und Rollen > Workspace-Funktionen > Cloud-Computerfunktionen. Siehe Geltungsbereich der Agentensicherheit in Work Cloud.
Browserzugriff konfigurieren
- Öffne Admin-Konsole > Agentensicherheit. Wähle Workspace-Standard für die Basiskonfiguration des Workspace oder öffne unter Überschreibungen die entsprechende Richtlinie. Gehe unter Anforderungen zu Desktop-Browsereinstellungen.
- Öffne unter Site-Regeln das Aktionsmenü der Zeile Standard und wähle Standard bearbeiten. Um den Zugriff auf freigegebene Sites zu beschränken, setze Site-Zugriff auf Blockieren und wähle Regel anwenden. Die Zeile Standard liefert die Werte für Einstellungen, die in einer passenden Site-Regel auf Standardregel verwenden stehen.
- Wähle Site-Regel hinzufügen. Gib unter Site oder Muster einen Origin an, bestehend aus Schema, Hostname und optionalem Port. Beispielsweise ist
https://example.comgültig,https://example.com/fileshingegen nicht. Lass Pfad, Abfrageparameter und Fragment weg. HTTP und HTTPS ergeben unterschiedliche Origins. Gib den Port an, wenn er vom Standardport des Schemas abweicht. - Lege Site-Zugriff fest und prüfe Downloads, Uploads und Debugging/CDP. Wähle je nach Bedarf Zulassen oder Blockieren oder belasse die Einstellung bei Standardregel verwenden. Debugging/CDP steuert den vollständigen Zugriff auf das Chrome DevTools Protocol für das Browser-Debugging. Bei Zulassen durchläuft die Aktion weiterhin die regulären Richtlinien- und Genehmigungsprüfungen.
- Prüfe Automatische Überprüfung, Immer zulassen und Genehmigungsdauer für die Site. Unter Genehmigungsdauer kannst du Dieser Turn oder Dieser Thread wählen. Prüfe außerdem Browserverlauf, Site-Genehmigungen speichern und Anfragen automatisch genehmigen unter Desktop-Browsereinstellungen.
- Wähle Regel hinzufügen, prüfe die Validierungsmeldungen und wähle Änderungen speichern. Teste eine zugelassene und eine blockierte Site auf einem unterstützten Client, der die Richtlinie erhält. Teste Uploads, Downloads und andere beschränkte Aktionen separat.
Wenn du die Funktion „Automatische Überprüfung“ für Browseraktionen deaktivierst, werden diese Aktionen den Nutzenden zur Genehmigung vorgelegt. Die Sicherheitsüberwachung des Modells bleibt aktiv.
Treffen mehrere Origin-Muster zu, gilt für jede Einstellung der strengste Wert. Eine lokale Konfiguration kann ein verwaltetes Verbot nicht lockern. Verwaltete Netzwerksperren und exklusive Zulassungslisten gelten auch für Browsertools. Informationen zu Origin-Mustern und Genehmigungen findest du in der Referenz der Browser-Richtlinienfelder.
Über die Computernutzung kann der Agent einen Browser auch als native App bedienen. Die Site- und Funktionsregeln der Funktion Browser gelten für diesen Zugriffsweg nicht. Prüfe den Zugriff auf native Apps separat. Siehe Sicherheitsgrenzen beim Browserzugriff.
Zugriff auf native Apps konfigurieren
- Gehe unter Anforderungen zu Desktop-App-Einstellungen > App-Regeln.
- Konfiguriere über das Aktionsmenü der Zeile Standard den Zugriff auf Apps, für die keine Regel zutrifft. Um die Computernutzung auf freigegebene Apps zu beschränken, blockiere den Zugriff standardmäßig und füge für diese Apps Freigaberegeln hinzu.
- Wähle App-Regel hinzufügen. Wähle im Dialog Regel bearbeiten einen der Typen macOS-Bundle-ID, Windows-AUMID oder Ausführbare Windows-Datei aus der Liste App. Gib für eine Bundle-ID oder Application User Model ID (AUMID) die genaue App-Kennung ein. Gib bei Ausführbare Windows-Datei den Herausgebernamen und den Produktnamen an. Der Name der Binärdatei ist optional. Verwende verifizierte Angaben zur Identität der App. Ein Anzeigename oder Dateipfad reicht nicht aus.
- Lege den App-Zugriff für die Regel fest und wähle Regel hinzufügen. Prüfe App-Genehmigungen speichern unter Desktop-App-Einstellungen sowie die Validierungsmeldungen und wähle Änderungen speichern. Auch wenn du das Speichern deaktivierst, sind Genehmigungen für die aktuelle Sitzung möglich. Wenn du das Speichern zulässt, erteilst du damit noch keiner App eine Genehmigung.
- Teste auf jedem unterstützten Betriebssystem deiner Bereitstellung eine zugelassene und eine blockierte App. Vergewissere dich, dass Betriebssystemberechtigungen weiterhin gelten und Nutzende erforderliche Genehmigungen weiterhin erteilen müssen.
Die Anforderungen zur Identifizierung von Windows-Apps findest du unter Richtlinienfelder für die Computernutzung. Für verwaltete Macs siehe Nutzung bei gesperrtem Computer beschränken.
Die effektive Richtlinie prüfen
Wenn eine zugelassene Site oder App weiterhin blockiert wird, prüfe weitere passende Regeln, die Zuweisungen und Prioritäten der Richtlinien, die Geräteanforderungen und die persönliche Konfiguration. Eine Freigaberegel in einer Quelle setzt ein anderes geltendes Verbot nicht außer Kraft. Siehe Quellen und Rangfolge der Anforderungen.
Wenn eine Einstellung keine Wirkung zeigt, prüfe, ob Client, Betriebssystem und Bereitstellungsweg der Richtlinie sie unterstützen. Achte besonders auf Work Cloud mit lokalem Computerzugriff. Einige Felder werden nur teilweise unterstützt oder müssen noch validiert werden. Siehe Work-Kompatibilität in der Konfigurationsreferenz.
Prüfe Workspace-Berechtigungen und Plugin-Einstellungen separat, wenn jemand keinen Zugriff auf die Funktion oder das erforderliche Plugin hat.
TOML-Konfigurationsreferenz
Die folgenden Beispiele setzen dieselben Richtlinienziele in requirements.toml um. Verwende sie, wenn du Richtlinien über Dateien oder den TOML-Editor verwaltest. Für die Bedienelemente der Agentensicherheit brauchst du keine lokale Datei zu bearbeiten.
Dieses Browserbeispiel verweigert den Zugriff standardmäßig, lässt https://example.com zu, blockiert dort Uploads und den vollständigen CDP-Zugriff und begrenzt die Genehmigung für den Site-Zugriff auf den aktuellen Turn:
[browser_use]
allow_history_access = false
allow_global_persistent_approval = false
[browser_use.default_origin_policy]
access = "deny"
[browser_use.origins."https://example.com"]
access = "allow"
uploads = "deny"
downloads = "allow"
full_cdp_access = "deny"
persistent_approval = false
access_approval_lifetime = "turn"
Um die Funktion „Automatische Überprüfung“ für Browseraktionen zu deaktivieren, setze browser_use.disable_auto_review = true. Um sie nur für einen bestimmten Origin zu beschränken, setze in dessen Richtlinie auto_review = "deny".
Lass bei unterstützten verwalteten Plänen browser_use.allow_webmcp weg oder setze das Feld auf true, um Site-Tools über die Workspace-Richtlinie im integrierten Browser der Desktop-App zuzulassen. Setze es auf false, um den Zugriff über diese Richtlinie zu deaktivieren. Wer für das eigene Konto bereits Zugriff erhalten hat, kann Site-Tools weiterhin verwenden. Die Verfügbarkeit hängt außerdem von der Modellunterstützung, den Browsereinstellungen und den Site-Berechtigungen ab.
Dieses Beispiel für native Apps lässt den Rechner unter macOS zu, verweigert standardmäßig den Zugriff auf andere Apps und verhindert, dass App-Genehmigungen über eine Sitzung hinaus gültig bleiben:
[computer_use]
default_app_access = "deny"
allow_persistent_approval = false
[computer_use.macos.bundle_ids]
"com.apple.calculator" = "allow"
Windows-Richtlinien können paketierte Apps mit computer_use.windows.aumids oder ausführbare Dateien mit computer_use.windows.exes identifizieren. Regeln für ausführbare Dateien erfordern publisher_name, product_name und access. binary_name ist optional.
Alle unterstützten Felder und Werte findest du in der Referenz zu requirements.toml. Um eine Funktion vollständig zu deaktivieren, statt einzelne Sites oder Apps einzuschränken, siehe Feature-Flags fest vorgeben.
Weitere Desktop-Einstellungen
Die folgenden Desktop-Einstellungen betreffen die Funktionsverfügbarkeit, die Nutzung bei gesperrtem Computer, Appshots und die Fernsteuerung von Geräten. Für die Funktionsverfügbarkeit und die Nutzung bei gesperrtem Computer gibt es eigene Bedienelemente. Appshots und die Fernsteuerung konfigurierst du über Als TOML bearbeiten. Informationen zu Zielbeschränkungen für den Netzwerkverkehr der Desktop-App findest du unter Netzwerkziele der Desktop-App steuern.
Feature-Flags fest vorgeben
Öffne für die in der Agentensicherheit verfügbaren Desktop-Funktionen Global > Anforderungen > Verfügbarkeit von Desktop-Funktionen. Setze In-App-Browser, Browser, Externe Browsernutzung oder Computernutzung auf Deaktivierung erzwingen, um die jeweilige Funktion abzuschalten. Wähle dann Änderungen speichern. Wähle für Vollständiger CDP-Zugriff die Option Aktivierung durch Nutzende blockieren, damit Nutzende ihn nicht einschalten können. Wenn du eine Funktion zulässt, bleibt ihre Verfügbarkeit vom Produkt, der Plattform und dem Stand der Einführung abhängig.
Verwende für weitere unterstützte Feature-Flags die Option Als TOML bearbeiten und das globale Dokument requirements.toml oder eine unterstützte lokale Quelle für Anforderungen. Die folgenden Beispiele geben Werte für Funktionen der Laufzeitumgebung und des Desktops vor:
[features]
hooks = true
unified_exec = false
# Disable surface-specific features when needed.
browser_use = false
browser_use_full_cdp_access = false
browser_use_external = false
in_app_browser = false
in_app_updates = false
computer_use = false
Verwende für Laufzeitfunktionen die kanonischen Schlüssel aus config.toml, die in der Tabelle [features] stehen. Die lokale Laufzeitumgebung passt erkannte Funktionen an diese Vorgaben an. Sie weist Änderungen an Funktionseinstellungen in config.toml oder in Profildateien zurück, wenn diese den Vorgaben widersprechen.
Mit der verwalteten Einstellung unified_exec = false lassen sich weiterhin Befehle ausführen. Prozesse können jedoch nicht fortgesetzt werden, und das Tool write_stdin ist deaktiviert. Über die persönliche Konfiguration lässt sich diese Funktion nicht deaktivieren.
in_app_browser = falsedeaktiviert den integrierten Browserbereich.in_app_updates = falsedeaktiviert beim Neustart die integrierte Updatefunktion der ChatGPT-Desktop-App, sofern unterstützt. Die externe Paketbereitstellung bleibt davon unberührt. Die Unterstützung älterer App-Versionen verlängert sich dadurch nicht. Hinweise zum Setup und zur Einführung findest du unter App-Updates verwalten.browser_use = falsedeaktiviert die unterstützten Fähigkeiten der Funktion Browser. Für die externe Browsernutzung und die Computernutzung in nativen Apps gibt es separate Einstellungen.browser_use_full_cdp_access = falsedeaktiviert den vollständigen CDP-Zugriff in der lokalen Laufzeitumgebung einschließlich des Browser-Entwicklermodus. Die ChatGPT-Desktop-App kann die entsprechende Einstellung dann nicht aktivieren.browser_use_external = falsedeaktiviert Browseraktionen des Agenten über unterstützte Browsererweiterungen.computer_use = falsedeaktiviert die Computernutzung in nativen Apps, einschließlich der Bedienung eines Browsers als native App. Auch „Aufzeichnen und Wiedergeben“ und die zugehörigen Installations- und Setup-Abläufe werden deaktiviert.
Wenn du nur die Funktion Browser deaktivierst, bleiben andere Zugriffswege zum Browser offen. Über die Computernutzung kann der Agent einen Browser weiterhin als native App bedienen, wenn sowohl die Funktion als auch der App-Zugriff zulässig sind. Die Site- und Funktionsregeln der Funktion Browser gelten für diesen Weg nicht. Um ihn zu sperren, setze Computernutzung auf Deaktivierung erzwingen (computer_use = false). Sollen andere native Apps verfügbar bleiben, kannst du die Browser-App über die App-Regeln sperren. Prüfe Externe Browsernutzung und In-App-Browser separat. Welche Einstellungen für welchen Zugriffsweg gelten, erfährst du unter Browsersitzungen und bestehende Anmeldungen.
Wenn du diese Schlüssel weglässt, lässt die Richtlinie die Funktionen zu. Es gelten die üblichen Bedingungen für Client, Plattform und Einführung.
Nutzung bei gesperrtem Computer beschränken
Um zu verhindern, dass Nutzende die Nutzung bei gesperrtem Computer auf einem verwalteten Mac aktivieren, öffne Global > Anforderungen > Desktop-App-Einstellungen, setze Nutzung bei gesperrtem Computer zulassen auf Deaktiviert und wähle Änderungen speichern. Auf einem Mac, auf dem die Funktion bereits aktiviert ist, schaltet diese Einstellung sie nicht aus.
Die entsprechende Anforderung für den TOML-Editor oder die geräteverwaltete Bereitstellung lautet:
[computer_use]
allow_locked_computer_use = false
Diese Anforderung entfernt die Bedienelemente zum Aktivieren der Nutzung bei gesperrtem Computer. Eine bereits aktivierte Funktion wird dadurch nicht abgeschaltet. Wenn du die Anforderung weglässt, gelten die reguläre Produktverfügbarkeit und die lokale Einstellung der jeweiligen Person.
Appshots deaktivieren
Mit Appshots können unterstützte Clients Momentaufnahmen von Anwendungen einbinden. Um Appshots für Personen mit cloudverwalteter Konfiguration zu deaktivieren, öffne in der Agentensicherheit Als TOML bearbeiten und setze das Feld allow_appshots auf der obersten Ebene der globalen requirements.toml. Verwende für geräteverwaltete Bereitstellungen die entsprechende lokale Quelle für Anforderungen:
allow_appshots = false
Wo Appshots verfügbar sind, deaktiviert allow_appshots = false die Funktion. Wenn du den Schlüssel weglässt, schränken die Anforderungen Appshots nicht ein. Es gelten die regulären Verfügbarkeitsprüfungen des Produkts. Clients des App Server, die effektive Anforderungen über configRequirements/read abrufen, erhalten dieselbe Beschränkung als allowAppshots. Fehlt der Wert oder steht er auf null, deaktiviert allowAppshots die Funktion nicht.
Fernsteuerung von Geräten deaktivieren
Um die Fernsteuerung von Geräten für Personen mit cloudverwalteter Konfiguration zu deaktivieren, wähle in der Agentensicherheit Als TOML bearbeiten. Setze das Feld allow_remote_control auf der obersten Ebene der globalen requirements.toml. Du kannst allow_remote_control auch in einer unterstützten lokalen Quelle für Anforderungen setzen:
allow_remote_control = false
Wo die Fernsteuerung von Geräten unterstützt wird, deaktiviert allow_remote_control = false die Funktion. Wenn du den Schlüssel weglässt, schränken die Anforderungen die Fernsteuerung nicht ein. Es gelten die regulären Verfügbarkeitsprüfungen des Produkts. SSH-Remoteverbindungen werden durch diese Anforderung nicht deaktiviert.
Genehmigungen und Ausführungsberechtigungen festlegen
Hier legst du fest, wann Genehmigungen erforderlich sind, welche Berechtigungen zulässig sind und mit welchen Standardwerten Nutzende beginnen. Beginne mit Richtliniengrenzen und Standardwerten. Die folgenden Aufgaben erläutern TOML-Anforderungen für die verbindliche Wahl der Prüfinstanz, eigene Berechtigungsprofile, Dateisystembeschränkungen, hostspezifische Überschreibungen und Befehlsregeln.
Von Admins erzwungene Anforderungen (requirements.toml)
Anforderungen beschränken sicherheitsrelevante Einstellungen. Dazu zählen die Genehmigungsrichtlinie, die Prüfinstanz für Genehmigungen, die Richtlinie für die Funktion „Automatische Überprüfung“, der Sandbox-Modus, Berechtigungsprofile, der Websuchmodus und verwaltete Hooks. Anforderungen legen außerdem fest, welche MCP-Server Nutzende aktivieren und welche Quellen für den Plugin-Marketplace sie verwenden dürfen. Beim Zusammenführen der Konfiguration, etwa aus config.toml, Profildateien oder CLI-Überschreibungen, prüft der lokale Client die Werte. Widerspricht ein Wert einer verbindlichen Regel, verwendet der Client einen kompatiblen Wert und benachrichtigt die betreffende Person. Wenn du eine Zulassungsliste für mcp_servers konfigurierst, aktiviert der Client einen MCP-Server nur, wenn sowohl Name als auch Identität mit einem genehmigten Eintrag übereinstimmen. Andernfalls deaktiviert er ihn.
Anforderungen können auch Feature-Flags über die Tabelle [features] in requirements.toml beschränken. Funktionen sind nicht immer sicherheitsrelevant. Unternehmen können ihre Werte bei Bedarf dennoch fest vorgeben. Für ausgelassene Schlüssel gibt es keine solche Vorgabe.
Verwende ab Codex 0.138.0 vorzugsweise Berechtigungsprofile mit allowed_permission_profiles und verwalteten default_permissions. Verwende allowed_sandbox_modes nur für ältere Bereitstellungen, die noch sandbox_mode konfigurieren.
Die genaue Liste der Schlüssel findest du im Abschnitt zu requirements.toml in der Konfigurationsreferenz.
Grenzen für Genehmigungen, Sandbox und Websuche festlegen
Unter Anforderungen > Richtliniengrenzen kannst du die Auswahl in unterstützten Clients begrenzen. Diese Einstellungen schränken die Konfiguration ein. Den Ausgangswert legst du separat unter Standardwerte fest.
- Öffne unter Global die Genehmigungsrichtlinien und wähle die zulässigen Verfahren. Mit Bei Bedarf nachfragen darf der Agent beispielsweise für Aktionen, die erweiterte Rechte außerhalb der Sandbox benötigen, eine Genehmigung anfordern. Nie nachfragen verhindert Genehmigungsanfragen, gewährt aber keine uneingeschränkte Ausführung.
- Öffne Sandbox-Modi, um die Auswahl bei älteren Sandbox-Konfigurationen zu begrenzen. Schreibgeschützt beschränkt Schreibzugriffe. Schreibzugriff im Workspace erlaubt Schreibzugriffe im Workspace und in den konfigurierten beschreibbaren Stammverzeichnissen. Vollzugriff hebt das Sandboxing für das Dateisystem auf. Verwende Anforderungen an Berechtigungsprofile für Bereitstellungen, die Berechtigungsprofile anstelle von
sandbox_modeverwenden. - Öffne unter Global die Websuchmodi, um die Websuche zu beschränken. Wähle Zwischengespeichert, um die Suche in zwischengespeicherten Ergebnissen ohne Live-Suche zu erlauben, oder Deaktiviert, um die Websuche abzuschalten. Beschränkungen der Websuche gelten unabhängig von Netzwerkregeln für Befehle.
- Prüfe die zulässigen Optionen und die zugehörigen Standardwerte und wähle Änderungen speichern.
Wenn du eine Anforderung nicht setzt, legt diese Richtlinie dafür keine Grenze fest. Andere zutreffende Richtlinien gelten weiterhin. Die Option Bei nicht vertrauenswürdigen Befehlen nachfragen entspricht untrusted in der Zulassungsliste der Anforderungen. Sie stellt die nicht mehr unterstützte explizite Einstellung approval_policy = "untrusted" nicht wieder her. Beachte dafür die folgenden Migrationshinweise.
Um die Websuche zu beschränken, verwende Global > Anforderungen > Richtliniengrenzen > Websuchmodi. Die entsprechende TOML-Konfiguration lautet:
allowed_web_search_modes = ["cached"] # "disabled" remains implicitly allowed
allowed_web_search_modes = [] erlaubt nur "disabled". Beispielsweise verhindert allowed_web_search_modes = ["cached"] die Live-Websuche auch in Sitzungen mit danger-full-access.
Konfigurationsstandardwerte festlegen
Standardwerte geben Mitgliedern eine Ausgangskonfiguration. Sie erzwingen keine Beschränkung und gewähren keinen Zugriff auf eine Workspace-Funktion.
- Öffne die Karte Standardwerte der Richtlinie. Belasse agentenweite Standardwerte unter Global. Verwende für unterstützte Standardwerte zur Ausführung einen verfügbaren Umgebungstab.
- Wähle unter Befehlsausführung die anfängliche Genehmigungsrichtlinie, die Prüfinstanz für Genehmigungen und je nach Konfiguration den Sandbox-Modus oder die Standardberechtigungen. Die Prüfinstanz bestimmt, wer Genehmigungsanfragen standardmäßig prüft. Die Genehmigungsrichtlinie bestimmt, wann solche Anfragen möglich sind.
- Wähle unter Websuche den anfänglichen Modus für die Websuche und den Websuchkontext. Prüfe unter Apps und Tools die Einstellungen Apps/Konnektoren, Tools mit Außenwirkung und Destruktive Tools für unterstützte App-Tools.
- Vergewissere dich, dass die Standardwerte deine Anforderungen erfüllen, und wähle Änderungen speichern.
Verwende Als TOML bearbeiten für unterstützte Standardwerte ohne visuelle Bedienelemente, etwa für die Konfiguration des Plugin-Marketplace. Für diese Cloud-Standardwerte gilt die reguläre Rangfolge der Konfiguration. Sie unterscheidet sich von der Rangfolge für die ältere managed_config.toml, bei der verwaltete Standardwerte beim Start Vorrang vor der lokalen Konfiguration haben.
Beispiel für requirements.toml
Dieses Beispiel blockiert --ask-for-approval never und --sandbox danger-full-access (einschließlich --yolo):
allowed_approval_policies = ["untrusted", "on-request"]
allowed_sandbox_modes = ["read-only", "workspace-write"]
Hier erhält untrusted das strengere Genehmigungsverfahren, das sich aus trust_level = "untrusted" ergibt. Dadurch wird approval_policy = "untrusted" nicht wieder als explizite Einstellung unterstützt.
Die nicht mehr unterstützte Genehmigungsrichtlinie untrusted migrieren
Codex und ChatGPT Work unterstützen approval_policy = "untrusted" nicht mehr. Entferne die Einstellung aus verwalteten Standardwerten, der älteren managed_config.toml und allen persönlichen, projektbezogenen, profilbezogenen oder beim Start geladenen Konfigurationen, die sie setzen.
Wähle für die interaktive Nutzung ohne Schreibzugriff approval_policy = "on-request" und verwende eine Sandbox oder ein Berechtigungsprofil ohne Schreibzugriff. Deine verwalteten Anforderungen müssen die Auswahl zulassen. Befehle, die diese Sandbox erlaubt, können ohne Genehmigung ausgeführt werden.
Um strengere Genehmigungsanforderungen für Befehle beizubehalten, lass die explizite Einstellung approval_policy weg. Setze trust_level = "untrusted" im Projekteintrag der persönlichen ~/.codex/config.toml und behalte untrusted in allowed_approval_policies bei. Dadurch wird auch die projektlokale Konfiguration deaktiviert. Ein explizit gesetztes on-request überschreibt diese Richtlinie. Beispiele und Hinweise zur Sicherheitsabwägung findest du unter Migration von der nicht mehr unterstützten Genehmigungsrichtlinie untrusted.
Richtlinie für die automatische Überprüfung konfigurieren
Um „Automatische Überprüfung“ als Standard festzulegen, wähle Global > Standardwerte > Befehlsausführung > Prüfinstanz für Genehmigungen. Nutzende können weiterhin eine andere zulässige Prüfinstanz wählen. Um die automatische Überprüfung vorzuschreiben oder die Richtlinie der Prüfinstanz zu ersetzen, wähle Als TOML bearbeiten und bearbeite die globale requirements.toml. Für die automatische Überprüfung von Browseraktionen gibt es separate Einstellungen.
Das folgende Beispiel schreibt die automatische Überprüfung für Genehmigungsanfragen vor, die dafür infrage kommen. Um auch manuelle Genehmigungen zuzulassen, nimm "user" in allowed_approvals_reviewers auf.
allowed_approval_policies = ["on-request"]
allowed_approvals_reviewers = ["auto_review"]
Um die gesamte Richtlinie zu ersetzen, verwende guardian_policy_config. Unter Konfiguration der automatischen Überprüfung findest du die Standardrichtlinie und eine Anleitung zum Erstellen einer Ersatzrichtlinie.
Verfügbare Berechtigungsprofile steuern
Wähle unter Standardwerte > Befehlsausführung > Standardberechtigungen das integrierte Profil, mit dem Nutzende beginnen. Um die auswählbaren Profile verbindlich festzulegen oder eigene Profile zu definieren, wähle Als TOML bearbeiten. Konfiguriere requirements.toml im globalen Geltungsbereich oder im Geltungsbereich einer unterstützten Ausführungsumgebung. Die Wahl eines Standardprofils allein schränkt die verfügbaren Profile nicht ein.
Mit allowed_permission_profiles legst du fest, welche integrierten und eigenen Berechtigungsprofile Nutzende auswählen können. Für Berechtigungsprofile erfüllt diese Einstellung dieselbe Aufgabe wie allowed_sandbox_modes für Sandbox-Modi. Wähle die Zulassungsliste passend dazu, wie deine Teammitglieder ihre Berechtigungen auswählen.
Zulassungslisten für Berechtigungsprofile erfordern Codex 0.138.0 oder neuer. Codex 0.137.0 und ältere Versionen ignorieren allowed_permission_profiles und verwaltete default_permissions.
Verwende die folgenden Beispiele erst, wenn alle verwalteten Clients eine Version ausführen, die diese Anforderungen unterstützt. Stelle eigene verwaltete Profile erst bereit, nachdem das Upgrade auf allen Geräten abgeschlossen ist.
Ist die Tabelle vorhanden, enthält sie die vollständige Liste der zulässigen Profile. Sie erlaubt Profile mit dem Wert true und sperrt ausgelassene Profile sowie Profile mit dem Wert false. Das gilt auch für integrierte Profile, die in künftigen Codex-Versionen hinzukommen.
Standardprofile zulassen
Diese Richtlinie erlaubt die Nutzung ohne Schreibzugriff sowie den Workspace-Zugriff, aber keinen Vollzugriff:
default_permissions = ":workspace"
[allowed_permission_profiles]
":read-only" = true
":workspace" = true
# ":danger-full-access" is omitted, so it is denied.
Ein verwaltetes Standardprofil mit minimalen Berechtigungen hinzufügen
Admins können ein eigenes Profil in derselben Quelle für Anforderungen definieren. Verwende organisationsspezifische Profilnamen, die nicht mit Namen aus der geladenen persönlichen Konfiguration kollidieren. Eigene Namen dürfen weder mit : beginnen noch den reservierten Namen filesystem verwenden.
Stelle eigene verwaltete Profile nicht für Clients mit Codex 0.137.0 oder älter bereit. Diese Clients erkennen die Profiltabelle, aber nicht den verwalteten Standardwert, der das Profil auswählt.
Beispiel:
default_permissions = "acme_review_only"
[allowed_permission_profiles]
":read-only" = true
":workspace" = true
acme_review_only = true
# ":danger-full-access" is intentionally omitted, so it is denied.
[permissions.acme_review_only]
description = "Review code without modifying the workspace."
extends = ":read-only"
Nur vom Unternehmen definierte Profile zulassen
Lass alle integrierten Profile weg, wenn Nutzende nur von Admins definierte Profile auswählen sollen:
default_permissions = "acme_workspace"
[allowed_permission_profiles]
acme_workspace = true
[permissions.acme_workspace]
description = "Workspace access with sensitive files denied."
extends = ":workspace"
[permissions.acme_workspace.filesystem]
glob_scan_max_depth = 3
[permissions.acme_workspace.filesystem.":workspace_roots"]
"**/*.env" = "deny"
Das eigene Profil kann :workspace erweitern, auch wenn Nutzende das integrierte Profil :workspace nicht direkt auswählen können.
Ein von einer anderen Quelle zugelassenes Profil deaktivieren
Zulassungslisten für Berechtigungen werden anhand der Profilnamen zusammengeführt. Da Cloud-Anforderungen Vorrang vor Systemanforderungen haben, kannst du mit false in den Cloud-Anforderungen ein Profil deaktivieren, das die Systemdatei zulässt.
Cloud-Anforderungen:
default_permissions = ":read-only"
[allowed_permission_profiles]
":read-only" = true
":workspace" = false
Systemanforderungen:
[allowed_permission_profiles]
":read-only" = true
":workspace" = true # Not honored because cloud requirements set this to false.
Setze default_permissions ausdrücklich auf ein zulässiges Profil. Fehlt der Wert, verwendet die lokale Laufzeitumgebung nur dann :workspace als Standard, wenn sowohl :workspace als auch :read-only ausdrücklich zugelassen sind. Fehlt allowed_permission_profiles, schränken verwaltete Anforderungen die auswählbaren Profilnamen nicht ein. Jeder Eintrag muss ein integriertes Profil oder ein eigenes Profil benennen, das in einer geladenen Konfiguration oder Anforderungsquelle definiert ist. Definiere eigene Profile in den verwalteten Anforderungen, um ihr Verhalten zentral zu steuern.
Leseverbote durchsetzen
Wähle Als TOML bearbeiten, um Dateisystembeschränkungen in der requirements.toml für den globalen Geltungsbereich oder eine unterstützte Ausführungsumgebung hinzuzufügen. Diese Beschränkungen blockieren Lesezugriffe auf sensible Pfade. Ein Standardprofil ohne Schreibzugriff allein verbirgt keine Dateien.
Admins können Lesezugriffe für exakte Pfade oder Glob-Muster mit [permissions.filesystem] verbieten. Über die lokale Konfiguration lassen sich diese Anforderungen nicht abschwächen.
[permissions.filesystem]
deny_read = [
# values can be absolute paths...
"/**/*.env",
# ...or relative to $HOME/%USERPROFILE% using `~`.
"~/.ssh",
# But relative paths starting with `./` are not allowed.
]
Wenn Leseverbote vorliegen, lehnt die lokale Laufzeitumgebung Vollzugriff ab. Sie führt lokale Aktionen in einer Sandbox ohne Schreibzugriff oder einer Workspace-Sandbox aus, damit sie die Verbote durchsetzen kann. Unter nativem Windows gilt ein verwaltetes deny_read für Tools, die direkt auf Dateien zugreifen. Lesezugriffe von Shell-Unterprozessen unterliegen dieser Sandbox-Regel nicht.
Sandbox-Anforderungen je nach Host überschreiben
Wähle in der Agentensicherheit Als TOML bearbeiten, um hostspezifische Anforderungen zu definieren. Umgebungseinstellungen wählen eine Ausführungsumgebung aus. Hostmuster bestimmen, für welche Rechner innerhalb der unterstützten Laufzeitumgebung eine Regel gilt.
Verwende [[remote_sandbox_config]], wenn eine verwaltete Richtlinie je nach Host unterschiedliche Sandbox-Anforderungen anwenden soll. So kannst du beispielsweise strengere Standardwerte für Laptops beibehalten und zugleich Schreibzugriffe im Workspace auf passenden Entwicklungsrechnern oder CI-Runnern zulassen. Hostspezifische Einträge überschreiben derzeit nur allowed_sandbox_modes:
allowed_sandbox_modes = ["read-only"]
[[remote_sandbox_config]]
hostname_patterns = ["*.devbox.example.com", "runner-??.ci.example.com"]
allowed_sandbox_modes = ["read-only", "workspace-write"]
Die lokale Laufzeitumgebung vergleicht jeden Eintrag in hostname_patterns mit dem Hostnamen, den sie ermitteln konnte. Sie verwendet nach Möglichkeit den vollständig qualifizierten Domainnamen, andernfalls den lokalen Hostnamen. Groß- und Kleinschreibung spielt beim Abgleich keine Rolle. * steht für eine beliebige Zeichenfolge, ? für ein einzelnes Zeichen.
Innerhalb derselben Anforderungsquelle gilt der erste passende [[remote_sandbox_config]]-Eintrag. Passt keiner, behält die lokale Laufzeitumgebung den Wert von allowed_sandbox_modes auf der obersten Ebene bei. Der Hostnamenabgleich dient ausschließlich der Richtlinienauswahl und eignet sich nicht als authentifizierter Identitätsnachweis für ein Gerät.
Befehlsregeln über Anforderungen durchsetzen
Wähle in der Agentensicherheit Als TOML bearbeiten, um Befehlsregeln und Beschränkungen für MCP-Server in der globalen requirements.toml hinzuzufügen. Befehlsregeln legen fest, welche passenden Befehle eine Genehmigung erfordern oder verboten sind. MCP-Beschränkungen bestimmen, welche Serveridentitäten der Client aktivieren kann. Mit dem Bedienelement Genehmigungsrichtlinien lässt sich keiner dieser beiden Regelsätze erstellen.
Admins können restriktive Befehlsregeln auch über requirements.toml durchsetzen. Verwende dafür die Tabelle [rules]. Diese Regeln werden mit regulären .rules-Dateien zusammengeführt. Die strengste Entscheidung hat weiterhin Vorrang.
Anders als in .rules müssen Regeln in Anforderungen decision angeben. Zulässig sind "prompt" oder "forbidden", nicht "allow".
[rules]
prefix_rules = [
{ pattern = [{ token = "rm" }], decision = "forbidden", justification = "Use git clean -fd instead." },
{ pattern = [{ token = "git" }, { any_of = ["push", "commit"] }], decision = "prompt", justification = "Require review before mutating history." },
]
Um die MCP-Server zu beschränken, die ein lokaler Client aktivieren kann, füge eine Zulassungsliste für mcp_servers hinzu. Gleiche bei stdio-Servern command ab, bei Servern mit streambarem HTTP url:
[mcp_servers.docs]
identity = { command = "codex-mcp" }
[mcp_servers.remote]
identity = { url = "https://example.com/mcp" }
Wenn identity.command als Zeichenfolge angegeben ist, wird nur der konfigurierte Wert von command abgeglichen. Die Prüfung berücksichtigt weder args noch cwd, env oder env_vars.
Um einen vollständigen stdio-Aufruf einzuschränken, gleiche die ausführbare Datei und jedes Positionsargument ab:
[mcp_servers.internal.identity]
command = { executable = "/usr/local/bin/codex-mcp", args = [
{ match = "exact", value = "serve" },
{ match = "prefix", value = "--workspace=" },
] }
Die ausführbare Datei, die Anzahl der Argumente und ihre Reihenfolge müssen übereinstimmen. Regeln für Argumente und URLs unterstützen exact, prefix und regex für den gesamten Wert. Auch strukturierte Befehlsregeln prüfen weder cwd noch env oder env_vars. Mit Plugins ausgelieferte MCP-Server verwenden dieselben Identitätsformate unter plugins.<plugin>.mcp_servers.<server>.
Wenn mcp_servers vorhanden, aber leer ist, deaktiviert der lokale Client alle MCP-Server.
Netzwerkzugriff konfigurieren
Für Befehle und die Desktop-App gelten unterschiedliche Netzwerkeinstellungen. Beginne für unterstützten Befehlsverkehr mit Netzwerknutzung, prüfe die Grenzen der Umgebung und der Laufzeitumgebung und verwende bei Bedarf die separaten Anforderungen für die Desktop-App. Site-Regeln für den Browser findest du unter Browserzugriff und Computernutzung steuern.
Systemproxy für Anfragen nativer Clients verwenden
Mit der experimentellen Einstellung features.respect_system_proxy kann die native Codex-Laufzeitumgebung, die ChatGPT auf dem Desktop und Codex verwenden, für ihre eigenen Netzwerkanfragen die Proxy-Einstellungen des Betriebssystems nutzen. Aktiviere sie auf Geräten, die einen Systemproxy oder eine automatische Proxy-Konfiguration (PAC) benötigen. Der Standardwert ist false.
Füge Folgendes in einer unterstützten Quelle für config.toml-Standardwerte oder in managed_config.toml hinzu:
[features]
respect_system_proxy = true
Über die projektlokale Konfiguration lässt sich diese Einstellung nicht aktivieren. Nimm für macOS-MDM dasselbe TOML in config_toml_base64 auf. Starte den Client nach einer Änderung der lokalen Konfiguration neu. Um die Aktivierung rückgängig zu machen, setze die Einstellung in der Konfigurationsquelle, in der du sie aktiviert hast, auf false.
Anmeldung und Cloud-Standardwerte
Die separate Funktion system_proxy_fallback ist standardmäßig aktiviert. Nach einem Verbindungsfehler kann sie unterstützte Anfragen zur Anmeldung und Cloud-Konfiguration über den Systemproxy wiederholen, auch wenn respect_system_proxy auf false steht. So können sich unterstützte Clients unter Umständen ohne lokale Aktivierung anmelden und Cloud-Standardwerte abrufen. Allein das Deaktivieren von respect_system_proxy schaltet diesen Ausweichmechanismus nicht ab.
Wenn der direkte Zugriff fehlschlägt und der Ausweichmechanismus nicht verfügbar oder deaktiviert ist oder ebenfalls fehlschlägt, stelle respect_system_proxy vor der Anmeldung lokal bereit.
Geltungsbereich und Einschränkungen
Teste die Anmeldung und eine authentifizierte Anfrage mit den vorgesehenen Clientversionen in den Netzwerken, die du nutzen möchtest. Beachte folgende Grenzen:
- Erfasste Anfragen: Die Einstellung gilt für Netzwerkclients der Codex-Laufzeitumgebung. Sie konfiguriert nicht sämtliche Anfragen der ChatGPT-Desktop-App oder des Browsers und auch nicht jeden Plugin-Prozess oder Shell-Befehl. Sie erzwingt keine Zulassungsliste für Ziele und garantiert nicht, dass direkte Verbindungen blockiert werden. Welche Arten von Verkehr unterstützt werden, erfährst du unter Netzwerkanforderungen für Befehle und Netzwerkanforderungen für die Desktop-App.
- Plattformunterstützung: macOS und Windows unterstützen die native Erkennung des Systemproxys. Kann die Laufzeitumgebung den Proxy nicht über das Betriebssystem ermitteln, verwendet sie explizite Proxy-Einstellungen aus der Umgebung, sofern vorhanden. Andernfalls stellt sie eine direkte Verbindung her. Auf anderen Plattformen nutzt sie statt der nativen Erkennung ebenfalls die Umgebungseinstellungen oder eine direkte Verbindung.
- PAC-Routing: Die Laufzeitumgebung wählt aus dem PAC-Ergebnis eine Route aus. Schlägt die Verbindung fehl, versucht sie keine weiteren Proxy- oder
DIRECT-Einträge aus demselben Ergebnis. - Windows-Authentifizierung: Unterstützte Builds können beim Tunnelaufbau auf eine Authentifizierungsanforderung des Proxys mit HTTP-Status
407reagieren. Dazu verwenden sie die Anmeldedaten des angemeldeten Windows-Kontos mit Negotiate oder NTLM. HTTPS-Proxys, deren Authentifizierung an die TLS-Verbindung zum Proxy gebundene Token erfordert, werden nicht unterstützt.
Anforderungen an den Netzwerkzugriff konfigurieren
Behalte [experimental_network] in veröffentlichten Richtlinien bei, bis alle Clients und alle Tools zur Richtlinienvalidierung [network_proxy] unterstützen. Ältere Versionen können den neuen Namen ignorieren oder entfernen. Teste auf den eingesetzten Clientversionen und Betriebssystemen, ob die Anforderungen durchgesetzt werden. Das gilt besonders für Windows, da die Unterstützung dort eingeschränkt ist.
Verwalte in der Agentensicherheit unter Anforderungen > Netzwerknutzung den unterstützten Netzwerkzugriff von Befehlen. Konfiguriere unter Global eine gemeinsame Basis. Für umgebungsspezifische Ausführungseinstellungen verwende, sofern verfügbar, den Tab Lokale Umgebungen oder Codex Cloud-Umgebungen.
- Setze Verwalteter Netzwerkzugriff auf Ein, um Domainregeln auf verwalteten Befehlsverkehr anzuwenden. Allein das Hinzufügen von Domainregeln aktiviert den verwalteten Proxy nicht.
- Wähle unter Netzwerkregeln die Option Netzwerkregel hinzufügen. Gib eine Domain wie
api.openai.comoder**.example.comohne URL-Schema oder Pfad ein. Wähle Zulassen oder Verweigern im Feld Zugriff. Wähle dann Regel speichern, um den Entwurf zu aktualisieren. Wiederhole den Vorgang für weitere Ziele. - Setze Nur von Admins hinzugefügte Domains zulassen auf Ein, wenn persönliche Einstellungen und Genehmigungen für einzelne Domains die verwaltete Zulassungsliste nicht erweitern dürfen. Füge die erforderlichen Freigaben hinzu. Eine Liste, die nur Sperren enthält, lässt keine anderen Ziele zu.
- Prüfe Lokalen Netzwerkzugriff zulassen für Abläufe, die lokale Listener oder private Ziele benötigen. Direkte lokale Verbindungen können die Domainregeln des Proxys umgehen. Prüfe vor einer Änderung die unten beschriebenen Verbindungsbeschränkungen für Codex Cloud.
- Prüfe geerbte Regeln und Validierungsmeldungen und wähle Änderungen speichern. Teste in jeder betroffenen Ausführungsumgebung eine Anfrage, die erfolgreich sein soll, und eine, die blockiert werden soll.
Wenn du Verwalteter Netzwerkzugriff auf Aus setzt, werden die in diesem Geltungsbereich definierten Netzwerkregeln gelöscht und der Wert „Aus“ ausdrücklich gespeichert. Der Internetzugriff bleibt davon unberührt. Nicht festgelegt entfernt die in diesem Geltungsbereich definierten Netzwerkeinstellungen, sodass die geltende Richtlinie oder die Standardwerte der Laufzeitumgebung greifen können. Wenn du Umgebungseinstellungen entfernst, können geerbte globale Regeln wieder wirksam werden. Verwende Als TOML bearbeiten für erweiterte Netzwerkfelder oder vorhandene ältere Domainlisten, die der visuelle Editor nicht darstellen kann.
In Codex 0.166.0 ist [network_proxy] die kanonische Tabelle für den verwalteten Netzwerkzugriff von Befehlen in requirements.toml. Codex akzeptiert auch den älteren Namen [experimental_network]. Verwende pro Ebene nur einen Tabellennamen. Verwenden verschiedene Ebenen unterschiedliche Namen, gilt die übliche Rangfolge der Anforderungen.
Setze in der verwalteten Tabelle enabled = true, um den Proxy unabhängig von der persönlichen Einstellung features.network_proxy zu starten. Auch die aktive Sandbox muss den Netzwerkzugriff für Befehle zulassen. Das Beispiel verwendet den Namen, den ältere Clients und Komponenten zur Richtlinienvalidierung erkennen.
[experimental_network]
enabled = true
managed_allowed_domains_only = true
[experimental_network.domains]
"api.openai.com" = "allow"
"**.example.com" = "allow"
"blocked.example.com" = "deny"
"**.exfil.example.com" = "deny"
Verwende experimental_network.managed_allowed_domains_only = true nur, wenn du auch von Admins verwaltete "allow"-Einträge in [experimental_network.domains] definierst und ausschließlich diese Regeln gelten sollen. Bei true ohne verwaltete Freigaben verlieren von Nutzenden hinzugefügte Domainfreigaben ihre Wirkung. Kombiniere die kanonische Zuordnung domains nicht mit den älteren Listen allowed_domains oder denied_domains.
*.example.com erfasst nur Subdomains. **.example.com erfasst die Stammdomain und ihre Subdomains. Eine passende Sperrregel hat Vorrang vor einer Freigaberegel.
Für Domain-Syntax, Regeln für lokale und private Ziele, den Vorrang von Sperren vor Freigaben und die Grenzen beim DNS-Rebinding gilt dasselbe wie für den unter Genehmigungen und Sicherheit für Agenten beschriebenen Netzwerkzugriff der Sandbox.
Der Proxy leitet den Netzwerkverkehr lokaler Befehle weiter, die in der Sandbox ausgeführt werden. Browsertools prüfen vor dem Zugriff auf einen Origin ebenfalls verwaltete Netzwerksperren und exklusive Zulassungslisten. Diese Richtlinienprüfung erfolgt separat. Der Browserverkehr läuft dabei nicht über den Befehlsproxy. Der Proxy filtert weder die Websuche noch den Verkehr von Apps und Konnektoren, MCP-Servern oder nativen Apps. Er filtert auch keine Anfragen an Codex-Dienste oder sonstigen funktionsspezifischen Verkehr. Verwende jeweils die passenden Einstellungen:
- Beschränke die Websuche mit
allowed_web_search_modes. - Deaktiviere App- und Konnektorintegrationen mit
features.apps = falseund Plugins, sofern unterstützt, mitfeatures.plugins = false. - Beschränke MCP-Server mit der verwalteten Zulassungsliste
mcp_servers. - Beschränke Browserfunktionen und die Computernutzung mit Funktionsanforderungen wie
browser_use,in_app_browserundcomputer_use. - Prüfe für unterstützte verwaltete Befehle in Codex Cloud neben den Einstellungen der Agentensicherheit auch die Interneteinstellungen der Umgebung. Die Umgebung kann eine in der Agentensicherheit zugelassene Domain weiterhin blockieren.
Teste gewöhnliche Befehle und jede zulässige Ausführung mit vollständig aufgehobenen Sandbox-Beschränkungen getrennt. Wird die vollständige Aufhebung genehmigt, kann der Befehl den verwalteten Befehlsproxy umgehen. Siehe Netzwerkisolation.
Keine wirksam zugelassenen Ziele: Wenn Verwalteter Netzwerkzugriff und Nur von Admins hinzugefügte Domains zulassen aktiviert sind, benötigen gewöhnliche verwaltete Befehle eine ausdrücklich festgelegte oder geerbte Freigabe für das jeweilige Ziel. Prüfe vor dem Speichern die wirksam zugelassenen Ziele.
Lokale und private Verbindungen in Codex Cloud: Prüfe den effektiven Wert von
allow_local_binding, wenn ein Cloud-Befehl eine zugelassene Domain nicht erreichen kann. Ein geerbter Wert „Aus“ kann den Zugriff auf den vorgelagerten Proxy blockieren. Den Cloud-spezifischen Standardwert und die möglichen Überschreibungen findest du unter Lokale und private Verbindungen in Codex Cloud.
Wenn die Umgebungsanforderungen leer sind, gelten die globalen Anforderungen. Die Einstellung Verwalteter Netzwerkzugriff mit dem Wert Aus ist von der Einstellung für den Internetzugriff der Cloud-Umgebung unabhängig. Einzelheiten zum Geltungsbereich findest du unter Ausführungseinstellungen der Agentensicherheit.
Rangfolge von Netzwerkrichtlinien und Grenzen der Laufzeitumgebung
Innerhalb einer Richtlinie gilt von höchster zu niedrigster Priorität: betriebssystemspezifische Umgebungsüberschreibung → Umgebungsüberschreibung für alle Betriebssysteme → Global. Eine Richtlinie mit höherer Priorität hat auch dann Vorrang, wenn eine niedriger priorisierte Richtlinie spezifischer ist. Für manche Anforderungen gelten feldspezifische Regeln zur Zusammenführung. Die Laufzeitumgebung setzt anschließend die ermittelten Anforderungen durch. Betrachte die folgenden feldspezifischen Netzwerkfälle getrennt von der Richtlinienpriorität.
Die Beispiele vergleichen Umgebungseinstellungen und globale Einstellungen innerhalb derselben Richtlinie. Der verwaltete Netzwerkzugriff ist bereits konfiguriert, und keine höher priorisierte Richtlinie ändert die Werte. Die Beispiele zeigen, wie einzelne Felder zusammengeführt und zur Laufzeit ausgewertet werden.
Domainzugriff je nach Umgebung festlegen
Für dieselbe Domainregel innerhalb einer Richtlinie können Admins über eine Umgebungsüberschreibung eine global gesperrte Domain zulassen oder eine global zugelassene Domain sperren. Ohne Umgebungsüberschreibung wird die globale Regel geerbt. Andere wirksame Sperrregeln oder Zugriffsbeschränkungen können eine Anfrage weiterhin blockieren.
Wie Domainregeln zusammenwirken
| Globale Regel | Umgebungsregel | Ergebnis der Domainrichtlinie |
|---|---|---|
| Verweigern | Zulassen | Die Umgebungsüberschreibung lässt die Domain unter den folgenden Bedingungen zu. |
| Zulassen | Verweigern | In dieser Umgebung blockiert. |
| Zulassen | Zulassen | Durch diese Domainregeln zugelassen. |
| Verweigern | Verweigern | Durch diese Domainregeln blockiert. |
| Zulassen oder Verweigern | Keine Überschreibung | Die globale Regel wird geerbt. |
Diese Ergebnisse gelten beim Vergleich desselben Domainschlüssels innerhalb einer Richtlinie, sofern keine höher priorisierte Richtlinie das Ergebnis ändert. Ein höher priorisierter Wert ersetzt den Wert für denselben Schlüssel. Andere geerbte Schlüssel bleiben erhalten. Eine Freigabe umgeht keine andere passende Sperre, etwa eine geerbte Regel mit Platzhalter. Eine leere Domainzuordnung in einer Umgebung löscht keine geerbten Regeln.
Beispiel: Sperre packages.example.com global und gib die Domain in der Entwicklungsumgebung frei. Unter den oben genannten Bedingungen kann die Entwicklungsumgebung den Zugriff zulassen. Die Produktionsumgebung erbt die globale Sperre, sofern keine Überschreibung vorliegt.
Prüfe, ob der eingesetzte Executor diese Zusammenführungsregeln unterstützt. Für reguläre verwaltete Executors muss der Umfang der Unterstützung noch validiert werden.
Grenzen des Orchestrators: Die Cloud-Laufzeitumgebung unterstützt weder verwaltete HTTP-/SOCKS-Listener-Ports noch Proxy-Listener an anderen Adressen als Loopback. Die Unterstützung von Socket-Regeln hängt vom Ausführungspfad ab. Die in der folgenden Tabelle beschriebenen Einstellungen für die lokale Ausführung sind keine unterstützten Orchestrator-Konfigurationen.
Weitere Netzwerkbeschränkungen zur Laufzeit
Alle folgenden Felder gehören zur verwalteten Tabelle network_proxy (auch als experimental_network zulässig) in requirements.toml. Die Pfeile zeigen zuerst den globalen Wert und dann den Umgebungswert innerhalb derselben Richtlinie. Aus diesen Fällen für die lokale Ausführung lässt sich keine Unterstützung derselben Einstellungen durch den Orchestrator ableiten.
| Einstellung und versuchte Überschreibung | Verhalten zur Laufzeit | Was du als Admin tun kannst |
|---|---|---|
| domains: deny → allow | Auf unterstützten Pfaden ersetzt die Freigabe der Umgebung den globalen Wert für denselben Domainschlüssel. Andere passende Sperrregeln gelten weiterhin. | Teste zugelassene und blockierte Anfragen auf dem eingesetzten Executor. |
managed_allowed_domains_only: true → false |
Leite aus der Zusammenführung von Domainschlüsseln nicht ab, ob ausschließlich verwaltete Freigaben gelten. Sind enabled = true und managed_allowed_domains_only = true wirksam, benötigen gewöhnliche Befehle wirksame Freigaben. |
Prüfe die effektiven Einstellungen und geerbte Freigaben. Eine reine Sperrliste erlaubt keinen Zugriff auf das übrige Internet. |
allow_local_binding: false → true |
Auf dem unterstützten Proxy-Pfad von Codex Cloud kann ein explizites false den Zugriff auf den vorgelagerten Proxy verhindern. Eine unterstützte Cloud-Überschreibung mit höherer Priorität kann den Wert ändern. | Prüfe die Quelle des effektiven Werts und die Unterstützung durch den Executor. Übertrage den Cloud-Standardwert nicht auf Lokal. |
Proxy-Aktivierung, Exklusivität der Zulassungsliste, Verhalten des vorgelagerten Proxys und Unix-Socket-Regeln hängen vom Executor ab. Übertrage die Regeln zur Zusammenführung von Domainschlüsseln nicht auf diese Einstellungen. Prüfe die effektiven Werte und teste die eingesetzte Laufzeitumgebung. Informationen zu lokalen und privaten Verbindungen in Codex Cloud findest du unter Anforderungen an den Netzwerkzugriff konfigurieren.
Verhalten vor der Einführung prüfen
Teste die Ziele, lokalen Listener, das Proxy-Verhalten und die Socket-Pfade, die deine Arbeitsabläufe tatsächlich nutzen. Prüfe in jeder betroffenen Umgebung eine Aktion, die erfolgreich sein soll, und eine, die blockiert werden soll. Vergewissere dich, dass die eingesetzte Version der Laufzeitumgebung jede verwendete Einstellung unterstützt.
Netzwerkziele der Desktop-App steuern
Wähle in der Agentensicherheit Als TOML bearbeiten, um diese desktopspezifischen Anforderungen im globalen Geltungsbereich zu konfigurieren. Die Oberfläche Netzwerknutzung verwaltet den Netzwerkzugriff von Befehlen. Dafür gilt eine separate Richtlinie.
Verwende [application.network] in requirements.toml, um die Netzwerkziele der Desktop-App zu beschränken. Bei enabled = true müssen externe Anfragen HTTPS oder WSS verwenden. Ihre Domain muss genau mit einer Domain übereinstimmen, für die der Wert "allow" in [application.network.domains] steht. Subdomains sind nicht automatisch zugelassen. Eine leere Domainzuordnung erlaubt keine externen Ziele. Unterstützte Schlüssel findest du in der Konfigurationsreferenz.
Diese Richtlinie gilt unabhängig vom Netzwerkzugriff für Befehle und den Origin-Regeln des Browsers. Sie schränkt die Ziele nativer Module und gestarteter Prozesse nicht ein und regelt nicht die Ausführung in Work Cloud.
Plugins und verwaltete Hooks konfigurieren
Verwende für diese Aufgaben Als TOML bearbeiten in der Agentensicherheit oder eine unterstützte lokale Konfigurationsquelle. Standardwerte für Marketplaces, verbindliche Plugin-Beschränkungen und verwaltete Hooks erfüllen unterschiedliche Zwecke. Wähle die Aufgabe, die zur benötigten Richtlinie passt.
Plugin-Marketplaces und Standardwerte konfigurieren
Wähle Agentensicherheit > Als TOML bearbeiten, um lokale oder Git-basierte Marketplaces und Plugin-Standardwerte in der globalen config.toml zu definieren. Du kannst diese Einstellungen auch über die systemweite config.toml verteilen. Sie geben die anfängliche Marketplace- und Plugin-Konfiguration vor, sind aber nicht verbindlich. Um die Quellen zu begrenzen, die Mitglieder verwenden dürfen, konfiguriere Anforderungen an Marketplace-Quellen.
Die Konfigurationsschlüssel findest du in der Konfigurationsreferenz, Informationen zu Überschreibungen unter Rangfolge der Konfiguration und Informationen zur projektbezogenen Konfiguration unter Plugin-Einstellungen für ein Repository. Für GitHub-Import und -Synchronisierung im Workspace gelten separate Einstellungen.
Verfügbarkeit von Plugins steuern
Verwende in der Agentensicherheit Als TOML bearbeiten, um verbindliche Einstellungen für die Plugin-Funktion in der globalen requirements.toml festzulegen. Für geräteverwaltete Clients kannst du sie über lokale Anforderungen verteilen. Unter Standardwerte > Apps und Tools > Apps/Konnektoren legst du Standardwerte für App-Tools fest. Der verbindliche Schalter features.plugins wird dort nicht gesetzt. Informationen zu Plugin-Berechtigungen im Workspace findest du unter Apps und Konnektoren.
Um Plugins in unterstützten lokalen Clients zu deaktivieren, setze features.plugins auf false in requirements.toml:
features.plugins = false
Diese Einstellung gilt auch, wenn sich Nutzende mit einem API-Schlüssel bei Codex anmelden. Die unterstützte Konfiguration findest du in der Referenz zu features.plugins.
Quellen für Plugin-Marketplaces beschränken
Verwende Als TOML bearbeiten, um Anforderungen an Marketplace-Quellen in der globalen requirements.toml zu konfigurieren, oder stelle sie über lokale Anforderungen bereit. Diese Regeln begrenzen, welche lokalen oder Git-basierten Quellen Nutzende hinzufügen und verwenden können. Sie gelten unabhängig von den Marketplace-Standardwerten.
Um Quellen für Plugin-Marketplaces zu beschränken, setze restrict_to_allowed_sources = true und definiere mindestens eine Quellenregel:
[marketplaces]
restrict_to_allowed_sources = true
[marketplaces.allowed_sources.company_plugins]
source = "git"
url = "https://github.com/example/company-plugins.git"
ref = "main"
[marketplaces.allowed_sources.internal_git]
source = "host_pattern"
host_pattern = '^git\.example\.com$'
[marketplaces.allowed_sources.local_plugins]
source = "local"
path = "/opt/company/codex-plugins"
Git-Regeln gleichen die normalisierte Repository-URL und, falls angegeben, den exakten Wert von ref ab. Hostmuster sind reguläre Ausdrücke, die mit dem kleingeschriebenen Git-Hostnamen abgeglichen werden. Verwende ^ und $, um den gesamten Hostnamen abzugleichen. Lokale Regeln erfordern einen absoluten, normalisierten Pfad. Das vollständige Schema und die Regeln zur Zusammenführung findest du in der Referenz zu requirements.toml.
Ohne passende Regel verhindern diese Anforderungen das Hinzufügen eines Marketplace, das Installieren eines Plugins und das Aktualisieren eines konfigurierten Git-Marketplace. Zur Laufzeit filtern sie außerdem die konfigurierten Marketplaces und deren Plugins.
Auch die von OpenAI kuratierten Git-Marketplaces einschließlich des Katalogs für API-Schlüssel müssen der Quellenzulassungsliste entsprechen. Um sie zuzulassen, füge die folgende Git-Quelle ohne Einschränkung für ref hinzu:
[marketplaces.allowed_sources.openai_curated]
source = "git"
url = "https://github.com/openai/plugins.git"
Um die kuratierten Kataloge auszuschließen, lass diese Quelle weg und stelle sicher, dass keine weiter gefasste Hostregel sie zulässt. Mitgelieferte Plugins und remote installierte Workspace-Plugins unterliegen nicht dieser Quellenrichtlinie für kuratierte Git-Marketplaces.
Diese Quellenbeschränkungen gelten nur dort, wo ein lokaler Client Vorgänge im Plugin-Marketplace unterstützt: in ChatGPT und Codex in der Desktop-App sowie in Codex CLI. Sie steuern die Plugin-Nutzung in ChatGPT im Web oder auf Mobilgeräten nicht und fügen der IDE-Erweiterung keine Plugins hinzu.
Verwaltete Hooks über Anforderungen durchsetzen
Öffne in der Agentensicherheit Global > Anforderungen > Als TOML bearbeiten. Konfiguriere für Work mit lokalem Computerzugriff und für dots die unterstützten mcp_tool-Handler in der globalen requirements.toml. Teste vor der Einführung die Verbindung zum Callback und prüfe, was passiert, wenn der Callback das Zeitlimit überschreitet. Welche Ereignisse unterstützt werden und wie sich Fehler auswirken, erfährst du unter Hooks bei Cloud-Orchestrierung.
Verteile die Hook-Skripte für lokal ausgeführtes Codex über deine Geräteverwaltung. Damit die Hooks auch dann ausgeführt werden müssen, wenn jemand Hooks deaktiviert, gib [features].hooks = true in requirements.toml verbindlich vor. Das Konfigurationsbeispiel für verwaltete Hooks zeigt die Skriptpfade und wie du ausschließlich verwaltete Hooks zulässt.
Geltungsbereich und Rangfolge von Richtlinien verstehen
Hier erfährst du, wo eine Richtlinie gilt, wie Anforderungen zusammenwirken, wie Clients cloudverwaltete Einstellungen erhalten und wie du das Ergebnis prüfen kannst.
Für Work mit lokalem Zugriff und für dots gilt bei aktivierter Richtlinienverwaltung die unterstützte globale Richtlinie auf dem gemeinsamen Cloud-Orchestrator. Auf dem verbundenen Computer gelten die jeweiligen lokalen Ausführungsanforderungen. Für Cloud-Container von Work gelten weiterhin die bestehenden Work Cloud-Richtlinien. Unterstützte Geräteeinstellungen gelten weiterhin für die lokale Ausführung. Codex behält sein bisheriges Konfigurationsverhalten bei. Die verwaltete Konfiguration gewährt weder einen Platz im Workspace noch Zugriff auf Funktionen. Verwende dafür Rollen und Workspace-Berechtigungen.
Agentensicherheit und lokaler Computerzugriff mit Work Cloud
Verwende die Agentensicherheit in der Admin-Konsole, um Richtlinien und Konfigurationen zu verwalten. Sie ersetzt den Bereich „Richtlinien und Konfiguration“. Die Agentensicherheit ist in der Admin-Konsole unabhängig vom lokalen Computerzugriff mit Work Cloud verfügbar. Bestehende Richtlinien, Zuweisungen und ihre Reihenfolge bleiben erhalten. Prüfe deine bestehenden Richtlinien in der Agentensicherheit. Den lokalen Computerzugriff mit Work Cloud musst du separat aktivieren. Migrationshinweise findest du unter Agentensicherheit.
Bevor du die Richtlinienautomatisierung auf Agentensicherheit umstellst:
-
Ermittle die betroffenen Integrationen. Erfasse die Terraform-Konfigurationen und Skripte, die Richtlinien aktualisieren, und dokumentiere, welche Richtlinien sie verwalten.
-
Verwalte globale Einstellungen über die Richtlinien-API. Verwende für Einstellungen unter Lokal oder Codex Cloud die Oberfläche der Agentensicherheit. Bestehende API-Abläufe für globale Einstellungen bleiben nach der Migration verfügbar. Teste deine Skripte und Terraform-Integrationen und vergewissere dich, dass die Richtlinienzuweisungen und die Reihenfolge unverändert sind.
-
Nimm erforderliche Änderungen vor und teste die Automatisierung. Prüfe, ob eine beabsichtigte Aktualisierung die richtige Richtlinie der Agentensicherheit erreicht und die daraus resultierenden Einstellungen durchgesetzt werden.
Die Richtlinienmigration gewährt Work oder dots keinen lokalen Computerzugriff. Es empfiehlt sich, vor der Einführung Richtlinien zu prüfen oder anzulegen. Im Bestätigungsablauf ist das Anlegen einer Richtlinie jedoch keine Voraussetzung für die Aktivierung des Zugriffs. Bevor du Lokalen Computerzugriff zulassen aktivierst, prüfe die migrierte Basiskonfiguration. Falls du Richtlinien bisher ausschließlich über MDM verteilst, erstelle eine Basiskonfiguration in der Cloud. Ist enforce_residency in einer Cloud-Richtlinie aktiviert, wird Lokalen Computerzugriff zulassen sowohl für Work als auch für dots deaktiviert. Diese Schutzmaßnahme legt die Datenresidenz des Workspace nicht fest und deaktiviert für sich genommen weder Work Cloud noch dots.
Mit Umgebungsüberschreibungen kannst du unterstützte Einstellungen innerhalb einer Richtlinie je nach Umgebung anpassen. Von höchster zu niedrigster Priorität gilt: betriebssystemspezifische Umgebungsüberschreibung → Umgebungsüberschreibung für alle Betriebssysteme → Global. Eine höher priorisierte Richtlinie hat auch dann Vorrang, wenn die niedriger priorisierte Richtlinie spezifischer ist. Für manche Anforderungen gelten feldspezifische Regeln zur Zusammenführung. Prüfe, welche Editoren und Felder für Überschreibungen in deinem Workspace verfügbar sind.
Bevor du den lokalen Zugriff für einen Arbeitsablauf mit Hooks aktivierst, prüfe, welche Hooks bei Cloud-Orchestrierung ausgeführt werden.
Quellen und Rangfolge
Für die lokale Ausführung werden Anforderungen in folgender Reihenfolge von niedriger zu höherer Priorität angewendet. Diese Reihenfolge gilt auch für lokale Schritte beim lokalen Computerzugriff mit Work Cloud:
- Systemweite
requirements.toml(/etc/codex/requirements.tomlauf Unix-Systemen einschließlich Linux und macOS oder%ProgramData%\OpenAI\Codex\requirements.tomlunter Windows). - Anforderungen der Agentensicherheit aus dem Cloud-Konfigurationspaket.
- Felder der älteren
managed_config.toml, die der lokale Client als Anforderungen interpretiert. - Über
com.openai.codex:requirements_toml_base64bereitgestellte verwaltete macOS-Einstellungen (MDM).
Ebenen mit höherer Priorität überschreiben gewöhnliche Skalar- und Listenwerte aus niedrigeren Ebenen. Tabellen werden anhand ihrer Schlüssel zusammengeführt. Für Anforderungen wie Regeln, Hooks und Dateisystembeschränkungen gelten dagegen feldspezifische Verfahren. Entnimm das aktuelle Schema der Referenz zu requirements.toml, statt für jedes Feld dieselbe Zusammenführung anzunehmen.
Aus Gründen der Abwärtskompatibilität interpretieren unterstützte lokale Clients die älteren Felder approval_policy, approvals_reviewer und sandbox_mode als Anforderungen. Bei Bedarf ergänzt die Umwandlung kompatible Optionen. Verwende für explizite Zulassungslisten requirements.toml.
Rangfolge beim lokalen Computerzugriff mit Work Cloud
Unterscheide bei Work mit lokalem Zugriff und bei dots zwischen der globalen Orchestrator-Richtlinie und der Ausführungsrichtlinie. Auf dem verbundenen Computer gelten die jeweiligen lokalen Anforderungen. Cloud-Container von Work und Cloud-Computer von dots verwenden ihre eigene Ausführungskonfiguration und ihre eigenen Anforderungen. Das verwaltete Umgebungspaket anderer Executors gilt für sie nicht.
Bei lokaler Ausführung haben MDM-Anforderungen und ältere verwaltete Geräteanforderungen Vorrang vor der Agentensicherheit. Die systemweite Anforderungsdatei des Geräts hat eine niedrigere Priorität als die Agentensicherheit. Werte innerhalb jeder Richtlinie zuerst betriebssystemspezifische Umgebungsüberschreibungen aus, dann Umgebungsüberschreibungen für alle Betriebssysteme und zuletzt die globalen Einstellungen. Bei unterschiedlichen Richtlinien hat die Richtlinienpriorität Vorrang vor der Spezifität.
| Einstellung | Work ohne Synchronisierung und Codex bei lokaler Ausführung | Lokaler Computerzugriff mit Work Cloud |
|---|---|---|
| Enterprise-Anforderungen | Es gilt die oben beschriebene Rangfolge lokaler Anforderungen. | Gelten für lokale Executors. Für Cloud-Container von Work gelten weiterhin die bestehenden Work Cloud-Richtlinien. |
| Ausführungsbeschränkungen des Geräts | Unterstützte lokale Einstellungen setzen die Beschränkungen durch. | Es gilt die oben beschriebene Rangfolge lokaler Anforderungen. MDM-Anforderungen und ältere Anforderungen haben Vorrang vor der Agentensicherheit. |
| Umgebungsüberschreibungen | Verwende das Konfigurationsmodell des jeweiligen Produkts. | Innerhalb einer Richtlinie gelten zuerst betriebssystemspezifische Umgebungsüberschreibungen, dann Überschreibungen für alle Betriebssysteme und zuletzt globale Einstellungen. Eine niedrigere Richtlinienpriorität lässt sich nicht durch eine spezifischere Regel ausgleichen. |
Anforderungen setzen Grenzen, Konfigurationsstandardwerte geben Ausgangswerte vor. Für Work mit lokalem Zugriff und für dots gilt bei aktivierter Richtlinienverwaltung die unterstützte globale Richtlinie über den gemeinsamen Cloud-Orchestrator. Auf einem verbundenen Computer regeln die geltenden lokalen Anforderungen aus requirements.toml die Ausführung. Cloud-Container von Work und Cloud-Computer von dots verwenden ihre eigene Ausführungskonfiguration und ihre eigenen Anforderungen. Das verwaltete Umgebungspaket anderer Executor-Typen gilt für sie nicht. Lokale Ausführungsbeschränkungen gelten nicht automatisch für diese Cloud-Computer. Prüfe die Berechtigungen für Cloud-Funktionen und teste lokale und Cloud-Ausführung getrennt.
Belasse die Orchestrator-Einstellungen, einschließlich Genehmigungen und Websuche, im globalen Geltungsbereich. Verwende, sofern verfügbar, die Bedienelemente für zulässige Genehmigungsrichtlinien und zulässige Websuchmodi. Verwende TOML für weitere unterstützte Felder. Die Feldliste und die Geltungsbereiche für die Ausführung findest du in der Konfigurationsreferenz.
Cloudverwaltete Anforderungen
Wenn sich eine Person mit ChatGPT und einem unterstützten Plan anmeldet, können unterstützte lokale Clients die von Admins erzwungenen Anforderungen für den Workspace empfangen. Auf diesem Weg werden mit requirements.toml kompatible Richtlinien bereitgestellt. Dieser Bereitstellungsweg gewährt keinen Workspace-Zugriff und ersetzt nicht die rollenbasierte Zugriffskontrolle des Workspace. Authentifizierungsanforderungen musst du lokal verwalten.
Konfiguriere gängige Anforderungen mit den Bedienelementen der Agentensicherheit. Für eine Richtlinie, die nur Genehmigungen auf Anfrage und Sandboxes ohne Schreibzugriff oder mit Workspace-Schreibzugriff zulässt, verwende Genehmigungsrichtlinien und Sandbox-Modi unter Richtliniengrenzen. Soll vor dem Aufruf eines unterstützten Shell-Einstiegspunkts zusätzlich eine Genehmigung angefordert werden, wähle Als TOML bearbeiten und füge die Tabelle [rules] in der globalen requirements.toml hinzu.
Die vollständige entsprechende TOML-Konfiguration lautet:
allowed_approval_policies = ["on-request"]
allowed_sandbox_modes = ["read-only", "workspace-write"]
[rules]
prefix_rules = [
{ pattern = [{ any_of = ["bash", "sh", "zsh"] }], decision = "prompt", justification = "Require explicit approval for shell entry points" },
]
Prüfe, ob jede verwaltete Clientversion die ausgewählten Schlüssel unterstützt. Weise die Richtlinie den vorgesehenen Personen oder Gruppen zu und vergewissere dich, dass sie auf deren unterstützten Clients wirksam wird. Das aktuelle Schema findest du in der Konfigurationsreferenz. Für das aktuelle Zuweisungsverhalten ist die Verwaltungsoberfläche maßgeblich.
Der Dienst wählt die vom Unternehmen verwalteten Anforderungsebenen aus, die für die angemeldete Identität gelten. Der lokale Client wertet sie zusammen mit den anderen unter Quellen und Rangfolge beschriebenen Anforderungsquellen aus. Verwende die aktuelle Verwaltungsoberfläche, um Richtlinien im Workspace zu erstellen und zuzuweisen. Verlass dich nicht auf eine kopierte Implementierung der Gruppenzuordnung. Der Verwaltungsdienst steuert die Zuordnung und kann sie unabhängig vom Format der lokalen Anforderungen ändern.
Unterstützte Schlüssel und Beispiele findest du unter Beispiel für requirements.toml und in der Referenz zu requirements.toml.
Wie lokale Clients cloudverwaltete Anforderungen anwenden
Das folgende Lade- und Cache-Verhalten gilt für unterstützte lokale Clients. Daraus lässt sich nicht ableiten, wann eine geänderte Cloud-Richtlinie in einer bereits laufenden Aufgabe mit lokalem Computerzugriff über Work Cloud wirksam wird. Prüfe die effektive Richtlinie, bevor du dich auf eine geänderte Beschränkung verlässt.
Wenn eine Person einen unterstützten lokalen Client startet und sich mit ChatGPT und einem unterstützten Plan anmeldet, sucht der Client zuerst nach einem gültigen Cache-Eintrag für die angemeldete Identität. Fehlt ein gültiger Eintrag, ruft der Client das passende Paket ab, wiederholt die Anfrage bei Bedarf und schreibt bei Erfolg einen signierten Cache-Eintrag. Schlägt die Anfrage fehl oder wird das Zeitlimit überschritten und ist kein gültiger Cache verfügbar, meldet der Client beim Laden des Cloud-Konfigurationspakets einen Fehler. Er startet nicht stillschweigend ohne die cloudverwaltete Anforderungsebene.
Nach der Auswertung des Caches führt der Client die Cloud-Anforderungen mit den oben beschriebenen weiteren Anforderungsebenen zusammen. Eine Aktualisierung im Hintergrund erneuert das zwischengespeicherte Paket und stellt es für spätere Ladevorgänge der Konfiguration bereit. Eine bereits laufende Aufgabe übernimmt eine geänderte Richtlinie dadurch nicht zwangsläufig sofort. Einige Desktop-Einstellungen erfordern einen Neustart der App. Folge einer entsprechenden Aufforderung und prüfe die effektiven Einstellungen, bevor du dich auf die Änderung verlässt.
Richtlinien aus Sicht von Admins und Mitarbeitenden prüfen
Benenne für jede verwaltete Richtlinie eine verantwortliche Person. Halte fest, welche Personen oder Gruppen die Richtlinie erhalten sollen. Dokumentiere den betrieblichen Grund für jede Beschränkung des Dateisystems, des Netzwerkzugriffs, der Genehmigungen oder der Berechtigungsprofile.
Teste einen zulässigen und einen blockierten Arbeitsablauf mit einer Person, die die vorgesehenen Berechtigungen hat. Prüfe die effektiven Einstellungen im unterstützten Client. Eine Workspace-Rolle oder Gruppenzugehörigkeit allein erzwingt keine Beschränkung in der lokalen Laufzeitumgebung.
Prüfe mit Richtlinien testen in der Agentensicherheit, welche Richtlinien auf ein ausgewähltes Mitglied, eine Gruppe oder eine Rolle zutreffen. In einer bearbeitbaren Sitzung wird der aktuelle Entwurf geprüft, ohne ihn zu speichern. Das Ergebnis zeigt die ausgewählten Richtlinien. Es zeigt weder die endgültige zusammengeführte Konfiguration noch, ob ein Client eine Beschränkung durchsetzt. Teste nach dem Speichern die zulässigen und blockierten Arbeitsabläufe auf jedem relevanten Client und Ausführungspfad.
Geräteverwaltete Konfiguration bereitstellen
Verwende lokale Systemanforderungen oder MDM für Anmeldebeschränkungen und geräteverwaltete Richtlinien. Für die ältere managed_config.toml gilt beim Start eine andere Rangfolge als für die Standardwerte der Agentensicherheit. Über MDM kannst du sowohl Anforderungen als auch ältere verwaltete Standardwerte bereitstellen.
Informationen zu Chrome-Richtlinien, die beim Surfen in der Desktop-App gelten, findest du unter Richtlinien für den Desktop-Browser mit MDM verwalten.
Authentifizierung lokal verwalten
Setze allowed_login_methods, allowed_chatgpt_workspaces, cli_auth_credentials_store und chatgpt_base_url in der lokalen systemweiten requirements.toml oder in den MDM-Anforderungen für macOS. In cloudverwalteten Anforderungen ignoriert Codex diese vier Felder. Lokale Authentifizierungsanforderungen gelten, bevor Anmeldedaten geladen werden und bevor Codex die Cloud-Richtlinie abruft.
Um die ChatGPT-Anmeldung in einem genehmigten Workspace vorzuschreiben und die Anmeldedaten im Anmeldedatenspeicher des Betriebssystems abzulegen, verwende:
allowed_login_methods = ["chatgpt"]
allowed_chatgpt_workspaces = ["00000000-0000-0000-0000-000000000000"]
cli_auth_credentials_store = "keyring"
allowed_login_methods akzeptiert chatgpt, api oder beide Werte. Fehlt die Einstellung, beschränkt sie die Anmeldemethoden nicht. Ist sie gesetzt, muss die Liste mindestens eine Methode enthalten. api erlaubt die API-Authentifizierung einschließlich Amazon Bedrock. Die Workspace-Beschränkung gilt auch für Codex-Zugriffstoken.
Persönlich konfigurierte Werte für forced_login_method und forced_chatgpt_workspace_id müssen den Anforderungen entsprechen. Wählt eine Person einen Workspace aus, muss er auch auf der verwalteten Workspace-Zulassungsliste stehen. Passt kein Workspace, ist die ChatGPT-Anmeldung nicht verfügbar. Die API-Authentifizierung bleibt verfügbar, sofern sie zulässig ist. Ist keine Anmeldemethode verfügbar, verweigert Codex den Start.
Informationen zu Speichermodi für Anmeldedaten und zur Konfiguration von Dienst-URLs findest du in der Referenz zu Anforderungen.
OpenTelemetry-Einstellungen durchsetzen
In Codex CLI 0.166.0 kannst du mit [otel] in requirements.toml die Exporter für Logs, Traces und Metriken unabhängig voneinander festlegen, die Umgebung kennzeichnen und bestimmen, welche Inhalte Codex exportiert. Dieses Beispiel sendet Logs an einen OTLP/HTTP-Collector und begrenzt den protokollierten Text pro Tool-Ergebnis auf 256 UTF-8-Bytes. Prompt-Texte, der Text der abschließenden Antwort und Bewertungen aus der automatischen Genehmigungsprüfung werden nicht protokolliert.
Die macOS-Desktop-App 26.1027.30824 enthält die CLI-Version 0.166.0-alpha.5.1. Dieser Build unterstützt [otel] in requirements.toml nicht. Daher lässt sich log_user_prompt = false in diesem Build über diese Richtlinie nicht durchsetzen.
[otel]
environment = "prod"
exporter = { otlp-http = { endpoint = "https://otel.example.com/v1/logs", protocol = "binary" } }
log_user_prompt = false
log_agent_responses = false
log_guardian_assessments = false
tool_result = { max_bytes = 256 }
span_attributes = { team = "platform" }
tracestate = { acme = { region = "eu" } }
Verwaltete Werte überschreiben die lokale Konfiguration. Für exporter, trace_exporter und metrics_exporter gilt jeweils die vollständige Definition aus der höchstpriorisierten Anforderung, die den jeweiligen Exporter festlegt. Dazu gehören auch die Header und TLS-Einstellungen. Für jede skalare Einstellung und für die Tabelle tool_result als Ganzes gilt ebenfalls der jeweils vorgegebene Wert mit der höchsten Priorität. Ausgelassene Einstellungen bleiben konfigurierbar, sofern keine andere Anforderungsebene sie vorgibt.
Span-Attribute werden anhand des Attributnamens zusammengeführt, tracestate-Felder anhand des Mitglieds- und Feldnamens. Bei übereinstimmenden Einträgen hat der Wert mit der höheren Priorität Vorrang. Andere Einträge bleiben verfügbar. Eine leere Metadatentabelle löscht sie nicht. Informationen zu Exporter-Optionen und protokollierten Inhalten findest du unter Beobachtbarkeit und Telemetrie.
SQLite-Datenbanken auf NFS migrieren
Unter Linux erstellt Codex neue SQLite-Datenbanken auf NFS im Journalmodus DELETE. Um vorhandene Datenbanken von Write-Ahead Logging (WAL) auf diesen Modus umzustellen, setze unsafe_enforce_sqlite_journal_mode = true auf der obersten Ebene von requirements.toml. Diese Einstellung ist standardmäßig deaktiviert. Ist sie aktiviert, migriert Codex die Datenbanken vor dem ersten Öffnen zum Schreiben.
Das eingehängte NFS-Dateisystem muss hostübergreifende POSIX-Sperren unterstützen. Mount-Optionen wie nolock und local_lock=all verhindern, dass diese Sperren funktionieren. Beende auf jedem Host alle SQLite-Clients, die diese Datenbanken verwenden, einschließlich Codex. Starte genau eine Codex-Instanz. Starte die anderen Clients erst wieder, wenn die Migration erfolgreich abgeschlossen ist. Das Benutzerkonto, unter dem diese Instanz läuft, benötigt Schreibzugriff auf das Datenbankverzeichnis und die Migrationssperre. Die Ersatzdateien behalten die Unix-Berechtigungsbits der Originale und gehören diesem Benutzerkonto. Die Migration übernimmt weder die ursprüngliche Eigentümer- und Gruppenzuordnung noch die erweiterten Zugriffskontrolllisten. Codex bewahrt die Originale in einem privaten Sicherungsverzeichnis auf.
Verwaltete Standardwerte (managed_config.toml)
Verwende die Standardwerte der Agentensicherheit für unterstützte cloudverwaltete Ausgangswerte. Dieser Abschnitt beschreibt die ältere geräteverwaltete Konfiguration über managed_config.toml und ihre abweichende Rangfolge beim Start. Wenn du Standardwerte in der Agentensicherheit bearbeitest, wird keine managed_config.toml auf den Geräten der Mitglieder bereitgestellt.
Verwaltete Standardwerte legen fest, mit welcher Konfiguration ein unterstützter lokaler Client startet. Beim Start überschreiben sie die persönliche lokale config.toml und alle über --config in der CLI gesetzten Werte. Nutzende können die Einstellungen während der aktuellen Ausführung ändern. Beim nächsten Start des Clients gelten wieder die Standardwerte.
GPT-5.5 wird am 14. Oktober 2026 um 12:00 Uhr PDT (19:00 Uhr UTC) für Codex mit ChatGPT-Anmeldung eingestellt. Wenn ein verwalteter Standardwert, ein macOS-MDM-Profil oder eine gespeicherte Konfiguration für die betroffenen Personen gpt-5.5 vorgibt, ersetze es durch ein verfügbares Modell. Wähle gpt-6.1-sol, sobald ein Admin es für die betroffenen Personen aktiviert hat. Die OpenAI API und Codex-Sitzungen mit API-Schlüssel-Authentifizierung sind nicht betroffen. Siehe Modellverfügbarkeit im Workspace.
Für Konfigurationen, die noch gpt-5.4 oder gpt-5.4-mini fest vorgeben, beachte die Migrationshinweise für GPT-5.4.
Vergewissere dich, dass deine verwalteten Standardwerte die Anforderungen erfüllen. Die lokale Laufzeitumgebung lehnt unzulässige Werte ab.
Rangfolge der Konfigurationsebenen
Die lokale Laufzeitumgebung setzt die effektive Konfiguration aus den folgenden Ebenen zusammen. Weiter oben aufgeführte Ebenen überschreiben die darunterliegenden:
- Verwaltete Einstellungen (macOS-MDM, höchste Priorität)
managed_config.toml(systemweite oder verwaltete Datei)config.toml(persönliche Basiskonfiguration)
CLI-Überschreibungen mit --config key=value gelten für die Basiskonfiguration. Verwaltete Ebenen haben Vorrang. Daher beginnt jede Ausführung mit den verwalteten Standardwerten, auch wenn du lokale Flags angibst.
Für die config.toml aus der Cloud gilt die reguläre Rangfolge der Konfiguration. Sie unterscheidet sich von der oben beschriebenen älteren Rangfolge. Für die requirements.toml aus der Cloud gilt die Rangfolge der Anforderungen.
Speicherorte
- Linux/macOS (Unix):
/etc/codex/managed_config.toml - Windows und andere Nicht-Unix-Systeme:
~/.codex/managed_config.toml
Fehlt die Datei, überspringt die lokale Laufzeitumgebung die verwaltete Ebene.
Beispiel für managed_config.toml
# Set conservative defaults
approval_policy = "on-request"
sandbox_mode = "workspace-write"
[sandbox_workspace_write]
network_access = false # keep network disabled unless explicitly allowed
[otel]
environment = "prod"
exporter = { otlp-http = { endpoint = "https://otel.example.com/v1/logs", protocol = "binary" } }
log_user_prompt = false # keep prompts redacted
Empfohlene Schutzmaßnahmen
- Verwende für die meisten Personen vorzugsweise
workspace-writemit Genehmigungen. Behalte Vollzugriff kontrollierten Containern vor. - Behalte
network_access = falsebei, es sei denn, die Sicherheitsprüfung deiner Organisation lässt einen Collector oder die für deine Arbeitsabläufe benötigten Domains zu. - Verwende die OpenTelemetry-Anforderungen, um Telemetrieeinstellungen durchzusetzen. Behalte
log_user_prompt = falsebei, es sei denn, deine Richtlinie erlaubt das Speichern von Prompt-Inhalten. - Vergleiche regelmäßig die lokale
config.tomlmit der verwalteten Richtlinie, um Abweichungen zu erkennen. Verwaltete Ebenen sollten Vorrang vor lokalen Flags und Dateien haben.
Verwaltete macOS-Einstellungen (MDM)
Unter macOS können Admins ein Geräteprofil mit Base64-kodierten TOML-Nutzdaten verteilen. Verwende dafür folgende Einstellungsdomain und Schlüssel:
- Einstellungsdomain:
com.openai.codex - Schlüssel:
config_toml_base64(verwaltete Standardwerte)requirements_toml_base64(Anforderungen)
Die lokale Laufzeitumgebung liest die Nutzdaten dieser verwalteten Einstellungen als TOML ein. Für verwaltete Standardwerte (config_toml_base64) haben die verwalteten macOS-Einstellungen die höchste Priorität. Für Anforderungen (requirements_toml_base64) gilt die Rangfolge der Anforderungen. Dieselbe Tabelle [features] für Anforderungen funktioniert auch in requirements_toml_base64. Verwende dort ebenfalls die kanonischen Funktionsschlüssel.
MDM-Setup
Die lokale Laufzeitumgebung unterstützt standardmäßige MDM-Nutzdaten für macOS. Du kannst die Einstellungen daher mit Tools wie Jamf Pro, Fleet oder Kandji verteilen. Für eine einfache Bereitstellung gehst du so vor:
- Erstelle die verwalteten TOML-Nutzdaten und kodiere sie mit
base64ohne Zeilenumbrüche. - Trage die Zeichenfolge in deinem MDM-Profil unter der Domain
com.openai.codexein. Verwendeconfig_toml_base64für verwaltete Standardwerte oderrequirements_toml_base64für Anforderungen. - Verteile das Profil. Bitte die betroffenen Personen, den unterstützten lokalen Client neu zu starten und in der beim Start angezeigten Konfigurationsübersicht die verwalteten Werte zu prüfen.
- Wenn du eine Richtlinie zurückziehst oder änderst, aktualisiere die verwalteten Nutzdaten. Der Client liest die aktualisierte Einstellung beim nächsten Start ein.
Vermeide Geheimnisse und dynamische Werte, die sich häufig ändern, in den Nutzdaten. Wende auf Änderungen am verwalteten TOML dasselbe Verfahren an wie auf andere MDM-Einstellungen.