Skip to content

安全说明 ​

适用范围:当前托管生产使用组织工作区。个人工作区及其所有者自审需等待控制面升级;自部署实例请按实际版本与身份配置判断。

数据边界 ​

用 SDK 或 MCP 代理接入时,判定在你们的环境里完成。执行器保存一份校验过的策略,在每个动作执行前本地判定。Guard 做判定,不需要把动作的任何内容送出你们的环境。

执行器发给控制面的是脱敏事件:

会发送从不发送
事件、任务、追踪、动作、项目和 Agent 的 ID参数值
可信主体的 ID工具返回值
动作类型、资源名、目标地址、数据标签、防护点提示词和模型输出
参数的名字源代码
判定:结果、规则、原因码、说明、策略版本和摘要你们的业务凭据
状态、返回值或错误的类型,以及参数、返回值和错误文字的 SHA-256 摘要错误信息的原文

计算摘要之前,键名像密钥的值(password、token、API key、authorization、cookie、private key)会先被替换掉。控制面收到事件时再过滤一遍,只保留上表里的字段。

审批票据只带一段简短的脱敏预览和动作的摘要,不带原始参数。用于审批后恢复执行的参数,存在你们这边的本地快照文件里。

资源名、目标地址、Agent ID 和主体 ID 仍可能敏感。事件和导出文件要像其他日志一样保护。

托管方式处理什么 ​

完全云托管的网关和托管任务不一样:网关会处理经过其路由的请求和响应,以及你们的上游凭据。托管任务会处理任务输入、结果和日志。每个部署、每个任务都必须勾选同意,否则一律拒绝。上游凭据在你们的浏览器里加密后才上传。任务结果加密保存,通过一次性链接下载,链接 5 分钟内有效,7 天后删除。

托管控制面 ​

托管控制面由我们运行,单节点,每天备份。对可用性意味着什么,见托管控制面。你们停止使用时,凭据立即失效,数据按你们的要求清除。备份里的副本最长 30 天内随备份过期删除。

账号与访问 ​

  • 用 Yi Labs 账号登录,或者在配置好的项目上用你们的企业账号(OIDC)登录。Guard 不保存密码。
  • 控制台会话固定 15 分钟,不会延长。会话 Cookie 是 HttpOnly 和 SameSite 的。每次写操作都校验 CSRF 令牌和 Origin。
  • 角色按项目分配:项目所有者、策略管理员、独立审核员、只读成员。每个请求都由服务端检查。
  • 职责分离:策略的作者不能审核自己的策略,必须由另一个可信主体审核。审核员不能批准可信主体是自己的动作。所有者不能代替审核员批准动作。
  • 停用一个成员,他在组织所有项目里的会话立即结束。

凭据 ​

凭据范围有效期
执行器凭据一个项目里的一个 Agent。只在接入包里出现一次默认 90 天。在「接入」页轮换或撤销;撤销后 Agent 下一次联系控制面就被切断
SDK 下载令牌只能下载 SDK,调不了控制面1 到 365 天。只显示一次
项目令牌(自部署)一个项目里的一个角色。owner 令牌用来签发其他令牌,不进 Agent通过 API 轮换和撤销

凭据撤销或过期后,执行器不会退回去用缓存的策略,而是停止判定,工具不执行。

SDK 的供应链 ​

  • SDK 不在公共的 PyPI 和 npm 上。那里这些名字没人注册,从公共源安装可能装到别人的包。只从你们的私有源安装。
  • 每个 SDK 版本只构建一次,哈希留有记录。安装命令固定了 wheel 的 sha256。npm 的 lockfile 记录了包的 sha512 integrity。字节不一致的文件装不上。
  • .npmrc 只把 @preworld 作用域指向私有源,文件里不含凭据。

网络 ​

  • SDK 经 HTTPS 访问控制面,不读 HTTPS_PROXY 之类的设置。代理和私有 CA 必须显式配置,而且只作用于访问控制面的流量。
  • 受控 HTTP、broker 和 MCP 的 HTTP 上游会检查主机名解析出的每一个地址,只连接检查过的地址。内网和回环地址默认拒绝,除非按来源允许某个地址段。默认不跟随重定向。
  • MCP 代理的 HTTP 下游检查 Host 和 Origin,并要求单独的 bearer 令牌。

限制 ​

在依赖 Guard 之前,希望你们先了解这些:

  • 它只保护经过它的东西。没包装的工具、模型厂商托管的工具、shell 命令和直接打开的 socket 都能绕过它。用网络规则、独立进程里的 MCP 代理和沙箱堵住这些路径,并用一次本应失败的调用实测。
  • 它不能保证挡住所有提示注入。它限制的是 Agent 能做什么,范围以你们发布的规则为准。
  • 不检查内容。它不读取、不过滤 HTTPS 的内容,没有通用的数据防泄漏。禁止外发的标记是精确的字节匹配。
  • 锁定证明的是元数据,不是行为。锁定后的 MCP 工具,描述和 schema 改了会被发现。它的代码和返回内容改了则发现不了。
  • 项目令牌是服务身份,证明不了是哪个人做的。具名账号才能。
  • 审批过的调用在 Guard 里每张票据只执行一次。你们的写操作工具仍需要幂等键:对外部系统,Guard 无法保证恰好执行一次。
  • 托管控制面没有高可用,是单节点运行。见托管控制面。
  • 我们演示工作台里的场景是固定的模型输出回放,说明的是防护路径确实生效,不是针对模型的实时攻击测试。

报告安全问题 ​

请通过我们的联系页面联系。第一条消息里不要附上真实的密钥或个人数据。