文档目录

用户、角色和 API 密钥

更新于 2026年11月17日

角色是 admin、operator 和 viewer。操作员和只读只在 Team 上存在。API 密钥是 Team 功能,要么只读,要么读写,读写最多相当于操作员。停用用户会立刻结束其会话。

角色

三个角色名是 admin、operator 和 viewer。管理员或操作员可以写。只读用户不能写:变更请求会被拒绝,除了一小份只读式 POST 白名单(报表查询和导出、Flow 模拟、落地页预览链接)。后台把它写成:管理员是全部权限,操作员可改投放配置,只读只能看。

Pro 不打开角色功能,所以 Pro 上额外的用户都是管理员,上限 3 个。Team 打开角色,并且不限制用户数。你不能修改自己的角色或状态,因此最后一位管理员不能把自己锁在外面。密码至少 8 个字符,最多 72 字节。修改自己的密码会保留当前会话,并使其余会话失效。

只读用户,以及对相应领域没有写权限的 MCP 令牌,看到的联盟密钥是掩码(•••• 加末 4 位)。Webhook 地址和流量源回传模板只显示到主机。只读用户没有复制回传链接的控件。包含流量源回传模板的配置导出,需要操作员及以上。

API 密钥

API 密钥需要 Team(api_keys)。权限是 ["read"] 或 ["read","write"]。省略权限会创建只读密钥。只读密钥相当于 viewer。读写密钥最多相当于操作员。它不能调用用户、API 密钥、备份、MCP 令牌、审计日志、品牌和常规设置、授权激活、软件更新或演示数据。这些仍是管理员路由,返回 403。创建者不是活动用户时,密钥停止工作。

停用某人

DELETE /api/users/{id} 或 PATCH 且 status 为 disabled 会提高会话代数。已有登录在下一次请求时失败。他们的 API 密钥停止。他们的 MCP 令牌失败,因为创建者不再是活动的管理员。他们拥有的定时报表停止,因为调度器只连接活动用户。这些行不一定被删除。重新启用用户不会恢复旧会话;他们需要重新登录。

审计日志是 Team 上记录谁在何时改了什么的功能。MCP 令牌见 MCP,上限见套餐。