SuperAPI AI 工具集

deepgram-security-basics

安全与审计

查看项目

更新于 10-15 23:25

技能介绍

用途:为 Deepgram 语音转写(STT)与语音合成(TTS)集成提供安全加固实践,覆盖密钥管理、数据保护与审计。

主要能力:

  1. 作用域 API 密钥:按服务分配最小权限,如 listen、speak、usage:read、manage/keys,并在环境变量或密钥管理器中保存,禁止写入代码;按 dev/staging/prod 分离密钥。
  2. 内置 PII 脱敏:调用转写时使用 redact 参数,如 redact: ['pci', 'ssn', 'numbers'],将信用卡号、社保号、数字序列替换为 [REDACTED]。
  3. 客户端临时密钥:通过服务端接口调用 manage.createProjectKey 生成短时效密钥(如 time_to_live_in_seconds: 10),供浏览器或移动端 WebSocket 使用,避免暴露主密钥。
  4. 密钥轮换:创建同作用域新密钥、更新密钥管理器、验证新密钥可用后再删除旧密钥,建议 90 天轮换并保留重叠期。
  5. SSRF 防护:转写前校验音频 URL,仅允许 HTTPS,解析 DNS 并拦截私有/内网 IP 与 localhost、metadata.google.internal 等主机名。
  6. 审计日志:以结构化 JSON 记录 transcribe、tts、key_create、key_delete 等操作,包含时间、用户、请求 ID、模型、时长、成功状态与错误。

使用方式:在 Deepgram Console 的 Settings > API Keys 创建作用域密钥;在代码中通过 @deepgram/sdk 的 createClient 初始化,转写时传入 redact 选项;服务端提供临时密钥接口;轮换与 URL 校验按上述步骤实现。

适用场景:需要处理敏感音频或转写文本、面向浏览器/移动端直连、以及有合规审计要求的集成。

限制:资料未提供具体价格、平台支持范围或性能数据;密钥轮换、临时密钥与 URL 校验需自行实现并配合组织的事件响应流程。