SuperAPI AI 工具集

speak-security-basics

安全与审计

查看项目

更新于 10-15 23:29

技能介绍

用途:为 Speak API 集成提供安全基础实践,覆盖 API 密钥保护、音频数据隐私、学生数据保护以及 COPPA/FERPA 合规。

前提条件:已完成 speak-install-auth 设置;已配置有效 API 凭据;已安装 ffmpeg 用于音频处理。

主要能力与用法:

  1. API 密钥安全:不要提交密钥,执行 echo '.env' >> .gitignore 与 echo '.env.local' >> .gitignore;生产环境使用密钥管理服务,例如 export SPEAK_API_KEY="$(aws secretsmanager get-secret-value --secret-id speak/api-key --query SecretString --output text)"。
  2. 音频数据隐私:Speak 在自有服务器处理音频,除非应用需要,否则不要在本地保存学生音频;示例 PrivacyAwareClient 在评估后于 finally 中删除本地音频文件。
  3. 学生数据保护:不记录学生录音日志;从 API 日志中隐去学生姓名;只存评估分数而非原始音频;实施数据保留策略(N 天后删除);13 岁以下学生需家长同意以符合 COPPA;教育机构需学生数据协议以符合 FERPA。
  4. 安全检查清单:密钥存于密钥管理器而非代码;处理后删除音频;不记录学生 PII;所有 API 调用强制 HTTPS;限流防滥用;保留访问日志用于审计。

错误处理:401 未授权多为密钥无效,检查 SPEAK_API_KEY;429 限流需等待 Retry-After 秒并退避;音频格式错误需用 ffmpeg 转为 WAV 16kHz 单声道;会话 30 分钟超时后需新建会话。

适用场景:教育类语音评估应用、需处理学生音频与合规要求的 Speak 集成项目。

限制:资料未提供具体收费、价格、平台支持范围及效果数据;部分实现细节需结合 speak-prod-checklist 与官方资源进一步确认。