Skip to content

控制台与角色 ​

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

控制台由控制面提供。用托管控制面时,地址是我们给你们的那个。

登录 ​

  • 配置的登录身份提供方:「用 配置的登录身份提供方登录」用的是你的 配置的登录身份提供方,Google、GitHub 或邮箱都行,所有产品共用一个账号。账号恢复和登录设备在 配置的登录身份提供方那边处理,Guard 自己没有密码。
  • 企业账号登录:项目可以配置成用你们公司的 OIDC 身份提供方登录。这时还会出现「企业账号登录」,身份提供方里的组映射到 Guard 的角色。

会话固定 15 分钟,不会延长。结束前一分钟,页面顶部会提示。结束后点「继续」重新登录,回到原来的页面。没保存的策略修改还在。

组织与项目 ​

在「组织与项目」页:

  • 自己的空间:点「切换或新建组织」到 配置的登录身份提供方,选一个你所属的组织,或者新建一个。即使你现在只是别人组织的成员,也可以新建自己的组织。
  • 邀请同事:邀请在 配置的登录身份提供方里做(「管理组织与邀请」)。对方接受后,用这个组织登录 Guard 即可。
  • 新建项目:点「新建项目」,由当前组织的所有者填写名称。新项目默认只观察模式,事件保留 30 天、最多 100,000 条,还没有任何凭据。每个组织最多创建 100 个项目。
  • 切换:用顶部的项目选择器。权限按新项目重新计算,屏幕上的一次性值会被清掉。切换项目不会延长会话。

配置的登录身份提供方里组织成员或所有者的变化,在下一次登录 Guard 时生效。

角色 ​

角色按项目分配。

角色控制台名称能做什么
owner项目所有者管理成员、接入和 SDK 下载令牌;编辑、预演和发布策略;退役执行器;管理云托管
admin策略管理员编辑、预演、提交审核和发布策略;回滚;退役执行器;批准或拒绝动作审批;管理云托管
reviewer独立审核员批准或驳回候选策略;批准或拒绝动作审批
viewer只读成员查看项目里的所有内容
  • 组织的所有者就是 Guard 里的所有者。这在 配置的登录身份提供方里管,在这里改不了。
  • 其他人第一次进来都是只读成员,除非所有者提前按邮箱分配了角色。
  • 策略的作者不能审核自己的策略,所有者也不能代替审核员批准动作。每个项目至少需要两个人。
  • 每个请求服务端都会检查。控制台只是把某个角色用不了的按钮藏起来。

成员 ​

「成员」页只有所有者能看。每个人可以设置:

  • 角色(管理员、审核员或只读成员)。
  • 可信主体:Guard 在动作审批时拿它比对,防止有人批准自己的动作。不填就用邮箱。

可以在对方还没登录过的时候,就按邮箱分配角色。「停用」让这个人无法登录组织里的任何项目,他已有的会话立即失效。「恢复」后,他下次登录即可进入。

页面 ​

页面显示什么
概览当前策略和模式、在线的执行器、已观察到的事件、待处理的审批
接入接入、接入包、「检查接入」、SDK 下载令牌
资产Agent、工具、MCP 服务和网络目标:已登记的、已接管的,以及观察到但没登记的
执行器每个执行器的健康状态、版本、是否支持格式 v2、最近心跳和已加载的策略版本
事件事件调查(在原来的控制台里打开)
策略YAML 形式的策略:编辑、预演、保存为候选
策略工作流候选、预演、审核、发布、从观察生成、已发布版本和回滚
审批动作审批队列
组织与项目你的组织和项目
成员人员、角色和可信主体
审计最近的控制操作:谁做了什么、是否被允许

云托管另有「网关」「托管任务」「上游凭据」三页,见完全云托管:网关与托管任务。

执行器健康状态 ​

状态含义
在线2 分钟内有心跳
失联2 分钟没有心跳
出错执行器报告了问题:连不上控制面、策略问题,或凭据被拒绝
已停止执行器已关闭
凭据已失效凭据已撤销或过期
已退役被所有者或管理员退役。它的心跳会被拒绝,也不再参与格式 v2 的发布检查

每个执行器的策略状态显示为「已加载当前策略」「待确认」或「仍在用旧版本」。

资产覆盖情况 ​

覆盖情况含义
已接管已登记,且在线的执行器确认加载了当前策略
待确认已登记,还没确认
未接管已登记,但不在 Guard 保护之下
已观察 · 未登记事件里出现过,但从没登记

覆盖情况只统计到达过 Guard 的东西。绕过 Guard 的工具不会出现在这里,你们的工具、MCP 和网络配置也要另外核对。

专家视图 ​

完整的哈希、ID 和原始代码默认隐藏,打开专家视图才显示。