管理コンソールの「エージェントセキュリティ」でポリシーと構成を管理します。「エージェントセキュリティ」は従来の「ポリシーと構成」に代わるもので、Work と dot のローカルコンピューターアクセスとは独立して展開されます。
移行対象の従来のクラウドポリシーは、設定が「グローバル」に引き継がれ、割り当てと順序も維持されます。移行したポリシーは「エージェントセキュリティ」で確認してください。ローカルコンピューターアクセスを利用するには、Work と dot でそれぞれ有効にする必要があります。
設定の適用範囲
各ポリシーでは、グローバル設定が基準になります。ローカル環境や Codex Cloud では、環境別の上書き設定を使って、対応する実行設定を変更できます。上書き設定がない項目には、そのポリシーの該当するグローバル設定が適用されます。
-
グローバル:承認やウェブ検索などのオーケストレーターの制御と、環境間で共有する実行設定を指定します。
-
ローカル:接続したコンピューターで行う作業について、対応する実行設定を調整します。
-
Codex Cloud:Codex のクラウドタスクについて、対応する実行設定を調整します。これらのポリシーは Codex Cloud を有効にする前でも設定できますが、適用されるのは権限ページで Codex Cloud を有効にした後です。Work Cloud の機能別の権限は別途設定します。詳しくは「Work Cloud へのエージェントセキュリティの適用」を参照してください。
基準となる設定と環境別設定の追加
-
「エージェントセキュリティ」を開き、既存のグローバルポリシー、その割り当て、順序を確認します。組織が意図した制御と一致しているかを確認してください。この確認操作で「Work Cloud でのローカルコンピューターアクセス」が有効になることはありません。
-
「要件」と「デフォルト」は分けて確認します。要件ではユーザーが上書きできない制限を定め、デフォルトではその制限内での初期値を定めます。
-
オーケストレーターの制御は「グローバル」に設定します。これには、承認要件、許可するウェブ検索モード、管理対象ツールの制御が含まれます。
-
サンドボックス、ファイルシステム権限、管理対象の実行時ネットワークアクセスなど、対応する実行制御について、ローカルまたは Codex Cloud の環境別設定を追加します。特定の OS にだけ適用する場合は、OS 別の上書き設定を使います。
-
ポリシーを保存し、入力した設定について検証メッセージが表示された場合は、その内容を確認します。
制御項目と構成フィールドの選択
オーケストレーターはタスク全体の進行を調整します。エグゼキューターは、タスクの実行ステップを処理するコンピューターまたはクラウドコンテナです。オーケストレーターの制御は「グローバル」で設定します。環境別の requirements.toml で設定できるのは実行制御だけです。承認ポリシーやウェブ検索などのオーケストレーター設定は「グローバル」で管理し、環境別設定では上書きできません。
オーケストレーターの制御
これらの制御は「グローバル」で設定します。ローカルアクセスを利用する Work と dot では、管理ポリシーが有効な場合、対応するグローバルポリシーが共有のクラウドオーケストレーターを通じて適用されます。環境別の上書きは対応する実行設定にのみ適用され、オーケストレーターの制御は上書きできません。以下に示す承認、ウェブ検索、アプリ、MCP、プラグイン、ルールの要件のうち、エージェントセキュリティの UI に専用の設定項目があるのは、許可する承認ポリシーと許可するウェブ検索モードだけです。その他のフィールドは TOML で設定します。
| 制御項目 | 制御内容 | requirements.toml のフィールド |
|---|---|---|
| 承認ポリシーとレビュー | エージェントに承認が必要な条件と、承認リクエストのレビュー担当者を指定します。自動レビューも設定できます。 | allowed_approval_policiesallowed_approvals_reviewersauto_reviewguardian_policy_config |
| ウェブ検索モード | エージェントが使用できるウェブ検索モードを指定します。 | allowed_web_search_modes |
アプリ、MCP サーバー、plugins |
利用可能なアプリ、MCP サーバー、プラグインと、それぞれの構成を指定します。 | appsmcp_serversplugins |
コマンドの rules |
エージェントが実行できるコマンド、承認が必要なコマンド、実行できないコマンドを指定します。 | rules |
管理対象の hooks |
対応するタスクイベントやツールイベントの発生時に行うアクションを管理者が定義します。 | hooksallow_managed_hooks_only |
Work Cloud のローカルコンピューターアクセスで利用できるフック
グローバルでTOML として編集を選択し、ローカルコンピューターアクセスを利用する Work と dot 向けの mcp_tool ハンドラーを設定します。ツールの実行をブロックするためにフックを使う場合は、フックが明示的に拒否した場合と、コールバックが失敗した場合の両方の動作を事前にテストしてください。対応するハンドラーとイベントは「クラウドオーケストレーションでのフック」を参照してください。
「グローバル」にはデスクトップとクライアントの設定も含まれます。このうち一部の設定はデスクトップアプリにのみ適用されます。「グローバル」で設定しても、すべての環境に適用されるとは限りません。各フィールドの適用範囲は「構成リファレンス」で確認してください。
実行制御(エグゼキューター)
これらのフィールドは、コンピューターまたはクラウドコンテナでの作業の実行方法を制御します。共通の値は「グローバル」で設定します。対応する設定で環境ごとに値を変える必要がある場合は、ローカルまたは Codex Cloud の上書き設定を使います。
| 制御項目 | 制御内容 | requirements.toml のフィールド |
|---|---|---|
| ログインシェルの使用 | シェルツールによるログインシェルの起動を許可するかどうかを指定します。 | allow_login_shell |
| 許可するサンドボックスモード | エグゼキューターが使用できるサンドボックスモードを指定します。 | allowed_sandbox_modes |
| 権限プロファイルとデフォルト | 許可する権限プロファイル、各プロファイルのアクセス制限、デフォルトのプロファイルを指定します。 | allowed_permission_profilesdefault_permissionspermissions |
| リモートサンドボックス構成 | ホスト名に応じて使用するサンドボックスモードを指定します。 | remote_sandbox_config |
| 管理対象の実行時ネットワークアクセス | 許可または拒否する接続先など、実行時のネットワークアクセスを管理します。 | experimental_network |
| Windows の実行設定 | Windows 固有の実行設定とサンドボックス設定を指定します。 | windows |
この表は、環境別の上書きに対応するフィールドグループを示しています。各グループで利用できるオプションはプラットフォームによって異なる場合があります。また、一部の要件はポリシー間で置き換わるのではなく、組み合わせて適用されます。対応する値は「構成リファレンス」、ネットワークの例外は「管理対象の構成」を参照してください。
Codex Cloud の管理対象の実行経路のうち、この制御に対応する経路では、エージェントセキュリティでドメインを許可しても、環境側の制限は上書きできません。サンドボックスの制限の全面解除が承認されると、そのコマンドは管理対象のコマンドプロキシを経由せずに実行されることがあります。プロキシの適用範囲は「ネットワークの分離」を参照してください。
UI でのネットワーク設定
- 管理コンソール > エージェントセキュリティを開きます。ポリシーを選択し、グローバル、ローカル、Codex Cloud のいずれかを選びます。共通の基準は「グローバル」で設定し、環境ごとに変更する項目には、対応する環境別の上書き設定を使います。
- 要件を開き、ネットワーク管理をオンにします。必要なドメインを追加し、それぞれに許可または拒否を指定します。通常のユーザー設定やドメインごとの承認で管理対象プロキシの許可リストを拡張できないようにするには、管理者が追加したドメインのみを許可をオンにします。
- 保存する前に、実際に適用される設定と継承されたルールを確認します。環境別設定が空の場合、グローバル設定は消去されず、そのまま継承されます。Codex Cloud では、ローカルネットワークやプライベートネットワークへの接続も別途確認してください。「ネットワーク管理」をオフにする操作と、クラウド環境の「インターネットアクセス」をオフにする操作は別です。
- Codex Cloud では、環境のインターネットアクセス、接続先、メソッドの設定も確認します。保存後、許可されるはずのリクエストとブロックされるはずのリクエストをそれぞれテストします。サンドボックスの制限の全面解除を許可している場合は、その実行も別途テストしてください。
有効な許可先がない場合
ネットワーク管理と管理者が追加したドメインのみを許可がともにオンの場合、通常の管理対象コマンドが接続できるのは、有効なルールで許可されている接続先だけです。「許可」のエントリを設定しておらず、継承もしていない場合、これらのコマンドに許可された接続先はありません。「拒否」だけを設定したポリシーが、それ以外のインターネット接続先を暗黙に許可することはありません。必要な「許可」のエントリを追加し、継承されたルールを確認してから保存してください。この制限は管理対象のコマンドプロキシに適用されます。すべてのツールや、サンドボックスの制限の全面解除が承認された実行まで制限するものではありません。
Codex Cloud からローカルネットワークやプライベートネットワークへの接続
ローカルネットワークやプライベートネットワークへの接続を明示的にオフにすると、接続先ドメインが許可されていても、Codex Cloud が上流プロキシに接続できなくなる場合があります。最終的に適用される allow_local_binding の値を確認し、その値を指定しているポリシーまたは設定を特定してください。対応するクラウドのプロキシ経路でデフォルト値の true が使われるのは、該当する要件、選択したネットワークプロファイル、プロキシ機能の設定のいずれにも値が指定されていない場合だけです。継承した false も明示的な設定として扱われます。上書きに対応している場合は、優先度の高いクラウド環境の上書き設定を使うことで、ローカル環境が使用するグローバル値を維持したまま、Codex Cloud の値だけを変更できます。この操作でドメインの「許可」エントリが追加されることはありません。上書き設定を運用に組み込む前に、エグゼキューターが対応していることを確認してください。このクラウド用のデフォルト値をローカル環境に適用しないでください。
環境別のデフォルト設定
「デフォルト」のエディターでは config.toml のフィールドを使います。これらは requirements.toml の制約とは異なります。環境別のデフォルト設定として指定できるトップレベルの項目は次のとおりです。
-
シェルの動作:
allow_login_shellとshell_environment_policy -
サンドボックスと権限:
sandbox_mode、sandbox_workspace_write、default_permissions、permissions -
Windows での実行:windows
デフォルト値で、強制適用される要件を上書きすることはできません。承認やウェブ検索など、オーケストレーターのデフォルト設定は「グローバル」で管理してください。
ポリシーの優先順位と組み合わせ
-
複数のポリシーが適用される場合は、優先度の高いポリシーが優先されます。優先度の低いポリシーの方が適用範囲を細かく指定していても、この順序は変わりません。
-
同じポリシー内では、対応する実行設定は、特定の OS 向けの環境別上書き設定、全 OS 共通の環境別上書き設定、グローバル設定の順に優先されます。
-
ローカル実行では、MDM と従来の管理対象デバイスの要件がエージェントセキュリティより優先されます。デバイス上のシステム要件ファイルの優先度は、エージェントセキュリティより低くなります。
同じポリシー内の同じドメインルールについて、管理者は環境別の上書き設定を使い、「グローバル」で拒否したドメインを許可したり、許可したドメインを拒否したりできます。環境別の上書き設定がない場合は、グローバルルールを継承します。ただし、他に有効な拒否ルールやアクセス制御があれば、リクエストがブロックされることがあります。
これは、同じポリシー内で同一のドメインキーを比較し、より優先度の高いポリシーが結果を変えない場合の動作です。優先度の高い値で置き換わるのは同じキーの値だけで、継承された他のキーは残ります。「許可」を指定しても、継承されたワイルドカードなど、リクエストに一致する別の「拒否」ルールを回避することはできません。環境別のルールマップが空でも、継承されたルールは消去されません。
Work Cloud へのエージェントセキュリティの適用
クラウドブラウザの使用とクラウドネットワークアクセスは、管理コンソール > 権限とロール > ワークスペースの機能 > クラウドコンピューターの機能で設定します。これらの共有機能は Work Cloud と dot で利用でき、Work Cloud へのアクセス権とは独立して設定できます。Work のタスクを実行するには、Work へのアクセス権に加え、タスクに必要な各機能の利用権限が必要です。ブラウザの利用権限と、コードやシェルからのネットワークアクセス権限は個別に確認してください。一方を無効にしても、もう一方が自動的に無効になることはありません。
Work Cloud のコンテナと dot のクラウドコンピューターは、独自の実行構成と要件を使用します。他の種類のエグゼキューターで使われる管理対象の環境設定一式は使用しません。ローカル環境のファイル制限とネットワーク制限は、これらのクラウドコンピューターには自動的に適用されません。対応するグローバルのオーケストレーターポリシーには、別の適用範囲があります。グローバルポリシーや Codex Cloud の上書き設定では、共有クラウド機能の権限は設定されません。これらの権限は別途確認してください。
メンバーに実際に付与されているアクセス権を確認する際は、ワークスペースのデフォルト設定、直接またはグループ経由で割り当てられたすべてのロール、ロックダウンモードなど別途適用される制限を確認してください。
Work Cloud のローカルコンピューターへのアクセスを許可を有効にする前に、基準となるグローバル設定を見直し、組織が運用している制御と両立するかを確認してください。ChatGPT デスクトップアプリで Codex をローカルで使用を有効にしておく必要はありません。いずれかのクラウドポリシーで enforce_residency が有効な場合、Work と dot の両方でローカルコンピューターへのアクセスを許可が無効になります。この保護措置によってワークスペースのデータレジデンシーが設定されることはなく、この措置だけで Work Cloud や dot が無効になることもありません。個別のセットアップ手順、利用条件、接続時の動作は「Work Cloud と dot のローカルコンピューターアクセス」を参照してください。
ポリシー API と Terraform
グローバル設定の管理にはポリシー API を使用します。ローカルまたは Codex Cloud の設定は、エージェントセキュリティの UI で管理します。移行後も、グローバル設定を API で管理する既存のワークフローは引き続き利用できます。スクリプトと Terraform 連携をテストし、ポリシーの割り当てと順序が変わっていないことを確認してください。
ポリシーの移行によって、SCIM によるメンバーシップの同期や RBAC ロールが変わることはありません。
関連ガイド
-
管理対象の構成:ポリシーの配信、優先順位、フィールドごとのマージ動作
-
構成リファレンス:フィールドの定義と Work との互換性
-
Work Cloud と dot のローカルコンピューターアクセス:前提条件とセットアップ手順
-
ロールとワークスペースの権限:Work と Codex の機能へのアクセス