多用户集成需要同时管理 API 凭证、会话标识和业务授权。FastGPT 的 APIKey 管理随版本演进,外部系统自动创建密钥的历史需求应与当前成员凭证规范分别核对。
历史范围与凭证规范
Issue #4029 于 2025 年 3 月提出外部创建密钥的需求,原线程的自动关闭记录只反映维护状态,具体管理接口仍需按部署版本确认。v4.15.0 更新说明 记录了统一 APIKey 管理的调整;当前API 发布文档 将 APIKey 定义为团队成员凭证,调用应用时显式传入 appId。
集成检查
- 在应用“发布渠道 → API”创建或选用凭证,核对所属成员、应用访问权限、额度和有效期。凭证保存在业务服务端。
- 为每段会话生成独立
chatId,在后端保存业务用户与appId、chatId的归属关系。 - 每次读取或续接历史消息前,验证当前登录用户对该会话的访问权限;历史列表也应按业务归属筛选后返回。
- 需要自动管理凭证时,先查对应版本开放接口的鉴权与权限范围,并在测试团队验证创建、失效及权限收回流程。
验证结果
用两个测试用户分别创建会话,检查各自的历史记录,再尝试访问另一用户的会话,确认业务服务拒绝越权请求。删除测试凭证后复测调用失败。会话参数规则见官方对话接口。