用途:审计并导入现有认证数据到 SaaSKit,属于迁移专用技能,完成导入后即停止,不编写登录、回调或登出逻辑。
主要能力与流程:
- 确认是迁移场景;非迁移应用应改用 implement-saaskit。需从 app.scalekit.com → Developers → Settings → API Credentials 获取三个环境变量名。
- 审计并导出用户、组织、角色及 SSO/IdP 配置,保留原始主键;导入前保存旧系统的样本 JWT 或会话 Cookie,添加仍指向旧认证的特性开关,并写好回滚步骤。
- 导入组织:仓库尚无 SDK 时安装 @scalekit-sdk/node,用 SCALEKIT_ENVIRONMENT_URL、SCALEKIT_CLIENT_ID、SCALEKIT_CLIENT_SECRET 初始化,createOrganization 时以 externalId 保存源组织主键。
- 导入用户:在组织存在后调用 createUserAndMembership,设置 externalId、sendInvitationEmail: false 及 firstName/lastName。并行分批执行并遵守速率限制。
- 重建 SSO 与重定向:在 Authentication → Redirect URLs 配置回调与登出 URL,在 Roles & Permissions 重建角色;IdP 密钥不可导出,需用 implement-sso 重建,不从 Auth0 或 Clerk 复制密钥。
- 指向 SaaSKit:登录等交由 implement-saaskit,会话校验、刷新与撤销交由 manage-saaskit-sessions。
- 在特性开关后切换:小范围用户测试,先放量 5–10%,查看 Dashboard → Auth Logs,保留回滚 48 小时。
- 结束:用 run-dryrun 测试环境,上线前用 check-saaskit-prod。
限制与注意:必须先审计导出再导入;不得复制密码哈希,用户通过托管登录重新认证;不得复制 IdP 密钥;环境变量请用 SCALEKIT_ENVIRONMENT_URL 而非 SCALEKIT_ENV_URL,且不要加 https:// 前缀;审计清单与多语言导入示例见 references/AUDIT-CHECKLIST.md 与 references/IMPORT-SAMPLES.md(本技能不在此处粘贴)。收费、价格与平台支持情况暂未提供。