用途:指导从现有认证系统到 Scalekit 的增量、可回滚迁移,按阶段执行,不能跳阶段。
主要能力与阶段:1)审计并导出认证数据,覆盖注册/登录流程、会话中间件、令牌校验、RBAC、邮箱验证、登出与 SSO/IdP 配置,导出用户(邮箱、姓名、email_verified)、组织/租户、角色与权限;2)先创建组织再在组织内创建用户,导入时把原系统主键存入 external_id,导入期间设置 sendInvitationEmail: false,批量导入需遵守 Scalekit 速率限制并校验 external_id 映射;3)在 Scalekit 后台 Settings → Redirects 注册回调与登出后地址,在 User Management → Roles 或通过 SDK 定义角色,并在成员关系中加入 roles;4)替换旧 JWT 校验为 Scalekit SDK 或 JWKS 端点,确认受保护路由、刷新令牌与 roles 声明可用,更新登录页品牌与邮箱验证、登出跳转等流程;5)先在小范围迁移用户上测试,再部署并开启特性开关,从 5–10% 流量起步,监控认证成功率与错误日志,回滚开关至少保留 48 小时。
必要用法与命令:迁移前必须备份认证数据并记录回滚流程;导入必须保留原始标识到 external_id;验证阶段可用客户端凭证获取令牌并查询迁移用户,示例命令:curl -s -X POST "$SCALEKIT_ENVIRONMENT_URL/oauth/token" -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=$SCALEKIT_CLIENT_ID&client_secret=$SCALEKIT_CLIENT_SECRET&grant_type=client_credentials";curl -s -H "Authorization: Bearer $TOKEN" "$SCALEKIT_ENVIRONMENT_URL/api/v1/organizations/<org_id>/users?email=migrated-user@example.com"。
限制与未提供信息:技能要求不得跳过阶段或在验证子集前全量切换;密码迁移支持尚未提供,如需请联系 Scalekit 解决方案团队;收费、价格、平台限制与具体效果资料未提供。AUDIT-CHECKLIST.md、IMPORT-SAMPLES.md 等随技能包提供的文件未在资料中展开。