Testing Auth Setup 是 Scalekit 生态中的一个技能,用于验证 Scalekit 认证集成是否针对真实环境正确配置。它通过运行 Scalekit dryrun CLI 来完成检查。
用途
该技能面向需要测试认证集成的用户。当用户表达“test my auth”“verify SSO setup”等意图时,可以运行此技能来验证配置。它不会替代初次搭建,而是用于对已有配置进行验证。
主要能力
技能支持两种模式:
- fsa:测试全栈认证登录流程,适用于设置或验证登录、回调与会话处理的场景。
- sso:测试企业级 SSO 流程,适用于设置或验证与身份提供商之间的 SAML/OIDC SSO 的场景。
技能包含若干强制约束:运行 dryrun 前必须确认 SCALEKIT_ENVIRONMENT_URL 和 SCALEKIT_CLIENT_ID 已设置;运行 sso 模式前必须获取 organization_id(若未提供则需询问);必须展示 dryrun 输出并用通俗语言解释哪些通过、哪些失败;当模式不明确时不得自行猜测,必须询问用户选择 fsa 还是 sso。
使用方式
前置条件:确认以下环境变量可用:
- SCALEKIT_ENVIRONMENT_URL — Scalekit 环境 URL
- SCALEKIT_CLIENT_ID — 来自 app.scalekit.com > Settings 的客户端 ID
运行全栈认证(fsa):
npx @scalekit-sdk/dryrun --env_url=$SCALEKIT_ENVIRONMENT_URL --client_id=$SCALEKIT_CLIENT_ID --mode=fsa
运行企业 SSO:需要 organization_id,若未提供需先询问。
npx @scalekit-sdk/dryrun --env_url=$SCALEKIT_ENVIRONMENT_URL --client_id=$SCALEKIT_CLIENT_ID --mode=sso --organization_id=<organization_id>
选择模式:如果用户未指定模式,不得自行选择。技能会扫描项目中的明确信号(例如 SAML/OIDC IdP 配置文件、环境变量中的 organization_id、已应用的 SSO 技能)。若信号强烈指向 SSO,则询问确认 sso(并在缺失时收集 organization_id);若信号强烈指向仅全栈认证,则询问确认 fsa;若信号不明确或无信号,必须询问用户使用哪种模式,绝不在未确认的情况下默认选择。
运行之后:展示命令输出;用通俗语言解释哪些通过、哪些失败。若测试失败,将常见失败映射到后续步骤:
- Invalid client / unauthorized:SCALEKIT_CLIENT_ID 或环境 URL 错误。下一步:从 app.scalekit.com → Settings 重新检查凭据。
- redirect_uri mismatch:回调未注册。下一步:在 Allowed Redirect URIs 下添加精确的回调地址。
- organization not found:sso 模式中 organization_id 错误或缺失。下一步:确认组织 ID,用 --organization_id=… 重新运行。
- Connection refused / DNS:SCALEKIT_ENVIRONMENT_URL 错误。下一步:确认环境 URL 包含 https:// 且主机名正确。
- Timeout / network:防火墙或离线。下一步:重试;检查到 Scalekit 环境的网络访问。
适用场景与限制
适用于验证已有 Scalekit 认证集成,包括全栈认证和 SSO 两种场景。该技能用于测试验证,而非初始搭建。如需初始认证设置、SSO 配置或完整的上线前审查,应分别切换到 implementing-saaskit、implementing-modular-sso 或 production-readiness-saaskit。