SuperAPI AI 工具集

deepgram-enterprise-rbac

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:为 Deepgram 企业部署实现基于角色的访问控制,把应用角色映射到 Deepgram API 密钥作用域,并按最小权限原则发放、撤销和轮换密钥。

主要能力:定义五种角色(admin、developer、analyst、service、auditor)及其作用域、密钥有效期和说明;通过 Deepgram Management API 创建带作用域的密钥(createProjectKey)、撤销密钥(deleteProjectKey)、列出密钥(getProjectKeys);提供 Express 的 requireRole 与 requireScope 中间件;团队管理支持添加成员时自动发放密钥、移除成员时撤销密钥、变更角色时先撤销旧密钥再创建新密钥;按到期时间自动轮换即将过期的密钥。

作用域参考:member 为全部权限(仅管理员);listen 用于 STT 转写;speak 用于 TTS 合成;manage 用于项目/密钥管理;usage:read 查看用量指标;keys:read 列出 API 密钥;keys:write 创建/删除密钥。

使用方式:先准备已验证的身份源、项目/角色负责人、最小权限角色映射和访问审查计划,并具备通过审批的身份/管理路径开通或撤销用户与服务凭据的权限。随后定义角色与作用域映射,使用 @deepgram/sdk 的 createClient 创建管理客户端,调用 manage.createProjectKey 发放密钥,在 Express 路由上挂载 requireScope('listen')、requireScope('speak')、requireScope('usage:read')、requireRole('admin') 等中间件,并通过 TeamManager 管理成员,最后用 rotateExpiringKeys 定期轮换。

适用场景:需要为转写、语音合成、用量查看、审计等不同职责分配差异化权限的企业团队,以及需要自动化密钥生命周期管理的服务账号。

限制:资料未提供具体定价、平台支持范围或性能数据;密钥轮换依赖密钥注释格式 role:userId:date,格式不符时无法自动轮换;管理密钥需具备 member 作用域,否则创建密钥会失败。