SuperAPI AI 工具集

implement-saaskit

通用与其它

查看项目

更新于 10-16 04:30

技能介绍

用途:为应用接入 SaaSKit 登录流程,涵盖登录路由、回调、会话 Cookie 与登出,完成后交由其他技能继续。默认语言为 Node。

主要能力与用法:先读取 SCALEKIT_ENVIRONMENT_URL、SCALEKIT_CLIENT_ID、SCALEKIT_CLIENT_SECRET、SCALEKIT_REDIRECT_URI(不要使用 SCALEKIT_ENV_URL);环境缺失时从 app.scalekit.com 的 Developers → Settings → API Credentials 获取,并在 Authentication → Redirect URLs → Allowed callback URLs 注册回调地址。无 SDK 时安装 @scalekit-sdk/node,Express 无 Cookie 解析时安装 cookie-parser,并在鉴权路由前挂载 cookieParser()。登录路由为每次登录生成随机 state 并存入短期 HttpOnly Cookie,回调先校验 state 与 error 再做 code 交换。回调设置三个 Cookie:accessToken(path /api)、refreshToken(path /auth/refresh)、idToken(path /),均为 HttpOnly、生产环境 Secure、sameSite 'lax'(strict 会破坏 OAuth 回调)。登出清除这些 Cookie,调用 getLogoutUrl({ idTokenHint, postLogoutRedirectUri }) 并跳转,该 URL 一次性,且需在仪表盘 Authentication → Redirect URLs → Post logout URLs 注册同一地址。

路径选择:Next.js App Router 改用 implement-saaskit-nextjs;Django/FastAPI/Flask 改用 implement-saaskit-python;Go、Java、Laravel 仍走本 Node 路径并仅在对应技术栈时打开 references/go.md、references/java.md 或 references/laravel.md。保护范围限于 /api/*,/dashboard 不接收 access Cookie。本技能不做令牌校验或刷新,不写刷新中间件、远程吊销或会话列表,这些交由 manage-saaskit-sessions 处理。

限制:资料未提供收费、价格、平台支持范围与效果数据;请勿自行编造环境变量值。