智能体生成的代码可以访问其运行环境中的文件和凭证,也可以访问该环境能够连接的网络。
隔离工作负载
在虚拟机等隔离的计算环境中运行工作负载。对于不能共享数据的用户或工作负载,请分别使用独立的环境。为您的应用或工作负载创建专用的 OpenAI 项目。
限制网络访问
仅允许出站流量访问已获准的端点,其中应包括执行器必须访问的主机。
根据各工具发起连接的位置配置网络访问权限:
- 执行器 MCP 从您的环境发起连接。请允许它们访问所需的服务器。
- 远程 MCP 从 OpenAI 服务发起连接。该服务必须能够访问这些 MCP 的端点。
有关连接选项,请参阅 MCP 工具。
审核智能体的操作
要启用自动审核模式,请在会话级别设置 review: "auto_review"。该模式会自动批准或拒绝其支持的审批请求。自动审核模式无法替代环境的网络限制和凭证控制措施,请继续实施这些措施。
自动审核模式采用的权限配置以 workspace-write 为基准,并限制网络访问。如果使用标准执行器,容器必须支持沙盒,并允许 Codex 创建沙盒。请参阅执行环境的先决条件。
浏览器来源访问审批和登录仍需由应用中现有的处理程序负责。有关这两项流程,请参阅计算机使用。
分开使用凭证
为应用密钥授予 api.agents.read 和 api.agents.write 权限以处理会话,并授予 api.responses.write 权限以执行推理。如需管理密钥库,请添加 api.vaults.read 和 api.vaults.write 权限。
将环境密钥设为执行器的 CODEX_API_KEY。此密钥仅允许连接环境,无法授权执行其他任何 API 操作。有关配置方法,请参阅执行器身份验证。
智能体生成的代码可以读取环境密钥。请将应用的 API 密钥保存在环境之外。不要将密钥写入镜像、源代码或日志。必要时轮换或撤销密钥。
通过代理访问第三方服务
将第三方凭证保存在环境之外。对于从 OpenAI 托管的沙盒发起的 API 请求,请将密钥库中的机密用作环境变量。沙盒代码使用占位符。对于发往已获准主机的请求,网络代理会填入真实的机密值。
对于自托管环境,请配置可信的代理或服务器,由它在环境之外提供机密值。这部分基础设施需要您自行提供。对于函数工具,请将凭证保存在处理调用的应用中,并且只返回调用结果。

将长期有效的凭证保存在机密管理器中。如果将其中存储的机密注入环境,智能体生成的代码仍然可以读取它。请定期轮换凭证,一旦怀疑凭证泄露,请立即撤销。