故障排查深度场景内容4 分钟阅读aggregation

数据分级与访问控制:四个核对入口

把 FastGPT 的数据分级与访问控制拆成组织架构、文件级权限、发布快照与身份集成四组入口,逐项给出配置位置、核对动作、失败表现与版本边界。

访问控制在国内项目评审里通常被拆成四个问题:部门隔离怎么做、单份文件怎么控、发布后权限会不会漂移、身份从哪来。四个问题对应四个入口,逐项核完,权限设计才有可交付的证据。

入口一:组织架构与资源授权

入口:FastGPT 权限说明。

位置在成员管理、部门与群组设置、应用与知识库的授权页。核对动作是列出三个角色:部门管理员、项目成员、只读成员,按部门与群组分别授权,再看资源列表里各自能看到哪些应用与知识库。最小权限可以落到单个账号,这一点在做外来人员临时访问时最有用。

失败表现是授权给了群组,但群组里新加的人看不到资源,或者旧人离职后仍在群里保留权限。边界:组织架构变动会连带影响资源可见范围,人员调整要与授权调整同一批次做。

入口二:文件级权限

入口:FastGPT 权限说明。

位置在知识库文件树与文件操作菜单。该能力按文件或文件夹单独配置协作者,支持继承与独立两种状态,可恢复继承,也支持所有权转移;开关默认关闭,开启后列表与详情按文件权限鉴权;检索以当前成员身份鉴权时过滤可读文件,预选知识库但未启用成员鉴权的路径需另验。

核对动作是打开开关后,用两个成员身份各跑一次同样的检索,比较返回条目。失败表现是同一问题两个账号看到不同引用,被当成检索不稳定。边界:开关关闭时行为与存量一致,开启前要先确认存量文件的协作者现状,否则会出现一批文件无人可见。

入口三:发布快照与运行身份

入口:FastGPT 更新说明。

位置在应用的发布记录与资源权限设置。发布版本对静态资源按发布时快照校验,对动态资源按实际运行用户校验。核对动作是发布后用一个新加入的成员访问,确认静态资源可见性与发布时一致,动态资源跟随该成员自己的权限。

失败表现是发布后权限随协作者变化漂移,或者新成员看不到本应可见的页面。边界:快照校验解决的是“发布那一刻的权限”,运行身份解决的是“此刻的权限”,两者同时存在,排查时先分清是哪一层。

入口四:身份来源与集成

入口:FastGPT 版本说明。

位置在单点登录与 OA 集成配置,专业版起支持。核对动作是列一张账号来源表:账号由哪套系统创建、同步方式、停用后本地会话是否失效。失败表现是登录成功但看不到应有资料,双方各说一层。

边界:单点登录负责身份,授权仍由应用内的组织架构与资源授权决定。两条链路不要合并描述,否则争议时无法定位。

分级怎么落到目录上

分级的落地通常按三层走:按部门分层、按项目建目录、按文件配例外。三层混在同一个目录里,改一次授权要连带检查三处,出错概率高于多建两个目录。核对动作是任取一个部门目录,自上而下确认每层的授权来源:哪些继承自父级、哪些独立配置。失败表现是所有文件都改成独立态,看起来权限精细,实际没人说得清谁该有什么。边界:目录级授权会作用到之后放进该目录的文件,范围比当下看到的更大,新文件落进来之前先想清楚归属。

四个入口核完,把结论写成两页:一页是角色与资源对照表,一页是文件权限与发布快照的测试记录。两页合起来,就是权限设计的交付证据。两页都要写复核日期,权限是随人员变动的,去年的对照表对今年的评审没有证明力。

数据来源

主题版本来源
组织架构分权、最小权限到单人账号、SSO 与 OA 集成当期商业方案FastGPT 商务咨询:授权、部署与支持范围
文件级权限、发布权限快照v4.17.1self-host/upgrading/4-17/4171
目录导航不附带管理授权v4.17.3self-host/upgrading/4-17/4173