用途:审计现有认证系统并将其导入 SaaSKit,导入完成后即停止。适用于希望从 Auth0、Clerk 等迁移到 SaaSKit 的场景;若应用本无认证系统,应改用 implement-saaskit。
主要能力与约束:必须先审计与导出再导入;原始组织与用户主键须存入 external_id;每个导入用户须设置 sendInvitationEmail: false;除非由 Scalekit Solutions 团队操作,不得复制密码哈希;首次发布窗口须保留回滚功能开关;本技能不编写首次登录、回调或登出,应改用 implement-saaskit。用户通过托管登录重新认证(SSO、社交或无密码)。
使用方式(分步):1. 确认是迁移场景,从 app.scalekit.com → Developers → Settings → API Credentials 收集三个环境变量名。2. 审计并导出:打开 references/AUDIT-CHECKLIST.md 完成检查,导出用户、组织、角色、SSO/IdP 配置,保留原主键;导入前保存旧系统一个 JWT 或会话 cookie 样本,添加仍指向旧认证的功能开关,并写下回滚步骤;用户最小字段为 email(必填)、first_name、last_name、email_verified(默认 false)。3. 导入组织(仓库无 Scalekit SDK 时安装 @scalekit-sdk/node):使用 organization.createOrganization,externalId 为源组织主键,Node 可用选项只有 externalId、logoUrl、slug。4. 在组织存在后导入用户,使用 user.createUserAndMembership,并设 sendInvitationEmail 为 false,externalId 对应导出值,并行批处理并遵守速率限制。5. 重建 SSO 与重定向:在 Authentication → Redirect URLs 配置回调与登出 URL,在 Roles & Permissions 重建角色,改用 implement-sso 重建各 IdP,不要复制 IdP 密钥。6. 指向 SaaSKit:登录、回调、cookie、登出用 implement-saaskit,校验、刷新、撤销用 manage-saaskit-sessions。7. 在开关后切换,先用少量用户测试,放量 5–10%,查看 Dashboard → Auth Logs,回滚保留 48 小时。8. 停止,用 run-dryrun 测试环境,上线前用 check-saaskit-prod。
环境变量:读取 SCALEKIT_ENVIRONMENT_URL、SCALEKIT_CLIENT_ID、SCALEKIT_CLIENT_SECRET,不要用 SCALEKIT_ENV_URL,不要加 https:// 前缀。默认语言为 Node,与其他语言样本见 references/IMPORT-SAMPLES.md。
限制:不导入密码哈希;IdP 密钥不可导出,SSO 须重建;本技能不编写登录/回调/登出路由。文档索引、迁移指南、Auth0 迁移与 MCP 地址见资料所列链接。