HALO 使用单独的凭据进行资源支出、公共项目配置、最终用户授权和项目管理。通过 API 表面进行选择,而不是到处传递一个通用令牌。
#凭证矩阵
| 凭据 | 示例 | API 界面 |
|---|---|---|
| 客户端 API 密钥 | sk-… | 模型网关,记忆 |
| 可发布密钥 | apikey: … | 公共项目身份验证 |
| 项目用户访问 | Bearer eyJ… | 当前用户、注销、OAuth 同意 |
| OAuth 应用访问 | Bearer eyJ… | OAuth 用户信息和服务范围 |
| 仪表板所有者 JWT | Bearer … | 项目配置和管理 |
#HALO 客户端密钥
以 sk- 开头的密钥授权计费网关和记忆调用。它们必须保留在受信任的运行时中。
#项目可发布密钥
通过 apikey 或x-halo-project-key。导航到提供商授权端点可能会携带 ?apikey= ,因为浏览器重定向无法添加自定义标头。
#项目用户承载令牌
RS256 访问令牌代表一个身份验证用户和一个会话。使用项目 JWKS 和所需的声明进行验证。请勿将其用作模型支出密钥。
#仪表板所有者 JWT
所有者路由位于下方 /api/user。后端在允许身份验证配置、用户管理、会话撤销、API 密钥管理或注册表更改之前验证项目所有权。