用途:为使用 Scalekit SaaSKit 的应用实现用户会话管理,覆盖登录后的令牌安全存储、每个受保护请求的访问令牌校验与过期透明刷新、刷新令牌轮换,以及注销时通过会话 API 撤销会话。
主要能力:按应用类型选择存储方案。传统服务端渲染应用将访问令牌与刷新令牌分别存入 HttpOnly Cookie(生产环境启用 Secure,SameSite 设为 Lax,访问令牌 Cookie 限定 /api,刷新令牌 Cookie 限定 /auth/refresh);SPA 将访问令牌保存在内存并经 Authorization: Bearer 发送,刷新令牌存放在 HttpOnly Cookie 或安全存储,禁止将访问令牌放入 localStorage;移动端将刷新令牌放安全平台存储。提供 Express、Flask、Gin、Spring 的存储与中间件示例;支持刷新令牌轮换;通过会话 API 实现查看活动会话、注销单个设备、注销全部设备。会话时长(绝对超时、空闲超时、访问令牌有效期)可在控制台调整。
使用方式:先确认应用类型、框架、Cookie 名称与属性、加密方案及 SDK 可用性,再依次实现登录时存储令牌、受保护请求的校验加刷新中间件、独立刷新端点、注销与撤销会话,最后按清单验证。加密解密函数为应用自有实现,非 SDK 方法。
适用场景:多设备登录、需要“退出此设备/全部设备”的产品,以及需强制重新登录的过期会话处理。
限制:缺少刷新令牌的失败刷新必须返回 401 并强制重新登录;缺失类型则采用默认安全规则。示例代码为占位逻辑,具体方法名以已安装 SDK 为准;控制台策略项的具体配置方式暂未提供。