SuperAPI AI 工具集

tanstack-start-security

安全与审计

查看项目

更新于 10-15 16:48

技能介绍

用途:在不进行全量安全重写的前提下加固 TanStack Start 应用,聚焦认证与会话保护、Cookie/CSRF/可信来源、请求中间件(src/start.ts)、服务端函数与路由、密钥与环境变量边界、SSR/水合与客户端执行泄露、安全响应头/CSP/CORS、Webhook 校验与限流。不适用于普通 React 任务或非安全性的文案修改,也不是通用非 TanStack 安全审查路径。

使用前提:仅当仓库出现 TanStack Start 信号时启用,例如 app.config.ts、package.json 中的 @tanstack/react-start 或 @tanstack/react-router、src/routes/__root.tsx。缺少这些信号时应停止并转入常规实现或安全审查路径。

主要能力:编辑安全敏感代码前按提示类型读取规则文件——认证、授权、Cookie、请求来源读 rules/auth-and-session.md;createServerFn、createServerOnlyFn、env/密钥与导入边界读 rules/server-boundaries.md;服务端路由、CSP、响应头、CORS、限流与 Webhook 读 rules/http-and-headers.md;审查门与验证步骤读 rules/validation.md;涉及认证栈细节、TanStack 执行规则或 Better Auth 时读 references/official-security-notes.md。随后映射所触及的安全面,按最轻修复顺序处理:先阻断密钥或边界泄露,再补会话/授权,再收紧 Cookie、来源与变更安全,之后添加响应头、CSP、Webhook 校验与限流,最后才考虑较大规模的认证栈或路由结构迁移。

自动修复策略:对局部、可回滚且明确更安全的改动可直接修复,如把特权逻辑移到 createServerFn 或 createServerOnlyFn 之后、添加路由/会话守卫、用仅服务端访问替代客户端暴露的密钥、补输入校验或来源/签名检查、在当前技术栈明确时收紧 Cookie 或响应头默认值。不自动应用大范围高风险迁移,如更换认证库、大规模改会话模型、未核查资源与脚本需求就全站重写 CSP、跨环境的 CORS 或 Cookie 域调整。

核心安全门(未修复则阻断改动):客户端可达代码能导入或推导密钥;受保护的数据变更信任客户端提供的身份或角色声明;loader 或共享工具在无显式服务端边界下执行特权工作;路由仅依赖 beforeLoad 而无等效服务端保护;loader 输出、SSR 上下文或水合状态序列化密钥或仅内部认证数据;服务端路由接受浏览器状态变更输入却无认证/来源/CSRF 策略;Webhook 处理程序在验签前信任载荷;认证/会话 Cookie 配置宽松且缺少明确环境规则。

验证与限制:需通过相关规则文件清单和项目自身的 lint、typecheck、test、build 检查,记录确切命令与结果,并说明已加固项与仍依赖具体栈的残余风险。网络访问、凭据使用及破坏性或影响生产的命令需用户明确批准。资料未提供具体命令示例与价格信息。