用途:为 Gamma API 集成提供安全最佳实践,保护凭证与数据,适用于密钥保护、访问控制实施与安全审计。
主要能力:
- 密钥安全存储:禁止硬编码,改用环境变量,如 const gamma = new GammaClient({ apiKey: process.env.GAMMA_API_KEY });,并将 .env 加入 .gitignore,通过 import 'dotenv/config'; 加载。
- 密钥轮换:支持主备密钥切换,示例使用 GAMMA_API_KEY_PRIMARY 与 GAMMA_API_KEY_SECONDARY,轮换流程为生成新密钥、更新备用变量、部署验证、交换主备、吊销旧密钥。
- 请求签名与 Webhook 校验:使用 crypto 的 HMAC-SHA256 生成签名,并用 crypto.timingSafeEqual 校验 Webhook 签名。
- 访问控制:使用作用域密钥(如 scopes: ['presentations:read', 'exports:read'])与操作前权限检查。
- 审计日志:通过拦截器记录时间戳、用户、动作等,输出 gamma_api_request 类型日志。
使用方式:需已有 Gamma 集成、支持环境变量并理解密钥管理。按步骤配置环境变量、轮换密钥、签名校验、权限控制与审计日志,并对照安全检查清单核查。
限制与注意:部分能力标注“if supported”,需以实际支持情况为准;输出安全凭证时不得包含令牌或私密内容,仅保留身份范围、密钥引用、访问复核日期、控制结果、负责人与脱敏事件状态。资料未提供具体价格、平台与效果信息。