SuperAPI AI 工具集

better-auth

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:该技能是 Better Auth 的实现与迁移指南,适用于新建实例、框架集成、会话与 Cookie 配置、插件添加以及从其他认证库迁移等场景。

主要能力:按影响优先级组织为 8 类共 42 条规则。关键类别包括设置与配置(如每环境设置强 BETTER_AUTH_SECRET、显式 baseURL、单例导出、trustedOrigins);数据库适配器与 Schema(按 ORM 选适配器、发布前运行 auth generate 与 ORM migrate、additionalFields 扩展用户表、databaseHooks、连接池共享);API 路由处理(在 /api/auth/[...all] 挂载 catch-all、Node.js 运行时、避免 body 解析中间件前置);会话与 Cookie(服务端 auth.api.getSession 与客户端 authClient.useSession、expiresIn 与 updateAge、cookieCache、Cookie 属性、跨子域、customSession);认证方式(邮箱验证、OAuth redirectURI 精确匹配、环境变量存放凭证、magicLink 实现、客户端登入助手、类型推断)。

安全与加固:生产中启用持久化 rateLimit、迁移时覆盖哈希函数、密码重置后撤销会话、minPasswordLength 至少 10、trustedOrigins 不用通配符。

插件与迁移:Next.js 中 nextCookies() 放最后、2FA issuer、共享访问控制、服务端与客户端插件配对、组织活跃上下文、jwt 使用时机、admin impersonate;以及并行切换、OAuth 身份映射、forceAllowId 保留用户 ID、NextAuth v5 字段映射。

使用方式:新实现按 setup-、db-、route- 优先顺序阅读,再按范围选取 session-、auth-、security-;迁移则先读 migrate-parallel-cutover,再读密码哈希互操作与身份/字段映射。可查阅 references/_sections.md、assets/templates/_template.md 与 metadata.json。

限制:资料未提供具体代码示例、价格或效果数据,相关细节暂未提供。