SuperAPI AI 工具集

testing-auth-setup

安全与审计

查看项目

更新于 10-16 05:33

技能介绍

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。