用途:把已有认证体系迁移到 Auth0,覆盖用户导出、批量导入、代码迁移与 JWT 校验更新。不适用于从零新建 Auth0 项目、在 Auth0 租户之间迁移,或仅新增 MFA 等功能。
迁移方式:批量迁移(一次性导入,适合小型或不活跃用户群);渐进式迁移(随登录懒迁移,适合大型活跃用户群);混合方式(导入不活跃用户、懒迁移活跃用户)。
主要步骤:一,检测现有认证提供方,通过 signInWithEmailAndPassword、onAuthStateChanged、passport.authenticate、jsonwebtoken、/api/auth/ 等代码特征判断,并确认是替换、并行还是全新搭建。二,从现有提供方导出用户,需包含邮箱、邮箱验证状态、密码哈希、用户元数据与创建时间。三,导入到 Auth0,可通过 Dashboard、CLI 或 Management API,资料给出命令示例:auth0 api post "jobs/users-imports" --data "connection_id=con_ABC123" --data "users=@users.json"。四,改造应用代码使用 Auth0 SDK,资料列出 React、Next.js、Vue、Angular、React Native、Express 及 API JWT 校验等参考。五,更新 API 的 JWT 校验:算法由 HS256 改为 RS256,issuer 改为 https://YOUR_TENANT.auth0.com/,JWKS 地址为 https://YOUR_TENANT.auth0.com/.well-known/jwks.json。
渐进式策略分四阶段:并行认证、新用户走 Auth0、强制迁移、清理旧代码。资料还列出常见问题(密码哈希不兼容、社交登录未关联、自定义 claims 缺失、令牌格式不同、会话持久化、用户需重新登录)及对应处理建议。
限制:需按具体框架配合对应 SDK 技能使用;资料未提供价格、平台支持范围、导入配额与性能数据。