认证系统深度解析

NuxtBase 内置了基于 Better Auth 的生产级认证系统。本文将介绍实现背后的关键决策。

包含功能

• 社交登录 — Google 和 GitHub OAuth，可扩展支持任何提供商
• 邮箱/密码 — 包含邮箱验证的传统登录流程
• 双因素认证 — 基于 TOTP 的 2FA，附带备用码
• Passkeys — 基于 WebAuthn 的无密码登录
• Magic Links — 一键邮箱登录

多租户架构

每个用户都属于一个组织。认证系统处理：

• 注册时自动创建组织
• 基于邀请的成员加入流程
• 基于角色的访问控制（所有者、管理员、成员）
• 多团队用户的组织切换

安全考量

• 所有会话都在服务端管理，使用安全的 HTTP-only Cookie
• 认证端点的速率限制
• 2FA 的可信设备管理
• 完善的审计日志

目标是提供一个可以直接上线的基础，让团队不需要从零构建认证系统。