PHP怎么处理JWT刷新令牌_PHP安全令牌续期方案【方法】

陌枫君_1840

陌枫君_1840

2026-04-08

602人浏览

原创

JWT刷新令牌不能直接用原token重签发,因为其exp字段不可变,必须通过独立的refresh token校验后吊销旧token并签发新access+refresh token,确保安全隔离与状态管控。

php怎么处理jwt刷新令牌_php安全令牌续期方案【方法】

JWT刷新令牌为什么不能直接用原token重签发

因为JWT一旦签发就不可变,exp 字段写死在载荷里,服务端无法“延长”已签发token的有效期。强行用旧payload加新exp重签名,等于放弃刷新逻辑的安全前提——刷新必须绑定独立凭证(refresh token),且需校验其有效性、使用次数和绑定关系。

常见错误现象:InvalidSignatureException 或用户登出后仍能用旧access token调用接口,本质是把refresh token当成了access token的“续期开关”,没做分离校验。

  • access token应短时效(如15分钟),只含最小必要字段(uid、role),不存敏感信息
  • refresh token必须长期有效但强约束:HttpOnly+Secure+SameSite=Strict Cookie 存储,或客户端安全存储后每次带Authorization: Bearer
  • 服务端需持久化记录 refresh token 的状态:是否已使用、是否被撤销、关联的user_id和user_agent指纹

PHP中用firebase/php-jwt实现刷新流程的关键点

别直接调用JWT::encode()生成新access token就完事。核心是三步原子操作:验证refresh token → 吊销旧refresh token → 签发新access + 新refresh token。

示例关键逻辑片段:

// 验证refresh token(查DB或Redis)
$stmt = $pdo->prepare("SELECT user_id, used FROM refresh_tokens WHERE token = ? AND expires_at > NOW()");
$stmt->execute([$refreshToken]);
$rt = $stmt->fetch();
if (!$rt || $rt['used']) {
    throw new Exception('Refresh token invalid or already used');
}
<p>// 吊销当前refresh token(防重放)
$stmt = $pdo->prepare("UPDATE refresh_tokens SET used = 1 WHERE token = ?");
$stmt->execute([$refreshToken]);</p><p>// 签发新access token(短时效)
$accessTokenPayload = [
'uid' => $rt['user_id'],
'iat' => time(),
'exp' => time() + 900, // 15分钟
'jti' => bin2hex(random_bytes(16))
];
$accessToken = JWT::encode($accessTokenPayload, $secretKey, 'HS256');</p><p>// 签发新refresh token(长时效,带唯一jti)
$newRefreshToken = bin2hex(random_bytes(32));
$refreshPayload = [
'jti' => $newRefreshToken,
'uid' => $rt['user_id'],
'iat' => time(),
'exp' => time() + 2592000 // 30天
];
$stmt = $pdo->prepare("INSERT INTO refresh_tokens (token, user_id, expires_at) VALUES (?, ?, DATE_ADD(NOW(), INTERVAL 30 DAY))");
$stmt->execute([$newRefreshToken, $rt['user_id']]);
</p>

注意:jti 字段必须全局唯一,用于后续吊销单个token;不要用time()做refresh token主键,容易冲突。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

如何防止refresh token被泄露后滥用

仅靠过期时间不够。攻击者拿到refresh token后,可在过期前反复请求新access token,直到被发现。

  • 强制绑定设备指纹:登录时记录user_agent和ip_hash(非完整IP),刷新时比对,不一致则要求重新登录
  • 限制单个refresh token的使用频次:比如每24小时最多刷新5次,超限即冻结该用户所有refresh token
  • 启用“滑动过期”:每次成功刷新后,新refresh token的exp从当前时间重新计算,而非固定延后(避免长期静默持有)
  • 敏感操作前强制二次验证:如修改密码、导出数据,即使有有效access token也需短信/邮箱确认

数据库表建议至少包含:token(索引)、user_id、used(bool)、user_agent_hash、ip_hash、created_at、expires_at。

Laravel Sanctum或Passport是否适合做JWT刷新

Sanctum默认不走JWT,它用的是加密cookie+token字符串,没有标准refresh机制;Passport支持OAuth2刷新,但默认用refresh_token grant类型,返回的是新access token+新refresh token,符合规范,但要注意:

  • Passport的refresh_token默认不过期,需手动在config/auth.php中设置'refresh_expires_in' => 30 * 24 * 60(单位分钟)
  • Passport不会自动吊销旧refresh token,需监听RefreshTokenCreated事件并主动清理
  • 若项目已用firebase/php-jwt手写认证,硬切Passport成本高,不如补全手写逻辑

复杂点在于:refresh token的存储、吊销、审计日志必须和业务数据库联动,框架封装越深,越难插入自定义风控逻辑。真要细粒度控制,手写反而更透明。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php php安全

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

11944

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6841

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2195

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4348

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

5074

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3991

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5757

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4502

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12382

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习