Laravel中怎么实现单点登录_Laravel Sanctum认证流程【进阶】-Laravel

Sanctum 的 tokenable_type 和 tokenable_id 不能直接实现单点登录,因其默认允许多设备共存;需在登录时调用 $user->tokens()->delete() 清空旧 token,并配合前端清除本地存储及拦截 401 响应。

为什么 Sanctum 的 tokenable_type 和 tokenable_id 不能直接用来做单点登录

Sanctum 默认不阻止同一用户多设备登录,因为它的数据库表 personal_access_tokens 只记录 token 元信息,不标记“当前有效会话数”或“是否被踢出”。你删掉某条 token,只影响那个 token,其他同用户的 token 照常可用——这不是单点登录,是“多点共存”。要实现单点登录,必须主动干预 token 的生成和校验逻辑。

如何在登录时自动失效旧 token(关键步骤)

核心是在用户成功认证后、返回新 token 前,清空该用户所有已有 Sanctum token。注意:不是删 users 表数据,而是删 personal_access_tokens 中对应 tokenable_id 和 tokenable_type 的记录。

  • 使用 $user->tokens()->delete() —— 这是最安全的方式,它走 Eloquent 关系,自动匹配 tokenable_id 和 tokenable_type = 'App\Models\User'
  • 别用 DB::table('personal_access_tokens')->where(...)->delete(),容易漏掉 tokenable_type 判断,跨模型时出错
  • 确保你的 User 模型已 use Laravel\Sanctum\HasApiTokens,否则 tokens() 关系不存在

示例片段(在登录控制器中):

$user = Auth::user();
$user->tokens()->delete(); // ⚠️ 此行必须在 createToken() 之前
$token = $user->createToken('api-token')->plainTextToken;

怎么让已发出的旧 token 立即失效(不只是删库)

删 token 记录只是第一步。如果旧 token 已被客户端缓存并仍在请求头中使用,Sanctum 默认仍会通过 Guard::user() 找到对应用户(因为 token hash 还没被校验前就查库失败了?不,实际是:token 存在才校验;删了就 401)。但要注意两个边界情况:

夏夕资源网专注于CMS网站模板,主流语言整站网站源码下载,网站建设相关教程分享,好用的软件素材整合下载,提供一站式便捷自助服务。
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!
7. 如遇到加密压缩包,默认解压密码为"zy.lucklyus.top",如遇到无法解压的请联系管理员!
夏夕资源网-网站模板_免费源码_资源素材 » Laravel中怎么实现单点登录_Laravel Sanctum认证流程【进阶】-Laravel
在线时间:12:00 - 22:00
关注微信公众号:微信公众号
站长邮箱:[email protected]
  • 运营天数: 1392+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4003437+
  • 本周更新: 0+
  • 最后更新: 2026-03-16

本站指数

×
  • 运营天数: 1392+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4003437+
  • 本周更新: 0+
  • 最后更新: 2026-03-16