用途:Gamma 的 API 每个工作区只有一个 API 密钥,没有逐用户身份验证,因此细粒度权限必须在你的应用层实现。本技能用于为 Gamma 集成搭建企业级 RBAC。
主要能力:定义 guest、viewer、editor、admin 四类角色及其权限;编写 Express 授权中间件(requireGammaPermission);为多租户提供按租户 API 密钥或资源级隔离;按角色设置每日生成与每月积分配额;记录审计日志;并维护包含角色、批准的操作类别、策略版本、复审日期、审批人与撤销结果在内的访问凭据,但不得包含凭据或演示内容。
使用方式:先定义角色与权限映射,再用中间件保护路由,例如 app.post("/api/presentations", requireGammaPermission("generation:create"), ...);多租户场景通过 TenantGammaService 按租户缓存客户端;调用 checkQuota 校验配额;用 auditGammaAction 写入审计记录。
前置条件:Gamma Teams 或 Business 订阅、用于存放用户与角色的应用数据库,以及完成 gamma-install-auth 设置。
适用场景:团队权限配置、多租户访问、企业授权管理,以及需要按角色限制生成、模板、主题、文件夹与成员管理的集成。
权限矩阵要点:viewer 可查看与下载;editor 可创建生成并使用模板;admin 额外可管理主题/文件夹、成员与 API 密钥配置;guest 无生成权限。
限制:应用层隔离依赖自身实现正确,需在所有路由上校验角色以防越权;跨租户访问需在 getClient() 中确认隔离;配额超出需等待重置。资料未提供具体价格、部署平台或效果数据。