安全注意事项
本页整理 schema 定义、自定义 validator 和导出器使用时需要注意的安全问题。第一次快速上手不需要先读这里;当 schema 涉及凭据、URL、正则或生成数据库约束时,再回到本页核对。
发布 schema 相关代码前
- 运行
npm audit --audit-level=moderate。 - 确认文档示例不包含真实密钥、Token 或密码。
- 自定义正则应避免灾难性回溯。
- 自定义 validator 不应执行不可信输入生成的代码。
- 将
.js/.cjs语言包视为应用自有可信代码。如果 locale 目录可能包含不可信文件或只应作为数据来源,请配置codeLocaleFiles: 'deny',仅加载.json、.jsonc、.json5。
当前建议
依赖升级后应重新运行完整测试与构建验证。
对应示例文件
示例入口: security-checklist.ts
说明: 使用占位 token、受限字符集和显式 URL 校验,示范文档中“不要暴露真实凭据”“正则要有界”的落地写法。