SuperAPI AI 工具集

better-auth

安全与审计

查看项目

更新于 10-15 18:31

技能介绍

用途:面向 TypeScript/JavaScript 应用实现身份认证与授权,适用于 Next.js、Nuxt、SvelteKit、Remix、Astro、Hono、Express 等框架,覆盖用户注册登录、会话与用户生命周期管理。

主要能力:内置邮箱/密码、社交 OAuth、邮箱验证、密码重置、会话管理与限流;通过插件支持双因素认证(twoFactor)、Passkeys/WebAuthn、Magic Link、用户名认证与组织/多租户。

使用方式:安装 npm install better-auth;配置环境变量 BETTER_AUTH_SECRET(至少 32 字符)与 BETTER_AUTH_URL;创建 auth.ts 调用 betterAuth 并按需启用 emailAndPassword、socialProviders;执行 npx @better-auth/cli generate 生成 schema/迁移,Kysely 场景可用 npx @better-auth/cli migrate;在框架中挂载 API 处理器(如 Next.js App Router 的 toNextJsHandler);创建客户端 createAuthClient 并调用 signUp.email、signIn.email、signIn.social、useSession/getSession。

架构:客户端—服务端双端结构,服务端处理认证逻辑、数据库与 API 路由,客户端提供前端钩子与方法,插件同时扩展两端。

限制:具体数据库适配细节、邮件发送配置与生产部署要求,资料未给出完整说明;添加插件后需重新生成 schema。