SuperAPI AI 工具集

implementing-admin-portal-scim

通用与其它

查看项目

更新于 10-16 08:45

技能介绍

用途:在自有应用的设置/管理页面内嵌入一个客户自助门户,让客户自行配置其 SSO 与 SCIM 设置,无需人工介入。

主要能力:按检测到的语言/框架安装 SDK;通过环境变量配置凭据;服务端生成门户链接;客户端以 iframe 渲染;监听 SCIM_CONFIGURED、SSO_CONFIGURED、SESSION_EXPIRED 事件并响应配置变更与会话过期。

安装:Node.js 执行 npm install @scalekit-sdk/node;Python 执行 pip install scalekit-sdk;Go 执行 go get github.com/scalekit/scalekit-go;Java 在 pom.xml 添加 com.scalekit:scalekit-sdk。凭据写入 .env:SCALEKIT_ENVIRONMENT_URL、SCALEKIT_CLIENT_ID、SCALEKIT_CLIENT_SECRET,取自 Dashboard > Developers > Settings > API Credentials。

必要用法:在 Dashboard > Developers > API Configuration > Redirect URIs 注册嵌入域名,否则 iframe 会被阻止。服务端每次页面加载用 organization.generatePortalLink / generate_portal_link 生成新链接,不得缓存(链接一次性)。前端将 location 注入 iframe 的 src,建议高度不低于 600px。必须处理 SESSION_EXPIRED:重新获取新链接并重载 iframe src,否则长会话下门户会静默失效。可选在 Dashboard > Settings > Branding 配置品牌与自定义域名。

适用场景:需要在生产环境让客户自助配置 SSO/SCIM 时使用。一次性 onboarding 通话等零代码场景可用 Dashboard > Organizations 生成可分享链接,但该链接持有者可完整配置该组织的 SSO/SCIM,生产环境应使用 iframe 方案。

限制:不得将 CLIENT_SECRET 暴露给浏览器;不得缓存门户链接;须先注册重定向域名;须处理会话过期事件。具体费用、价格与效果暂未提供。