如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

智能体安全

管理 ChatGPT 工作和 Codex 的全局策略和环境设置

您可以在管理控制台的“智能体安全”中管理策略和配置。“智能体安全”取代了原有的“策略与配置”。这项变更与“工作”和 dot 的本地计算机访问功能各自独立推出。

符合迁移条件的旧版云端策略在迁移时会将原有设置带入“全局”,并保留策略的分配关系和优先顺序。请在“智能体安全”中核对迁移后的策略。“工作”和 dot 的本地计算机访问功能需要分别主动启用。

设置的适用范围

每项策略都以全局设置为基准。您可以通过环境覆盖设置,更改本地或 Codex 云端环境支持的执行设置。如果某项设置在环境中没有覆盖值,该环境会继承这项策略中适用的全局设置。

  • 全局:设置审批、网页搜索等编排器控制项,以及各环境共用的执行设置。

  • 本地:调整在已连接的计算机上运行任务时支持的执行设置。

  • Codex 云端:调整 Codex 云任务支持的执行设置。您可以在启用 Codex 云端之前配置这些策略,但只有在权限页面启用 Codex 云端后,策略才会生效。“工作”云端有单独的功能权限,详见智能体安全如何适用于“工作”云端。

设置基准并添加环境设置

  1. 打开“智能体安全”,查看现有的全局策略、策略分配和优先顺序。确认这些设置符合贵组织预期的管控要求。查看策略不会启用“允许‘工作’云端访问本地计算机”。

  2. 分别查看“要求”和“默认值”。要求规定用户无法突破的限制,默认值则指定这些限制范围内的初始值。

  3. 在“全局”中保留编排器控制项,包括审批要求、允许的网页搜索模式和托管工具控制项。

  4. 针对沙盒、文件系统权限和托管执行网络等受支持的执行控制项,添加本地或 Codex 云端环境设置。如果设置只需对特定操作系统生效,请为该操作系统配置覆盖设置。

  5. 保存策略,并查看系统针对您输入的设置给出的验证信息。

选择控制项和配置字段

编排器负责协调任务。执行器是运行某个执行步骤的计算机或云端容器。请在“全局”中配置编排器控制项。环境中的 requirements.toml 设置仅支持执行控制项。审批策略、网页搜索等编排器设置由“全局”管理,环境设置无法覆盖这些设置。

编排器控制项

请在“全局”中配置这些控制项。启用托管策略后,共享云端编排器会对使用本地访问的“工作”模式以及 dot 应用受支持的全局策略。环境覆盖设置仅适用于受支持的执行设置,无法覆盖编排器控制项。在下列审批、网页搜索、应用、MCP、插件和规则要求中,只有允许的审批策略和允许的网页搜索模式在“智能体安全”界面中有专门的控制项。请通过 TOML 配置其他字段。

控制项 控制内容 requirements.toml 字段
审批策略与审查 智能体何时需要审批、由谁审查,以及是否采用自动审查。 allowed_approval_policies
allowed_approvals_reviewers
auto_review
guardian_policy_config
网页搜索模式 智能体可以使用哪些网页搜索模式。 allowed_web_search_modes
应用、MCP 服务器和 plugins 可用的应用、MCP 服务器和插件及其配置。 apps
mcp_servers
plugins
命令规则 rules 智能体可以运行哪些命令,哪些命令需要审批,以及哪些命令禁止运行。 rules
托管钩子 hooks 管理员定义的操作,在受支持的任务事件和工具事件发生时执行。 hooks
allow_managed_hooks_only

“工作”云端访问本地计算机时使用的钩子

在全局中,选择以 TOML 格式编辑,为具有本地计算机访问权限的“工作”模式以及 dot 配置 mcp_tool 处理程序。在依靠钩子阻止工具运行之前,请分别测试回调失败和钩子明确拒绝执行这两种情况。有关支持的处理程序和事件,请参阅云端编排中的钩子。

“全局”还包含桌面和客户端设置,其中一些设置仅适用于桌面应用。在“全局”中配置的设置并非在所有场景中都生效。请参阅《配置参考》,了解各字段支持的使用场景。

执行控制项(执行器)

这些字段控制任务在计算机或云端容器中的运行方式。请在“全局”中设置共用值。如果某个环境需要使用不同的值,请通过本地或 Codex 云端覆盖设置调整该环境支持的选项。

控制项 控制内容 requirements.toml 字段
登录 shell shell 工具是否可以启动登录 shell。 allow_login_shell
允许的沙盒模式 执行器可以使用哪些沙盒模式。 allowed_sandbox_modes
权限配置文件与默认值 允许使用的权限配置文件、各配置文件的访问限制,以及默认配置文件。 allowed_permission_profiles
default_permissions
permissions
远程沙盒配置 根据主机名为各主机选择的沙盒模式。 remote_sandbox_config
托管执行网络 受管理的网络访问,包括允许和拒绝访问的目标。 experimental_network
Windows 执行设置 Windows 平台专用的执行和沙盒设置。 windows

上表列出了支持环境覆盖的字段组。各组支持的选项可能因平台而异。有些要求会跨策略合并,而非相互替换。请参阅《配置参考》了解支持的值,并参阅《托管配置》了解网络例外规则。

在受支持的 Codex 云端托管执行路径上,即使在“智能体安全”中允许访问某个域名,也无法覆盖环境限制。如果完全提升沙盒权限的请求获批,此次执行就可以绕过托管命令代理。有关该代理的适用范围,请参阅网络隔离。

