SuperAPI AI 工具集

wendy-self-hosted

安全与审计

查看项目

更新于 10-16 06:15

技能介绍

用途:该技能规定 Wendy 双路径规则——wendy 栈(wendyos / wendy-agent)必须始终能在不依赖 SaaS 栈的情况下运行。修改互操作相关代码时,必须保持自托管路径完整;若尚不存在则应创建。仅能在 SaaS 下工作的功能属于未完成功能,因为 Wendy 服务于关键基础设施伙伴,其合规或法规上无法将设备集群控制环路交由厂商多租户云运行。

适用范围:wendy-agent / wendyos 始终适用,设备侧注册、续期、邮局轮询、镜像拉取等核心环路必须在设备视角下无需可达 SaaS(仅依赖运营方自有私有基础设施);pki-core 自身必须可自托管,它是两种配置的信任根,不能硬依赖 GCP;wendy-auth 可能稍后支持,但代码现在就不得硬假设 GCP 或 SaaS 可达。

两种部署配置:受管(GCP)与自托管。受管侧使用 VPC Service Controls 边界内的 Private Service Connect 端点,传输认证面向 GCP-WI-OIDC;自托管侧运行于运营方自有私有网络/服务网格,传输认证由 mTLS 承担(post-v1)。二者不变量相同:权限永不由传输派生,传输仅表明调用方身份,授权始终以消息内签名制品承载。

禁止假设:任何服务或设备代码路径不得硬假设以下项可达——GCP 元数据服务器、PSC 端点、VPC-SC、Google JWKS 端点、Artifact Registry、以及任何云控制平面。降级模式行为正为此存在,例如在线注册在设计上可容忍兑换时云不可达(v0.12 §5.4),设备运行时行为应安全失败(保持状态、告警),而非把云可达当作正确性前提。提供方/后端选择由配置决定,不得硬编码签发方(D11)。

如何加接缝:当功能需要 SaaS 服务时,不要直接接入 SaaS 后端。应定义功能真正需要的接口(如“给我可验证的服务身份”,而非“调用 GCP 元数据服务器”);把受管 GCP 实现作为该接口下的一个后端;提供自托管后端,若尚未实现则以受跟踪 issue 桩接在接缝后;由配置选择后端并交给对端匹配的信任包,不得嗅探环境或在调用点内置“大概是 GCP”的默认值。可参考 D11 可插拔身份提供方模式,见 references/identity-backends.md 中网格工作负载身份生命周期以三个可互换后端实现该接缝。

事实来源:本技能提炼自 AAA Contract v0.21(2026-08-29 批准),现行契约位于 Linear(AAA Contract — Authentication, Authorization, Accounting),版本化演进;如与本技能冲突,以契约 为准并更新本技能。相关技能包括 wendy-aaa-interop、wendy-certificates、wendy-device-enrollment、wendy-device-interop、wendy-security-baselines,它们各自均强制回指本规则。

限制:资料未提供安装命令、价格、平台支持范围或具体操作步骤。