该技能面向实现、升级、调试或审查 Better Auth 应用的场景。先查快速参考索引,再按任务加载对应主题文件,如核心认证、数据模型与适配器、框架集成、OAuth/OIDC/MCP、组织与 SSO/SCIM、会话与安全、迁移指南、CLI 升级等。
主要能力:覆盖 email/密码、验证、账号关联、社交登录、两步验证、passkey、OTP、魔法链接、API 密钥等;提供 OAuth 2.1 与 OIDC 授权服务器、SSO/SAML/SCIM 组织能力;支持无数据库无状态会话、密钥轮换、令牌加密、CSRF 与来源校验;含统一中间件钩子、后台任务、适配器与插件开发测试。
使用方式:按索引加载主题文件;升级时用独立 CLI,例如 npx auth init、npx auth migrate、npx auth generate --adapter prisma、npx auth upgrade,注意发行版仅 ESM。部分功能已拆分为独立包,如 @better-auth/sso、@better-auth/scim、@better-auth/passkey、@better-auth/api-key、@better-auth/oauth-provider。服务流量前先执行 schema 迁移,例如将组织成员 teamId 替换为 teamMembers 连接表,API 密钥 userId 改为 referenceId 并新增 configId,OIDC redirectURLs 改为 redirectUrls。
限制与注意:数据库 create.after、update.after、delete.after 钩子在提交后运行,原子后续写入应放在适配器操作或事务中。会话 freshAge 基于 createdAt,刷新不能无限保持新鲜。CSRF 与来源校验相互独立,disableCSRFCheck 只关闭 CSRF 防御,disableOriginCheck 还会关闭回调/重定向校验。提供商令牌默认明文,可用 account: { encryptOAuthTokens: true } 加密。密钥轮换时新密钥放前、旧密钥保留解密。SSO 需允许发现 URL 与端点,SCIM 需导出五种方法。具体版本兼容性与行为以官方文档为准。