https://api.phaseo.app/v1):
管理密钥、API 密钥和 OAuth 令牌
管理路由只接受管理密钥(或 OAuth 令牌);Gateway API 密钥无法调用它们。
护栏是另一种独立的控制:它们作用于 Gateway API 密钥,管控推理流量,例如路由限制、预算、提示注入处理和敏感信息规则。管理密钥的能力决定它可以调用哪些管理 API。
选择访问级别
创建密钥时,每个模板都会展开为一份明确的能力列表。Phaseo 从不存储all 之类的通配符,因此密钥永远不会获得之后新增的权限。
所有模板都不包含
billing:write(用于发起额度充值);需要时请通过 --scopes 明确申请。All 仅用于可信的管理自动化。
如需更小的授权,请用 --scopes scope_a,scope_b 传入你需要的能力:
能力不会覆盖工作区角色
每次调用时,Phaseo 都会检查两件事:密钥是否具有该能力,以及密钥或 OAuth 用户是否属于该工作区并拥有操作所需的角色。例如,keys:write 允许管理密钥,但仍由角色检查决定调用方能否管理该工作区中的密钥。密钥不能借助某项能力访问其他工作区,也不能跳过所有者和管理员检查。
保护好密钥
- 不要让管理密钥出现在浏览器、桌面日志、源代码管理或聊天中。
- 每个集成使用一个密钥,并选择能满足需求的最小权限模板。
- 如果集成不需要永久访问,请设置过期时间。
- 立即暂停或删除不再使用的密钥。
- 密钥泄露时,先轮换密钥,再进一步调查。