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

Codex 安全配置手册

配置、验证和组合企业安全控制措施,管理 Codex 可访问的账户、文件和服务以及可执行的操作

部署 Codex 时,您需要决定允许它访问哪些账户、文件和服务,以及执行哪些操作。本手册帮助企业管理员将这些决定落实到配置中,测试配置效果,并找出需要额外保护的环节。

这些安全建议旨在让开发者获得使用 Codex 所需的权限,同时降低意外更改、敏感数据泄露和防护措施本身被修改的风险。您可以据此选择适合自身工作流和风险管理要求的控制措施,了解其局限,并验证它们在您的环境中如何生效。这些措施可补充组织已有的身份、终端、网络和服务防护。

您可以从具体任务入手,例如仅允许登录公司的工作空间,也可以从更广泛的目标入手,例如在保护生产环境的同时让开发者使用 Codex。

根据您的工作选择起点:

  • 单项配置方案逐项介绍控制措施,包括配置步骤、验证方法、回滚说明和适用边界。

  • 组合方案介绍如何将多项控制措施与身份管理、源代码管理、部署等系统中的防护措施结合起来,实现常见的安全目标。

您可以根据组织的实际情况调整示例。使用每个配置示例时,请结合配套说明,确认应将配置放在哪里、适用于哪些客户端或环境,以及它能控制和不能控制哪些行为。

在扩大部署范围之前,请先在测试终端上试用配置。确认预期的工作流能够成功执行,同时有意限制的操作会被阻止。根据测试结果调整配置,并向将要使用 Codex 的人员说明权限边界。

选择起点

使用页面目录打开以下相应章节。

如果您想要 请从这里开始
配置一项具体的控制措施 单项配置方案
在保护生产环境的同时让开发者使用 Codex 在保护生产环境的同时让开发者使用 Codex
降低内部代码被公开发布的风险 降低内部代码被公开发布的风险
防止 Codex 修改自身的防护措施 防止 Codex 修改自身的防护措施

组合方案列出了实现各项目标所需的控制措施、外部防护和验证步骤。

准备工作

  1. 盘点纳入管理范围的客户端和运行环境:桌面应用、CLI、IDE 扩展程序、Codex 云端、CI 运行器和远程主机。

  2. 在大范围部署之前,先在测试终端上试行配置。

  3. 记录支持的最低 Codex 版本。权限配置文件允许列表需要 Codex 0.138.0 或更高版本。

  4. 为每个托管配置包保留一份用于回滚的副本。

  5. 每次更改后,分别测试一个允许执行的工作流和一个有意阻止的工作流。

托管要求是管理员强制实施的约束,托管默认值是启动时使用的设置。对于受支持的身份验证、沙盒、审批、MCP、插件、钩子和网络限制,请使用托管要求。身份验证要求必须在本地部署或通过 macOS MDM 下发,云端托管要求无法强制实施这些身份验证限制。请参阅托管配置和配置参考。

配置位置

在向试点用户部署之前,请根据组织的实际情况调整这些配置示例。TOML 代码块是策略片段。请将所需设置合并到现有文件中,避免重复定义表,并替换示例中的名称、域名和路径。验证步骤列出了您需要在自己的环境中确认的预期结果。

对于本地 Codex,管理员可以在 macOS 和 Linux 上将强制要求部署到 /etc/codex/requirements.toml,在 Windows 上部署到 %ProgramData%\OpenAI\Codex\requirements.toml。对于托管的 macOS 设备,可以通过 MDM 下发 com.openai.codex:requirements_toml_base64 偏好设置。您也可以在管理控制台的智能体安全下配置云端托管策略。先选择策略,再选择适用的环境或操作系统,然后配置要求。请保护策略文件及其父目录,防止运行 Codex 的用户修改它们。常规 config.toml 或托管默认设置提供启动值,无法强制实施要求。请参阅托管配置和智能体安全。

单项配置方案

选择所需的控制措施,展开相应方案即可查看配置、验证步骤、回滚说明和适用边界。每验证一项,就勾选对应条目。如果浏览器存储可用,验证进度会保存在当前浏览器中。

面向企业安全目标的组合方案

以下示例介绍如何组合多项控制措施,实现常见的企业安全目标。请在管理范围内的每种客户端和环境中测试配置。

参考页面