SuperAPI AI 工具集

two-factor-authentication-best-practices

安全与审计

查看项目

更新于 10-15 18:31

技能介绍

用途:为使用 Better Auth 的应用添加双因素认证(2FA),覆盖 TOTP 验证器应用、邮件/短信 OTP、备份码、可信设备以及登录时的 2FA 流程。

主要能力:服务端需在 betterAuth 配置中加入 twoFactor 插件并设置 issuer,客户端加入 twoFactorClient 插件;可用内置适配器执行 npx auth@latest migrate,或为 Drizzle/Prisma 生成并推送迁移。启用 2FA 需要密码验证,返回用于生成二维码的 TOTP URI 和备份码,首次 TOTP 验证成功前 twoFactorEnabled 不会置为 true。TOTP 支持 digits 与 period 配置;OTP 支持通过 sendOTP 自定义邮件或短信发送、有效期、位数和尝试次数;备份码在启用时自动生成,可重新生成并用于恢复。登录返回 twoFactorRedirect 时需跳转眼验证页,验证成功后创建会话。可信设备通过 trustDevice 参数,默认信任 30 天并随每次登录刷新。

限制:该技能资料表明 2FA 仅可用于凭证(邮箱/密码)账户;OTP 存储可选 plain、encrypted 或 hashed;内置限流为所有 2FA 端点每 10 秒 3 次请求;TOTP 密钥使用 auth secret 加密,备份码默认加密。未提供其他平台或定价信息。