用途:为 Convex 应用提供一份快速安全审计清单,覆盖身份认证、函数暴露、参数校验、行级访问控制与环境变量处理五个方面,用于自查与代码评审。
主要能力:清单式检查项,包括认证提供方是否配置、敏感查询是否调用 ctx.auth.getUserIdentity()、公开函数是否经过审查、内部函数是否使用 internalQuery/internalMutation/internalAction、HTTP action 是否校验来源与认证、函数是否声明 args 与 returns 校验器、是否避免对敏感数据使用 v.any()、用户是否只能访问自身数据、管理员函数是否校验角色、删除操作是否验证归属、密钥是否存放于环境变量且仅在 action 中读取等。
使用方式:按清单逐项核对代码;文档建议实现前先查阅最新官方文档,包括 https://docs.convex.dev/auth、https://docs.convex.dev/production、https://docs.convex.dev/auth/functions-auth 与 https://docs.convex.dev/llms.txt。资料中给出认证辅助函数、公开与内部函数、参数校验、行级权限与环境变量读取的示例代码,可作为编写参考。
适用场景:Convex 项目的安全自查、上线前评审、团队代码规范落地。
限制:资料未提供自动化扫描工具、安装命令、收费信息或具体平台支持范围;清单为人工核对性质,实际效果取决于项目实现与官方文档的最新要求。