控制台与角色
适用范围:当前托管生产使用组织工作区。个人工作区及其所有者自审需等待控制面升级;自部署实例请按实际版本与身份配置判断。
控制台由控制面提供。用托管控制面时,地址是我们给你们的那个。
登录
- 配置的登录身份提供方:「用 配置的登录身份提供方登录」用的是你的 配置的登录身份提供方,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 和原始代码默认隐藏,打开专家视图才显示。