用途:为 ElevenLabs 集成的密钥、Webhook 与语音数据提供安全加固流程,适用于需要保护 API 密钥、验证 Webhook 来源真实性、并对克隆语音做合规审计的场景。
主要能力:一、API 密钥管理,要求密钥仅存于环境变量,将 .env 加入 .gitignore,并用 pre-commit 钩子拦截 sk_ 形式的密钥提交。二、按环境区分密钥(开发/预发/生产分别使用不同密钥),启动时加载密钥、缺失即快速失败。三、Webhook HMAC 校验:ElevenLabs 请求带 ElevenLabs-Signature 头,格式为 t=TIMESTAMP,v1=SIGNATURE,需用 HMAC-SHA256 校验、拒绝超过 5 分钟的时间戳以防重放,并采用时序安全比较。四、Express Webhook 端点需基于原始请求体校验,尽快返回 200 后异步处理,避免超时。五、密钥轮换:先新建密钥并验证,再推送至各环境,确认生产可用后吊销旧密钥,实现零停机。六、语音数据保护:克隆语音属生物特征 PII,需限制克隆权限、记录审计日志并要求有书面同意。
使用方式与产物:应用该技能可得到仅存于环境变量的密钥配置、校验 Webhook 签名的辅助函数与端点、零停机密钥轮换手册,以及针对每次克隆、删除、使用的结构化审计日志(elevenlabs.voice.audit)和安全检查清单。
限制与注意:ElevenLabs 在连续 10 次以上投递失败且最近成功投递已超过 7 天(或从未成功)时会自动禁用 Webhook;应始终让处理程序快速返回 HTTP 200。资料未提供具体价格、平台支持范围与完整实现代码,完整生产代码位于 references/implementation.md,端到端示例位于 references/examples.md。