在界面中配置网络

  1. 打开管理控制台 > 智能体安全。选择一项策略,然后选择全局、本地或 Codex 云端。在“全局”中设置共用基准,对于需要因环境而异且支持覆盖的设置,请配置环境覆盖值。
  2. 打开要求并启用管理网络。添加所需的域名条目,并为每个条目选择允许或拒绝。如果需要防止普通用户配置或针对单个域名的审批扩大托管代理的允许列表,请启用仅允许管理员添加的域名。
  3. 保存前,请查看实际生效的设置和继承的规则。环境设置留空时会继承全局设置,不会将其清除。对于 Codex 云端,请单独检查本地网络和专用网络的连通性。关闭“管理网络”与关闭云端环境的“互联网访问”是两个独立的操作。
  4. 对于 Codex 云端,还要检查该环境的互联网访问、目标地址和请求方法设置。保存设置,然后分别测试一个应当允许的请求和一个应当阻止的请求。如果允许完全提升沙盒权限,请单独测试这种情况。

没有实际允许访问的目标

同时启用管理网络和仅允许管理员添加的域名时,普通托管命令需要有实际生效的允许目标才能访问网络。如果既未配置也未继承任何“允许”条目,这些命令就没有可以访问的目标。仅含拒绝规则的策略不会默认允许访问互联网上的其他目标。请添加所需的“允许”条目,并在保存前检查继承的规则。这项限制针对托管命令代理,其适用范围不涵盖所有工具,也不涵盖已获审批的沙盒完全提权操作。

Codex 云端与本地网络和专用网络的连通性

如果明确关闭本地网络和专用网络连接,即使目标域名已获允许,Codex 云端也可能无法连接到其上游代理。请检查 allow_local_binding 的最终值,并确定该值来自哪项策略或设置。在受支持的云端代理路径上,只有在适用的要求、选定的网络配置文件和代理功能设置均未指定值时,该值才默认为 true。继承的 false 也算作明确设置的值。如果执行器支持,您可以设置优先级更高的云端覆盖值,单独更改 Codex 云端的取值,同时保留本地环境使用的全局值。此操作不会添加域名“允许”条目。在依赖覆盖值之前,请确认执行器支持该设置。请勿将此云端默认值用于本地环境。

环境默认值

“默认值”编辑器使用 config.toml 字段,这些字段与 requirements.toml 中的约束不同。支持的顶层环境默认设置包括:

  • Shell 行为:allow_login_shell 和 shell_environment_policy。

  • 沙盒与权限:sandbox_mode、sandbox_workspace_write、default_permissions 和 permissions。

  • Windows 执行:windows。

默认值无法覆盖强制执行的要求。请在“全局”中保留编排器默认值,包括审批和网页搜索设置。

了解多项策略如何共同生效

  • 比较不同策略时,优先级较高的策略优先,即使较低优先级的策略规定得更具体。

  • 在同一项策略内,受支持的执行设置按以下优先顺序取值:针对特定操作系统的环境覆盖值、适用于所有操作系统的环境覆盖值、全局值。

  • 对于本地执行,MDM 和旧版托管设备要求的优先级高于智能体安全策略。设备上系统要求文件的优先级低于智能体安全策略。

对于同一项策略中的同一条域名规则,管理员可以通过环境覆盖设置允许访问全局规则拒绝的域名,也可以拒绝访问全局规则允许的域名。如果没有环境覆盖设置,则继承全局规则。其他生效的拒绝规则或访问控制仍可能阻止请求。

上述结果以同一项策略中的同一个域名键为比较对象,前提是没有优先级更高的策略改变结果。对于同一个键,优先级较高的值会替换优先级较低的值,其他继承的键会保留。允许规则无法绕过另一条同样匹配的拒绝规则,例如继承的通配符拒绝规则。空的环境映射不会清除继承的规则。

智能体安全如何适用于“工作”云端

请分别配置云端浏览器使用权限和云端网络访问权限。这两项设置位于管理控制台 > 权限与角色 > 工作空间功能 > 云端计算机功能。“工作”云端和 dot 都可以使用这些共享功能。您可以独立于“工作”云端访问权限配置这些功能权限。要在“工作”模式下运行任务,仍需具备“工作”模式的访问权限,以及使用该任务所需各项功能的权限。请分别检查浏览器访问权限,以及代码或 shell 的网络访问权限。禁用其中一项不会自动禁用另一项。

“工作”云端容器和 dot 云端计算机使用各自的执行配置和要求,其他类型执行器使用的托管环境配置包不适用于它们。本地文件和网络限制不会自动应用于这些云端计算机。受支持的全局编排器策略有单独的适用范围。全局策略和 Codex 云端覆盖设置都无法配置共享云端功能的权限。请单独检查这些权限。

核实成员的实际访问权限时,请检查工作空间的默认设置、直接分配给成员或通过群组分配的所有角色,以及锁定模式等单独强制执行的限制。

在“工作”云端下启用允许访问本地计算机之前,请检查全局基准设置,并确认其与贵组织依赖的控制措施兼容。您无需先启用在 ChatGPT 桌面应用中本地使用 Codex。如果任何一项云端策略启用了 enforce_residency,“工作”和 dot 的允许访问本地计算机都会被禁用。这项保护措施不会配置工作空间的数据驻留设置,也不会单独导致“工作”云端或 dot 被禁用。请参阅“工作”云端和 dot 的本地计算机访问,了解各自的设置步骤、使用条件和连接行为。

策略 API 和 Terraform

请使用策略 API 管理全局设置。要管理本地或 Codex 云端设置,请使用“智能体安全”界面。迁移后,现有通过 API 管理全局设置的工作流仍然可用。请测试您的脚本和 Terraform 集成,并确认策略的分配关系和优先顺序保持不变。

策略迁移不会改变 SCIM 成员同步或 RBAC 角色。

相关指南