In der Admin-Konsole verwaltest du Richtlinien und Einstellungen unter „Agentensicherheit“. Dieser Bereich ersetzt „Richtlinien und Konfiguration“. Seine Einführung erfolgt unabhängig vom Zugriff auf lokale Computer für Work und dots.
Bei der Migration älterer Cloud-Richtlinien, die dafür infrage kommen, werden deren Einstellungen in „Global“ übernommen. Die Zuweisungen und die Reihenfolge der Richtlinien bleiben erhalten. Prüfe die migrierten Richtlinien unter „Agentensicherheit“. Den Zugriff auf lokale Computer musst du für Work und für dots jeweils separat aktivieren.
Wo die Einstellungen gelten
Jede Richtlinie legt unter „Global“ eine gemeinsame Grundlage fest. Für „Lokal“ oder „Codex Cloud“ kannst du unterstützte Ausführungseinstellungen überschreiben. Wo eine Umgebung keine eigene Einstellung vorgibt, übernimmt sie die entsprechende globale Einstellung der Richtlinie.
-
Global: Lege die Vorgaben für den Orchestrator fest, etwa für Genehmigungen und die Websuche, sowie die gemeinsamen Ausführungseinstellungen.
-
Lokal: Passe unterstützte Ausführungseinstellungen für Aufgaben an, die auf einem verbundenen Computer laufen.
-
Codex Cloud: Passe unterstützte Ausführungseinstellungen für Cloud-Aufgaben von Codex an. Du kannst diese Richtlinien schon konfigurieren, bevor du Codex Cloud aktivierst. Sie gelten erst, wenn du Codex Cloud auf der Berechtigungsseite aktiviert hast. Für die Funktionen von Work Cloud gelten separate Berechtigungen. Mehr dazu erfährst du im Abschnitt Wie die Agentensicherheit für Work Cloud gilt.
Globale Grundlage festlegen und Umgebungseinstellungen ergänzen
-
Öffne „Agentensicherheit“ und prüfe die vorhandenen globalen Richtlinien, ihre Zuweisungen und ihre Reihenfolge. Gleiche sie mit den Vorgaben deiner Organisation ab. Durch diese Prüfung wird der Zugriff auf lokale Computer mit Work Cloud nicht aktiviert.
-
Prüfe „Anforderungen“ und „Standardwerte“ getrennt. Anforderungen legen Grenzen fest, die Nutzende nicht außer Kraft setzen können. Standardwerte bestimmen die Ausgangswerte innerhalb dieser Grenzen.
-
Belasse die Vorgaben für den Orchestrator unter „Global“. Dazu gehören Genehmigungsanforderungen, zulässige Modi für die Websuche und zentral verwaltete Vorgaben für Tools.
-
Ergänze unter „Lokal“ oder „Codex Cloud“ die unterstützten Ausführungseinstellungen, etwa für Sandboxing, Dateisystemberechtigungen und den verwalteten Netzwerkzugriff bei der Ausführung. Soll eine Einstellung nur für ein bestimmtes Betriebssystem gelten, überschreibe sie gezielt für dieses System.
-
Speichere die Richtlinie und prüfe etwaige Validierungsmeldungen zu deinen Einstellungen.
Vorgaben und Konfigurationsfelder auswählen
Der Orchestrator koordiniert die Aufgabe. Der Executor ist der Computer oder Cloud-Container, der einen einzelnen Schritt ausführt. Konfiguriere die Vorgaben für den Orchestrator unter „Global“. In der requirements.toml einer Umgebung kannst du ausschließlich Vorgaben für die Ausführung festlegen. Einstellungen für den Orchestrator, etwa die Genehmigungsrichtlinie und die Websuche, bleiben unter „Global“. Eine Umgebung kann sie nicht überschreiben.
Vorgaben für den Orchestrator
Konfiguriere diese Vorgaben unter „Global“. Für Work mit lokalem Zugriff und für dots setzt der gemeinsame Cloud-Orchestrator die unterstützten globalen Richtlinienvorgaben um, sofern die Richtlinienverwaltung aktiviert ist. In einer Umgebung kannst du unterstützte Ausführungseinstellungen überschreiben. Die Vorgaben für den Orchestrator lassen sich dort nicht ändern. Von den unten aufgeführten Anforderungen für Genehmigungen, Websuche, Apps, MCP, Plugins und Regeln haben nur Zulässige Genehmigungsrichtlinien und Zulässige Modi für die Websuche eigene Bedienelemente unter „Agentensicherheit“. Konfiguriere die übrigen Felder über TOML.
| Vorgabe | Was du damit festlegst | Felder in requirements.toml |
|---|---|---|
| Genehmigungsrichtlinien und Überprüfung | Wann der Agent eine Genehmigung benötigt, wer die Anfrage prüft und wann die Prüfung automatisch erfolgt. | allowed_approval_policiesallowed_approvals_reviewersauto_reviewguardian_policy_config |
| Modi für die Websuche | Welche Modi der Agent für die Websuche verwenden darf. | allowed_web_search_modes |
Apps, MCP-Server und plugins |
Welche Apps, MCP-Server und Plugins verfügbar sind und wie sie konfiguriert sind. | appsmcp_serversplugins |
Befehlsregeln (rules) |
Welche Befehle der Agent ausführen darf, für welche er eine Genehmigung benötigt und welche er nicht ausführen darf. | rules |
Verwaltete Hooks (hooks) |
Welche Aktionen die Administration für unterstützte Aufgaben- und Tool-Ereignisse festlegt. | hooksallow_managed_hooks_only |
Hooks beim Zugriff auf lokale Computer mit Work Cloud
Wähle unter Global die Option Als TOML bearbeiten, um mcp_tool-Handler für Work mit Zugriff auf lokale Computer und für dots zu konfigurieren. Teste sowohl Callback-Fehler als auch ausdrückliche Ablehnungen, bevor du dich darauf verlässt, dass ein Hook ein Tool blockiert. Welche Handler und Ereignisse unterstützt werden, erfährst du im Abschnitt Hooks bei der Cloud-Orchestrierung.
Unter „Global“ findest du auch Desktop- und Client-Einstellungen. Einige davon gelten nur für die Desktop-App. Eine unter „Global“ konfigurierte Einstellung gilt also nicht zwangsläufig überall. In der Konfigurationsreferenz findest du für jedes Feld die unterstützten Einsatzbereiche.
Vorgaben für die Ausführung (Executor)
Diese Felder legen fest, wie Aufgaben auf einem Computer oder in einem Cloud-Container ausgeführt werden. Lege gemeinsame Werte unter „Global“ fest. Wenn eine unterstützte Einstellung in einer Umgebung abweichen soll, überschreibe sie unter „Lokal“ oder „Codex Cloud“.
| Vorgabe | Was du damit festlegst | Felder in requirements.toml |
|---|---|---|
| Verwendung einer Login-Shell | Ob Shell-Tools eine Login-Shell starten dürfen. | allow_login_shell |
| Zulässige Sandbox-Modi | Welche Sandbox-Modi der Executor verwenden darf. | allowed_sandbox_modes |
| Berechtigungsprofile und Standardwerte | Welche Berechtigungsprofile zulässig sind, welchen Zugriff sie erlauben und welches Profil standardmäßig gilt. | allowed_permission_profilesdefault_permissionspermissions |
| Remote-Sandbox-Konfiguration | Welcher Sandbox-Modus für einen bestimmten Host gilt. Die Auswahl erfolgt anhand des Hostnamens. | remote_sandbox_config |
| Verwalteter Netzwerkzugriff bei der Ausführung | Wie der Netzwerkzugriff verwaltet wird, einschließlich erlaubter und gesperrter Ziele. | experimental_network |
| Ausführungseinstellungen für Windows | Welche plattformspezifischen Ausführungs- und Sandbox-Einstellungen unter Windows gelten. | windows |
Die Tabelle zeigt, welche Feldgruppen du für einzelne Umgebungen überschreiben kannst. Welche Optionen eine Gruppe unterstützt, kann je nach Plattform variieren. Einige Anforderungen aus verschiedenen Richtlinien gelten gemeinsam, statt einander zu ersetzen. Die unterstützten Werte findest du in der Konfigurationsreferenz, Netzwerkausnahmen im Leitfaden zur verwalteten Konfiguration.
Auf unterstützten, verwalteten Ausführungspfaden in Codex Cloud kann die Freigabe einer Domain unter „Agentensicherheit“ keine Beschränkung der Umgebung aufheben. Wird die vollständige Aufhebung der Sandbox-Beschränkungen genehmigt, kann der Befehl bei der Ausführung den verwalteten Befehlsproxy umgehen. Was der Proxy abdeckt, erfährst du im Abschnitt Netzwerkisolierung.
Netzwerkzugriff in der Benutzeroberfläche konfigurieren
- Öffne Admin-Konsole > Agentensicherheit. Wähle eine Richtlinie und anschließend Global, Lokal oder Codex Cloud. Lege die gemeinsame Grundlage unter „Global“ fest und überschreibe unterstützte Einstellungen bei Bedarf für die jeweilige Umgebung.
- Öffne Anforderungen und aktiviere Netzwerkzugriff verwalten. Füge die erforderlichen Domains hinzu und wähle für jede Zulassen oder Verweigern. Aktiviere Nur von der Administration hinzugefügte Domains zulassen, wenn weder reguläre Benutzereinstellungen noch Genehmigungen für einzelne Domains die Freigabeliste des verwalteten Proxys erweitern dürfen.
- Prüfe vor dem Speichern die wirksamen Einstellungen und die übernommenen Regeln. Sind die Umgebungseinstellungen leer, gelten die globalen Einstellungen weiter. Prüfe für Codex Cloud den Zugriff auf lokale und private Netzwerke separat. Wenn du „Netzwerkzugriff verwalten“ deaktivierst, schaltest du damit nicht den Internetzugriff der Cloud-Umgebung aus.
- Prüfe für Codex Cloud außerdem die Einstellungen der Umgebung für Internetzugriff, Ziele und Methoden. Speichere die Einstellungen und teste eine Anfrage, die erlaubt sein soll, und eine, die blockiert werden soll. Falls eine vollständige Aufhebung der Sandbox-Beschränkungen zulässig ist, teste diesen Fall separat.
Keine wirksam freigegebenen Ziele
Wenn Netzwerkzugriff verwalten und Nur von der Administration hinzugefügte Domains zulassen aktiviert sind, benötigen reguläre verwaltete Befehle wirksam freigegebene Ziele. Sind weder eigene noch übernommene Freigaben vorhanden, dürfen diese Befehle keine Ziele erreichen. Eine Richtlinie, die nur Sperren enthält, gibt das übrige Internet nicht automatisch frei. Füge die erforderlichen Freigaben hinzu und prüfe vor dem Speichern die übernommenen Regeln. Diese Einschränkung gilt für den verwalteten Befehlsproxy. Sie erfasst nicht jedes Tool und auch nicht die Ausführung mit genehmigter vollständiger Aufhebung der Sandbox-Beschränkungen.
Zugriff von Codex Cloud auf lokale und private Netzwerke
Ist der Zugriff auf lokale und private Netzwerke ausdrücklich deaktiviert, kann das verhindern, dass Codex Cloud seinen vorgelagerten Proxy erreicht, selbst wenn die Zieldomain erlaubt ist. Prüfe den wirksamen Wert von allow_local_binding und ermittle, aus welcher Richtlinie oder Einstellung er stammt. Beim unterstützten Zugriff über den Cloud-Proxy gilt true nur dann als Standardwert, wenn weder eine anwendbare Anforderung noch das ausgewählte Netzwerkprofil noch eine Einstellung der Proxy-Funktion einen Wert vorgibt. Auch ein übernommenes false zählt als ausdrückliche Einstellung. Sofern unterstützt, kannst du den Wert für Codex Cloud mit einer Cloud-Einstellung höherer Priorität überschreiben. Der globale Wert, den „Lokal“ verwendet, bleibt dabei erhalten. Dadurch werden keine Domains freigegeben. Prüfe, ob der Executor das Überschreiben unterstützt, bevor du dich darauf verlässt. Verwende diesen Cloud-Standardwert nicht für „Lokal“.
Standardwerte für Umgebungen
Der Editor für Standardwerte verwendet Felder aus config.toml. Diese unterscheiden sich von den verbindlichen Vorgaben in requirements.toml. Auf der obersten Ebene werden folgende Standardwerte für Umgebungen unterstützt:
-
Shell-Verhalten:
allow_login_shellundshell_environment_policy. -
Sandbox und Berechtigungen:
sandbox_mode,sandbox_workspace_write,default_permissionsund permissions. -
Ausführung unter Windows: windows.
Ein Standardwert kann eine verbindliche Anforderung nicht außer Kraft setzen. Belasse die Standardwerte für den Orchestrator unter „Global“, einschließlich der Einstellungen für Genehmigungen und die Websuche.
Wie Richtlinien zusammenwirken
-
Bei mehreren Richtlinien hat die Richtlinie mit der höheren Priorität Vorrang, selbst wenn die Richtlinie mit der niedrigeren Priorität spezifischer ist.
-
Innerhalb einer Richtlinie gilt für unterstützte Ausführungseinstellungen folgende Rangfolge: zuerst die Umgebungseinstellung für das jeweilige Betriebssystem, dann die Umgebungseinstellung für alle Betriebssysteme und zuletzt die globale Einstellung.
-
Bei der lokalen Ausführung haben MDM und ältere Anforderungen für verwaltete Geräte Vorrang vor der Agentensicherheit. Die Datei mit den systemweiten Anforderungen auf dem Gerät hat eine niedrigere Priorität als die Agentensicherheit.
Für dieselbe Domainregel innerhalb einer Richtlinie kann die Administration in einer Umgebung eine global gesperrte Domain erlauben oder eine global erlaubte Domain sperren. Ohne abweichende Umgebungseinstellung gilt die globale Regel. Andere wirksame Sperrregeln oder Zugriffsbeschränkungen können eine Anfrage weiterhin blockieren.
Diese Aussagen gelten für denselben Domain-Schlüssel innerhalb einer Richtlinie, sofern keine Richtlinie höherer Priorität das Ergebnis ändert. Für denselben Schlüssel ersetzt der Wert höherer Priorität den bisherigen Wert. Andere übernommene Schlüssel bleiben erhalten. Eine Freigabe setzt eine andere zutreffende Sperrregel nicht außer Kraft, etwa eine übernommene Regel mit Platzhalter. Eine leere Zuordnung von Domainregeln in der Umgebung löscht keine übernommenen Regeln.
Wie die Agentensicherheit für Work Cloud gilt
Konfiguriere Browsernutzung in der Cloud und Netzwerkzugriff in der Cloud unter Admin-Konsole > Berechtigungen und Rollen > Workspace-Funktionen > Funktionen von Cloud-Computern. Diese gemeinsamen Funktionen stehen Work Cloud und dots zur Verfügung. Du kannst sie unabhängig vom Zugriff auf Work Cloud konfigurieren. Für eine Work-Aufgabe sind weiterhin der Zugriff auf Work und die Berechtigung für jede benötigte Funktion erforderlich. Prüfe den Browserzugriff getrennt vom Netzwerkzugriff für Code oder Shell-Befehle. Wenn du einen dieser Zugriffe deaktivierst, wird der andere nicht automatisch deaktiviert.
Für die Container von Work Cloud und die Cloud-Computer von dots gelten eigene Ausführungseinstellungen und Anforderungen. Andere Executor-Typen verwenden dafür ein verwaltetes Paket mit Umgebungseinstellungen. Lokale Datei- und Netzwerkbeschränkungen gelten nicht automatisch für diese Cloud-Computer. Die unterstützten globalen Richtlinienvorgaben für den Orchestrator haben einen eigenen Geltungsbereich. Weder eine globale Richtlinie noch eine abweichende Einstellung für Codex Cloud legt die Berechtigungen für gemeinsame Cloud-Funktionen fest. Prüfe diese Berechtigungen separat.
Um den tatsächlichen Zugriff eines Mitglieds zu ermitteln, prüfe die Standardeinstellung des Workspace, alle direkt oder über Gruppen zugewiesenen Rollen und separat durchgesetzte Einschränkungen wie den Lockdown-Modus.
Bevor du unter Work Cloud die Option Zugriff auf lokale Computer erlauben aktivierst, prüfe die globalen Einstellungen und ihre Vereinbarkeit mit den Schutzmaßnahmen, auf die sich deine Organisation verlässt. Die Option Codex lokal in der ChatGPT-Desktop-App verwenden ist dafür keine Voraussetzung. Ist enforce_residency in mindestens einer Cloud-Richtlinie aktiviert, ist Zugriff auf lokale Computer erlauben sowohl für Work als auch für dots deaktiviert. Diese Schutzmaßnahme legt weder die Datenresidenz des Workspace fest noch deaktiviert sie allein Work Cloud oder dots. Die separaten Schritte zum Einrichten, die Zugangsvoraussetzungen und das Verhalten beim Verbindungsaufbau findest du im Leitfaden Zugriff auf lokale Computer für Work Cloud und dots.
Richtlinien-API und Terraform
Verwalte globale Einstellungen über die Richtlinien-API. Einstellungen für „Lokal“ oder „Codex Cloud“ verwaltest du in der Benutzeroberfläche unter „Agentensicherheit“. Bestehende API-Abläufe für globale Einstellungen stehen nach der Migration weiterhin zur Verfügung. Teste deine Skripte und Terraform-Integrationen und vergewissere dich, dass die Zuweisungen und die Reihenfolge der Richtlinien unverändert sind.
Die Migration der Richtlinien ändert weder die Synchronisierung der Mitgliedschaften über SCIM noch die RBAC-Rollen.
Weiterführende Leitfäden
-
Verwaltete Konfiguration: Wie Richtlinien bereitgestellt werden, welche Vorrang haben und wie die Werte einzelner Felder zusammengeführt werden.
-
Konfigurationsreferenz: Felddefinitionen und Kompatibilität mit Work.
-
Zugriff auf lokale Computer für Work Cloud und dots: Voraussetzungen und Schritte zum Einrichten.
-
Rollen und Workspace-Berechtigungen: Zugriff auf Funktionen von Work und Codex.