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

沙盒安全

隔离工作负载、限制网络访问并保护凭证。

智能体生成的代码可以访问其运行环境中的文件和凭证,也可以访问该环境能够连接的网络。

隔离工作负载

在虚拟机等隔离的计算环境中运行工作负载。对于不能共享数据的用户或工作负载,请分别使用独立的环境。为您的应用或工作负载创建专用的 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 请求,请将密钥库中的机密用作环境变量。沙盒代码使用占位符。对于发往已获准主机的请求,网络代理会填入真实的机密值。

对于自托管环境,请配置可信的代理或服务器,由它在环境之外提供机密值。这部分基础设施需要您自行提供。对于函数工具,请将凭证保存在处理调用的应用中,并且只返回调用结果。

在此示例配置中,沙盒工具将请求发送给您配置的外部代理。对于发往已获准目标的请求,代理会添加权限范围受限的凭证。在沙盒内仍可读取权限受限的执行器密钥。

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