用途:该技能指导用户以增量、可回滚的方式,从现有认证系统迁移到 Scalekit 全栈认证平台,适用于需要迁移登录、会话与权限体系的场景。
主要能力:提供五阶段迁移清单。阶段一审计并导出数据,覆盖注册/登录流程、会话中间件、令牌校验、RBAC 逻辑、邮箱验证、登出与会话终止,并导出用户记录(email、name、email_verified)、组织/租户结构、角色与权限、SSO/IdP 配置;要求备份 JWT 或会话 cookie 样本、设置可回滚特性开关并记录回滚流程。用户最小 schema 中 email 必填,first_name、last_name、email_verified 可选(后者默认 false)。
阶段二导入组织与用户:强调 external_id 用于保存原主键映射。先创建组织,再在组织内创建用户,示例使用 scalekit.organization.createOrganization 与 scalekit.user.createUserAndMembership。导入时设置 sendInvitationEmail: false 以跳过邀请邮件,成员自动激活且邮箱标记为已验证;建议并行批量导入并遵守速率限制,校验 external_id 映射一致。
阶段三配置重定向与角色:在 Scalekit 控制台 Settings → Redirects 注册回调 URL,添加登出后 URL;在 User Management → Roles 或通过 SDK 定义角色,导入时在 membership 对象中带 roles 数组,登录后验证令牌中的角色声明。
阶段四更新应用代码:用 Scalekit SDK 或 JWKS 端点替换旧版 JWT 校验;验证受保护路由接受访问令牌、刷新令牌续期正常、RBAC 使用 roles 声明;在控制台 Branding 更新登录页 logo、颜色、文案与法律链接,并处理邮箱验证提示与登出跳转。
阶段五部署与监控:先用一部分已迁移用户测试登录,验证会话创建、校验与过期及端到端角色访问;按部署代码、启用特性开关路由至 Scalekit 的顺序,从 5%–10% 用户开始逐步扩大,监控认证成功率与错误日志,48 小时内保持回滚方案。
限制与故障排查:用户无法登录时检查回调 URL、external_id 映射与邮箱一致性;会话校验失败时切换至 Scalekit JWKS 端点并检查令牌过期/刷新逻辑;SSO 不工作时确认组织已启用 SSO 并测试 IdP 发起的登录。资料提示密码迁移支持即将推出,如需请联系 Scalekit 解决方案团队。更多语言示例见 IMPORT-SAMPLES.md 与 AUDIT-CHECKLIST.md,但资料未提供其具体内容。