尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
不靠JWT手写会话Token系统:rust-web-app盐值Token生成、校验与自动续签原理
不靠JWT手写会话Token系统rust-web-app盐值Token生成、校验与自动续签原理【免费下载链接】rust-web-appCode template for a production Web Application using Axum: The AwesomeApp Blueprint for Professional Web Development.项目地址: https://gitcode.com/gh_mirrors/ru/rust-web-apprust-web-app是一个基于 Rust Axum 的生产级 Web 应用模板AwesomeApp Blueprint它没有引入任何 JWT 库而是用不到百行代码手写了一整套会话 Token 系统完成 Token 的生成、签名校验与自动续签。本文带你拆解这套盐值 Token 机制的原理与落地方式帮你理解不依赖 JWT 也能做出安全的会话管理。 为什么不用 JWT而是手写 Token 系统JWT 是通用标准但对登录态维持这类典型场景它带来了不少额外成本JSON 序列化、Header/算法协商、签名算法选择等。rust-web-app 的取舍很直接极简依赖只用blake3哈希 base64url 编码不依赖任何 JWT 库字段精简会话 Token 只需要谁登录了 何时过期 签名三个信息完全可控过期策略、自动续签、失效方式全部自己说了算。核心实现在 crates/libs/lib-auth/src/token/mod.rs配合中间件 crates/libs/lib-web/src/middleware/mw_auth.rs 构成完整闭环。 Token 结构三段式字符串Token 的格式只有一行注释就能说清ident_b64u.exp_b64u.sign_b64u段内容说明第 1 段ident_b64u用户标识用户名的 base64url 编码告诉服务端这是谁的会话第 2 段exp_b64uRFC3339 过期时间如2023-05-17T15:30:00Z控制会话有效期第 3 段sign_b64u签名防止前两段被篡改解析与序列化分别由Token的FromStr与Display实现见 token/mod.rs 第 27~59 行格式不合法比如不是三段会直接返回InvalidFormat错误错误定义见 token/error.rs。 盐值签名全局密钥 用户盐值的双重保险签名函数token_sign_into_b64utoken/mod.rs 第 127~149 行的做法是将b64u(ident) . b64u(exp)拼接后连同**用户盐值salt和全局密钥key**一起喂给 blake3 哈希输出即为 base64url 编码的签名。这里有两个关键设计1️⃣ 每个用户独立的token_saltUUID用户表里为每人单独存了一个盐值建表语句见 sql/dev_initial/01-create-schema.sql 第 27 行token_salt uuid NOT NULL DEFAULT gen_random_uuid()好处很实际只需更新这一个 UUID该用户所有已签发的 Token 立刻全部作废——实现踢人下线或密码重置时使会话失效成本只是一条 UPDATE。2️⃣ 全局TOKEN_KEY参与哈希密钥来自环境变量配置加载逻辑见 lib-auth/src/config.rs字段包括TOKEN_KEY和TOKEN_DURATION_SEC会话有效期秒。密钥本身由项目自带的gen-key工具生成crates/tools/gen-key/src/main.rscargo run -p gen-key # 生成 512 bit 随机密钥及其 base64url 编码生成的密钥以环境变量SERVICE_TOKEN_KEY的形式注入服务密钥与代码分离部署更安全。✅ 请求校验流程中间件的 4 个步骤每次请求都会经过中间件mw_ctx_resolvermw_auth.rs 第 34~86 行流程如下读 Cookie从名为auth-token的 Cookie 中取出 Token 字符串解析把三段式字符串解析为Token查用户按用户名取出UserForAuth包含其token_salt模型定义见 lib-core/src/model/user.rs 第 60~67 行验签 验过期validate_web_token用同样的算法重算签名并逐字节比对再检查exp是否早于当前时间token/mod.rs 第 101~123 行。两个细节值得学习安全兜底只要校验失败除没有 Cookie外中间件会顺手删除该 Cookiemw_auth.rs 第 44~48 行避免客户端长期拿着坏 Token 反复失败Cookie 防 XSSset_token_cookielib-web/src/utils/token.rs 第 12~22 行设置了HttpOnly前端 JS 拿不到 Token降低脚本注入窃取会话的风险。 自动续签滑动过期的巧妙实现这套系统最优雅的部分——续签不需要任何额外接口。在ctx_resolve的第 79 行每次校验通过后中间件都会调用一次set_token_cookie用同一个盐值重新生成并下发新 Token过期时间重新计算。效果就是经典的滑动过期sliding expiration用户持续活跃 → 每次请求都把过期时间往后推会话永不掉线用户长时间不操作 → Token 到期自然失效无需服务端维护黑名单。配合登录/登出两端登录handlers_login.rs 的api_login_handler校验密码通过后写入 Token Cookie第 56 行登出api_logoff_handler直接删除 Cookie第 84 行立即失效。️ 部署配置清单启动服务前需要准备的环境变量见 lib-auth/src/config.rs 第 24~32 行环境变量作用来源SERVICE_TOKEN_KEY512 bit 签名密钥base64url 编码cargo run -p gen-key生成SERVICE_TOKEN_DURATION_SEC会话有效期秒自行设定SERVICE_PWD_KEY密码哈希密钥供密码模块使用同上方式生成 小结rust-web-app 这套手写会话 Token 系统给出的完整方案是三段式 Tokenident.exp.sign比 JWT 更轻信息够用即可blake3 签名签名内容 用户盐值 全局密钥一起哈希抗篡改用户级token_salt改一个 UUID 即可让该用户全部会话作废中间件自动续签校验即刷新零额外接口的滑动过期密钥工具链gen-key工具 环境变量注入密钥与代码解耦。对初学者来说读懂 crates/libs/lib-auth/src/token/ 这一小目录就能完整掌握自签名、自校验、自续签的会话管理思路——这正是手写 Token 系统相对框架封装的最大价值每一个字节都在你的理解之内。【免费下载链接】rust-web-appCode template for a production Web Application using Axum: The AwesomeApp Blueprint for Professional Web Development.项目地址: https://gitcode.com/gh_mirrors/ru/rust-web-app创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

