SuperAPI AI 工具集

migrate-to-saaskit

安全与审计

查看项目

更新于 10-16 08:45

技能介绍

用途:审计并导入现有认证数据到 SaaSKit,属于迁移专用技能,完成导入后即停止,不编写登录、回调或登出逻辑。

主要能力与流程:

  1. 确认是迁移场景;非迁移应用应改用 implement-saaskit。需从 app.scalekit.com → Developers → Settings → API Credentials 获取三个环境变量名。
  2. 审计并导出用户、组织、角色及 SSO/IdP 配置,保留原始主键;导入前保存旧系统的样本 JWT 或会话 Cookie,添加仍指向旧认证的特性开关,并写好回滚步骤。
  3. 导入组织:仓库尚无 SDK 时安装 @scalekit-sdk/node,用 SCALEKIT_ENVIRONMENT_URL、SCALEKIT_CLIENT_ID、SCALEKIT_CLIENT_SECRET 初始化,createOrganization 时以 externalId 保存源组织主键。
  4. 导入用户:在组织存在后调用 createUserAndMembership,设置 externalId、sendInvitationEmail: false 及 firstName/lastName。并行分批执行并遵守速率限制。
  5. 重建 SSO 与重定向:在 Authentication → Redirect URLs 配置回调与登出 URL,在 Roles & Permissions 重建角色;IdP 密钥不可导出,需用 implement-sso 重建,不从 Auth0 或 Clerk 复制密钥。
  6. 指向 SaaSKit:登录等交由 implement-saaskit,会话校验、刷新与撤销交由 manage-saaskit-sessions。
  7. 在特性开关后切换:小范围用户测试,先放量 5–10%,查看 Dashboard → Auth Logs,保留回滚 48 小时。
  8. 结束:用 run-dryrun 测试环境,上线前用 check-saaskit-prod。

限制与注意:必须先审计导出再导入;不得复制密码哈希,用户通过托管登录重新认证;不得复制 IdP 密钥;环境变量请用 SCALEKIT_ENVIRONMENT_URL 而非 SCALEKIT_ENV_URL,且不要加 https:// 前缀;审计清单与多语言导入示例见 references/AUDIT-CHECKLIST.md 与 references/IMPORT-SAMPLES.md(本技能不在此处粘贴)。收费、价格与平台支持情况暂未提供。