用途:在应用中集成 Scalekit SaaSKit 全栈认证,实现注册、登录、登出与会话管理,通过 JWT 令牌跨语言使用。
主要能力:生成授权 URL 跳转登录、回调中交换授权码获取令牌、创建会话、校验与刷新访问令牌、登出。idToken 含完整用户资料(sub、oid、email、name、exp),accessToken 含角色与权限(默认 5 分钟可配置),refreshToken 长期有效用于续期。一次集成可解锁 Magic Link 与 OTP、社交登录、企业 SSO、工作空间、MCP 认证、SCIM 供应与用户管理。
安装:Node.js 用 npm install @scalekit-sdk/node;Python 用 pip install scalekit-sdk-python;Go 用 go get github.com/scalekit-inc/scalekit-sdk-go/v2;Java 通过 Maven/Gradle 添加 com.scalekit:scalekit-sdk-java;PHP/Laravel 见 laravel-reference.md。
配置:在 .env 设置 SCALEKIT_ENVIRONMENT_URL、SCALEKIT_CLIENT_ID、SCALEKIT_CLIENT_SECRET、SCALEKIT_REDIRECT_URI,后者须与仪表板 Allowed Redirect URIs 完全一致。
使用方式:初始化客户端后,getAuthorizationUrl 生成登录地址并重定向;回调中用 authenticateWithCode 换取令牌;将 accessToken 与 refreshToken 存入 HttpOnly、secure Cookie;中间件读取 accessToken 并调用 scalekit.validateAccessToken 校验,失效则 refreshAccessToken 并更新 Cookie,刷新失败则登出;登出先清会话再跳转 getLogoutUrl。各语言方法命名略有差异,参见交叉引用表。
限制与护栏:必须在服务端校验访问令牌,不得未校验即信任 idToken/accessToken 声明;令牌不得存入 localStorage 等客户端可读存储;凭据不得硬编码;redirectUri 必须精确匹配注册回调;登出 URL 为一次性且登出后失效。框架专项参考(Python、Next.js、Go、Spring Boot、Laravel)及相关技能切换说明见原文。
适用场景:需要在多语言后端快速接入统一认证与 SSO 的应用。