PUBG压枪宏3步搞定:5分钟用罗技鼠标压住枪

PUBG压枪宏3步搞定:5分钟用罗技鼠标压住枪

PUBG压枪宏3步搞定:5分钟用罗技鼠标压住枪 【免费下载链接】logitech-pubg PUBG no recoil script for Logitech gaming mouse / 绝地求生 罗技 鼠标宏 项目地址: https://gitcode.com/gh_mirrors/lo/logitech-pubg 瞄准敌人胸口按住扳机,前两发打…

📅 2026/10/18 21:22:36
3 步解除 PDF 复制打印限制:PDFPatcher 单文件与批量处理完整指南

3 步解除 PDF 复制打印限制:PDFPatcher 单文件与批量处理完整指南

3 步解除 PDF 复制打印限制:PDFPatcher 单文件与批量处理完整指南 【免费下载链接】PDFPatcher PDF补丁丁——PDF工具箱,可以编辑书签、剪裁旋转页面、解除限制、提取或合并文档,探查文档结构,提取图片、转成图片等等 项目地址:…

📅 2026/9/23 23:53:33
lyo名字的由来与极简哲学:冷冻干燥(lyophilization)背后的零配置打包理念

lyo名字的由来与极简哲学:冷冻干燥(lyophilization)背后的零配置打包理念

lyo名字的由来与极简哲学:冷冻干燥(lyophilization)背后的零配置打包理念 【免费下载链接】lyo 📦 Node.js to browser - The easy way 项目地址: https://gitcode.com/gh_mirrors/lyo/lyo 你有没有想过,为什么…

📅 2026/10/12 12:14:47
MORE NEWS

更多资讯

📰

淮南办个电工证千万别踩坑,新手避雷指南来了

淮南办个电工证千万别踩坑,新手避雷指南来了 怕考不过白交培训费?别急,先看这里!淮南办个电工证是不少建筑、工程、电力行业从业者必须面对的问题。如果你是刚入行的郑州水利工程从业者,或者准备转行进入电工行业,那你一定知道,一个正规的…

📰

南部低压电工证培训千万别踩坑,找对方法才能稳稳上岗

南部低压电工证培训千万别踩坑,找对方法才能稳稳上岗 你是不是也像我一样,刚转岗进电工行业,心里一万个问号?手里没低压电工证,连面试资格都没有,更别提上岗干活了。现在整个行业对低压电工证的要求越来越高, 千万别踩坑…

📰

苍溪考高压电工证怎么选机构?官方报名入口在这里

苍溪考高压电工证怎么选机构?官方报名入口在这里 工地太忙根本没时间复习考试,这几乎是每个电工的共同经历。你可能正忙于赶工期,每天在高压线附近操作,却连报名考试的时间都挤不出来。别急, 苍溪考高压电工证…

📰

高压电工作业需要几人值不值得考?证书过期了不知道怎么复审延期?

高压电工作业需要几人值不值得考?证书过期了不知道怎么复审延期? 证书过期了不知道怎么复审延期?你不是一个人。最近有不少人问我,高压电工作业到底需要几个人,值不值得考?尤其是在南阳项目现场,很多管理员都对特种作业证书的管理一头雾水,更别说操作…

📰

毕节可以考电工证吗内部消息:别被中介坑了,电工证报考全攻略

毕节可以考电工证吗内部消息:别被中介坑了,电工证报考全攻略 你是不是也这样,听说要考电工证,但不知道从哪开始,怕被中介坑,又怕花冤枉钱?别急,今天咱就聊聊 毕节可以考电工证吗 这个问题,顺便给你点 内部消息…

📰

汕尾电工证在那查询 2026河南最新政策解读

汕尾电工证在那查询 2026河南最新政策解读 你是不是正愁找不到工作?手上又没有特种作业证?别急,今天我来给你讲讲汕尾电工证在那查询这件事,顺便说说2026河南最新政策到底怎么变,帮你把证拿到手,工作也顺顺利利安排上。…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