SuperAPI AI 工具集

gram-rbac

通用与其它

查看项目

更新于 10-16 09:30

技能介绍

用途:Gram 的 RBAC 采用“作用域(scope)+ 选择器(selector)”模型,用于控制用户或自定义角色对 org、project、mcp 等资源的操作权限。

主要能力:服务端内置固定作用域并归入系统角色 admin(全部作用域)与 member(读取与连接子集)。grant 将作用域绑定到选择器(含 resource_kind、resource_id,MCP 还支持 tool、disposition),再授予某 principal。作用域存在扩展关系,如 mcp:write 可满足 mcp:read,read/write 可满足 connect。选择器匹配时,grant 含“*”或值相等即通过,grant 有而 check 没有的键会被跳过。

使用方式:处理器通过 authz.Engine.Require(ctx, authz.Check{...}) 强制校验,列表接口用 Filter(ctx, scope, ids) 过滤;服务端分为 authz(执行原语)与 access(Goa 管理 API,暴露 /rpc/access.* 路由,如 listScopes、listRoles、listUserGrants、enableRBAC 等)。仪表盘通过 useRBAC hook 与 RequireScope 组件按 page/section/component 级别做 UI 门控,并用手动维护的 types.ts 与 SDK 保持作用域词汇一致。

限制:作用域、资源类型或 disposition 变更需在服务端、设计枚举、生成 SDK 与客户端多处同步维护(三处枚举 lockstep),并非纯服务端改动;RBAC 关闭或未加载 grant 时返回硬编码全访问列表;系统角色不可重命名、删除或改授权集。具体收费、价格与平台支持暂未提供。