双因素认证接入
基于 Better Auth 配置 TOTP 身份验证器、邮件/短信验证码与备用码方案,实现安全完整的双因素登录拦截与设备信任流程。
功能与用途
本 Skill 专为全栈与后端开发者设计,基于 Better Auth 框架中的 twoFactor 插件实现标准化的双因素认证(2FA/MFA)体系。它涵盖了服务端与客户端的插件集成、数据库迁移验证、TOTP 动态密码绑定(二维码生成与多周期校验)、短信/邮箱 OTP 发送与加密落库、应急单次备用码管理、信任设备持久化、密码凭据与临时会话跳转拦截等完整实现方案,确保系统在兼顾安全防护(防暴力破解、防伪造、频次限制)的同时具备顺畅的用户登录体验。
适用场景
- 基于验证器App的TOTP绑定与校验:接入标准TOTP动态密码能力,生成绑定二维码并在密码登录成功后触发二次验证,提升账户安全。
- 邮件短信OTP与应急备用码配置:配置邮箱或短信一次性验证码发送与加密落库机制,同时生成并管理单次应急备用码以备账号恢复。
- 常用设备免密信任与登录拦截流程:设定设备信任有效周期与频次限制规则,并在登录凭据校验后安全派发临时状态实现平滑跳转与拦截。
适用人群
- Node.js/TypeScript 全栈工程师
- 前端与后端架构师
- 安全系统研发人员
- 使用 Better Auth 构建权限系统的开发者
使用步骤
- 在服务端 betterAuth 配置中注册 twoFactor 插件并声明应用发行方(issuer)与加密策略
- 在客户端 createAuthClient 中加载 twoFactorClient 插件并设置跳转回调 onTwoFactorRedirect
- 执行数据库迁移命令,确保用户表成功生成 twoFactorSecret 及相关字段
- 提供用户开启 2FA 的前端界面,验证当前密码后渲染 TOTP 二维码和应急备用码
- 在常规登录成功回调中判断 twoFactorRedirect 标记,引导用户完成二次身份校验
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
依赖与权限
- 读取用户主动提供的内容