用途:该技能帮助智能体在已自行管理用户与会话的应用中接入 Scalekit Modular SSO,覆盖 SAML/OIDC、IdP 发起的登录和管理员门户。若应用已用 Full-Stack Auth 或 SaaSKit 登录,应改用 implement-saaskit,二者不并用。
主要能力与用法:默认语言为 Node,默认 scope 为 openid profile email。需读取 SCALEKIT_ENVIRONMENT_URL、SCALEKIT_CLIENT_ID、SCALEKIT_CLIENT_SECRET,不要使用 SCALEKIT_ENV_URL。每次授权 URL 必须传一个选择器:connectionId、organizationId 或 loginHint,顺序为 connectionId > organizationId > loginHint,domainHint 也可用;redirectUri 必须与仪表盘 Allowed callback URL 完全一致,使用 claims 前必须调用 validateToken,IdP 发起的登录需把 relay_state 作为 state。流程含初始化 SDK、/auth/login、IdP 发起的 /login、/auth/callback 及管理员门户;门户支持分享链接或 iframe 嵌入,嵌入时需注册页面来源,链接为一次性,并处理 PORTAL_SESSION_EXPIRY 与 PORTAL_LOAD_FAILURE(SESSION_EXPIRED)事件。
限制:Modular SSO 不支持 offline_access,不写 refresh token 或 SaaSKit cookies;不运行 npm install、不启动服务、不点击仪表盘;不得虚构 org_… ID 或环境变量值;组织 ID 从仪表盘复制,测试使用 Organizations → Test Organization,IdP 接入指引见 references/providers.md。仅需目录同步时用 implement-scim。