用途:为 Lokalise 集成提供安全实践,涉及 API Token 管理、翻译内容清洗、CI/CD 密钥处理、Webhook 密钥校验与审计日志。翻译内容可能含插值变量、HTML 或 PII。
前提:已配置 Lokalise API Token(审计用管理员令牌,操作用范围令牌);理解只读与读写权限模型;具备密钥管理设施(GitHub Secrets、AWS/GCP Secret Manager 或 Vault)。
主要能力与用法: 一、令牌范围管理:按用途创建独立令牌(只读、读写、管理员),通过环境变量读取,缺失即报错。下载翻译使用只读令牌。 二、翻译内容校验:检查 XSS 载荷(script、javascript:、on*=)、凭证泄露(api_key、password、secret、token 赋值)、占位符完整性;发现 critical 问题则退出并报错。 三、Webhook 密钥校验:Lokalise 在 X-Secret 头发送随机密钥,需校验,失败返回 401。 四、CI/CD 令牌安全:使用仓库 Secrets,如 LOKALISE_READ_TOKEN,命令 lokalise2 file download 配合 token、project-id、format json 等参数,日志自动脱敏。 五、扫描硬编码令牌:提供 scripts/scan-secrets.sh,检查源码硬编码、.env 是否被 gitignore、git 历史泄露,发现即失败。 六、审计翻译变更:记录时间戳、项目、键、语言、用户、动作及新旧长度,不记录实际内容以避免 PII。
输出:范围令牌配置、内容校验器、Webhook 校验中间件、使用仓库密钥的 CI/CD 工作流、令牌扫描脚本、PII 安全审计日志。
限制:资料未提供具体定价、平台支持范围或版本要求;需自行接入日志后端;示例基于 Node.js 与 Express。进一步企业级 RBAC 见 lokalise-enterprise-rbac。