当前位置:

首页 > 编程开发 > Webapp 令牌安全指南:访问与刷新实践

Webapp 令牌安全指南:访问与刷新实践

本文详解Web应用中accesstoken与refreshtoken的颁发、存储、使用及自动续期机制,涵盖前后端协作流程、前端存储策略(localStorage/sessionStorage)、HTTP请求头携带方式、过期检测逻辑及推荐的拦截器实现方案。

本文目录

    Webapp 中访问令牌与刷新令牌的安全实践指南

    本文详解 Web 应用中 access token 与 refresh token 的颁发、存储、使用及自动续期机制,涵盖前后端协作流程、前端存储策略(localStorage/sessionStorage)、HTTP 请求头携带方式、过期检测逻辑及推荐的拦截器实现方案。

    在现代 Web 应用(尤其是基于 JavaScript 框架如 Angular、React 或 Vue 构建的单页应用)中,采用 Token 认证(如 OAuth 2.0 或 JWT)已成为主流方案。其中,access token(访问令牌)用于短期 API 调用鉴权,而refresh token(刷新令牌)则用于在 access token 过期后安全地获取新令牌,避免用户频繁重新登录。

    ✅ 标准流程:登录 → 发放 → 存储 → 使用 → 刷新

    1. 服务端发放双令牌
      用户凭账号密码完成登录后,服务端应生成一对令牌:

      • access_token:短时效(如 15–60 分钟),签名有效,用于每次 API 请求鉴权;
      • refresh_token:长时效(如 7–30 天),强保密(不暴露于前端 JS 环境更佳),仅用于向 /auth/refresh 等专用接口换取新 access token。
        两者以 JSON 形式返回客户端,例如:
        {
        "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "refresh_token": "d3a7f9c1-8b2e-4e8a-b4f0-2c1a3e4d5f6b",
        "expires_in": 900
        }
    2. 前端安全存储策略

      • ❌ 不推荐 Cookie(尤其未设 HttpOnly):若将 access_token 存于普通 Cookie 并通过 withCredentials: true 发送,易受 XSS 攻击窃取;且无法被 JS 读取,导致无法手动添加 Authorization: Bearer 头。
      • ✅ 推荐 localStorage / sessionStorage:
        • localStorage:持久化存储,浏览器关闭后仍保留 → 适用于“保持登录”场景;
        • sessionStorage:仅限当前标签页生命周期 → 更安全,但关闭标签即登出。
          示例(登录成功后):
          // TypeScript(Angular/React/Vue 通用逻辑)
          localStorage.setItem('access_token', response.access_token);
          localStorage.setItem('refresh_token', response.refresh_token);
          localStorage.setItem('expires_at', Date.now() + response.expires_in * 1000);
    3. 请求时自动注入 access token
      所有需鉴权的 API 请求必须在 Authorization 请求头中携带 access token:

      Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

      实践中,应使用HTTP 拦截器(Interceptor)统一处理,避免每个请求手动添加。以 Angular 为例:

      @Injectable()
      export class AuthInterceptor implements HttpInterceptor {
        intercept(req: HttpRequest, next: HttpHandler): Observable> {
          const token = localStorage.getItem('access_token');
          if (token) {
            const authReq = req.clone({
              headers: req.headers.set('Authorization', `Bearer ${token}`)
            });
            return next.handle(authReq);
          }
          return next.handle(req);
        }
      }
    4. 自动续期:用户离开又返回时如何“无感登录”?
      当用户关闭浏览器后再次访问网站,前端应:

      • 检查 localStorage 是否存在 access_token 和 refresh_token;
      • 验证 access_token 是否过期(解析 JWT payload 中的 exp 字段,或比对本地 expires_at 时间戳);
        • ✅ 未过期 → 直接使用,发起请求;
        • ⚠️ 已过期 → 使用 refresh_token 向后端 /auth/refresh 接口发起 POST 请求,换取新 access_token(注意:此请求不应携带原 access_token,且需校验 refresh_token 有效性与绑定关系);
        • ❌ refresh_token 也过期或无效 → 强制跳转登录页。

      ? 安全提示:refresh_token 建议由服务端存储在 Redis 等可撤销存储中,并与用户设备指纹/UA/IP 绑定,支持主动吊销(如用户登出、异地登录)。

    ? 总结与最佳实践

    • 双令牌机制是平衡安全性与用户体验的关键设计;
    • 前端优先使用 localStorage + 显式过期时间管理,而非依赖 Cookie 自动发送;
    • 必须通过 HTTP 拦截器统一注入 token,并集中处理 401 响应(触发刷新逻辑);
    • 服务端需提供 /auth/refresh 接口,严格校验 refresh_token,且禁止返回新的 refresh_token(除非启用轮换策略);
    • 生产环境务必启用 HTTPS,防止 token 在传输中被劫持。

    遵循以上模式,即可构建既安全又流畅的用户会话体验。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    n8n 1.123.97相对1.123.96改了什么,依赖版本如何判断
    n8n 1.123.97相对1.123.96改了什么,依赖版本如何判断

    n8n 1.123.97更新1.x分支的undici、multer、follow-redirects等依赖;说明扫描发现口径、版本比较及适用分支,避免误作2.x降级目标。

    Ducter 0.0.57怎样整理手头任务,项目与设备识别有何变化
    Ducter 0.0.57怎样整理手头任务,项目与设备识别有何变化

    Ducter 0.0.57按仓库或文件夹自动组织项目,区分四项任务状态并说明等待条件与复查时间,同时统一页头和设备识别。

    llama.cpp b12431代码标签如何判断推理级别是否被模板拒绝
    llama.cpp b12431代码标签如何判断推理级别是否被模板拒绝

    llama.cpp b12431通过保存聊天模板明确拒绝的推理级别,让对应请求以400和支持级别提示返回。它修正的是reasoning_effort错误分类:此前三类兼容端点可能把模板拒绝反映为500,不能据此将所有推理失败都归入同一原因。

    llama.cpp b12430预发布的HIP修复与多平台构建有什么区别?
    llama.cpp b12430预发布的HIP修复与多平台构建有什么区别?

    llama.cpp b12430为预发布构建,修复HIP后端MoE回归;区分GFX906上的两种性能对比基准、dense对照与多平台附件适用边界。

    Plannotator v0.28.66管理Inbox线程时为何要区分合并与归档?
    Plannotator v0.28.66管理Inbox线程时为何要区分合并与归档?

    Plannotator v0.28.66支持Inbox多选整理,Combine在新线程到达后才归档原线程;说明Tidy、标签筛选、文件附件、跨机器等待及默认关闭的Routines边界。

    llama.cpp b12429代码标签如何理解Ripple DFlash2的NoPE转换修正
    llama.cpp b12429代码标签如何理解Ripple DFlash2的NoPE转换修正

    理解llama.cpp b12429代码标签,需要先区分NoPE层索引名单和逐层位置标记。这个标签针对Ripple DFlash2调整conversion/base.py,让转换器按数据表示写入rope_pattern;影响限定在对应转换元数据,不能据此推断所有模型速度或质量提升。

    Ducter 0.0.56继续手机任务时工具怎样恢复,回复语言为何不再错位
    Ducter 0.0.56继续手机任务时工具怎样恢复,回复语言为何不再错位

    Ducter 0.0.56修复已结束手机任务续跑时的工具缺失,并避免点击其他Agent请求卡片后回复语言错位。

    Plannotator 0.28.65的账号限制和Inbox存储变化怎样理解
    Plannotator 0.28.65的账号限制和Inbox存储变化怎样理解

    Plannotator 0.28.65收紧Tailscale所有者账号访问、迁回文件存储,Take back只适用于尚未交付回复。

    WorkBuddy怎么用API接口?有开发文档吗
    WorkBuddy怎么用API接口?有开发文档吗

    WorkBuddy 目前没有面向普通用户的公开 REST API 接口文档,扩展与集成走四条官方路径:接入 MCP 服务扩展工具能力、用连接器打通外部应用(支持公共/个人授权)、编写技能(Skill)与专家包定制工作流、在开放平台发布 Buddy 应用。另支持接入 OpenAI 兼容的自定义模型。本文含 4 张真实界面截图并如实说明现状。

    Google Workspace MCP OAuth 2.0迁移节点已过,旧客户端、普通REST与服务账户分别适用什么规则
    Google Workspace MCP OAuth 2.0迁移节点已过,旧客户端、普通REST与服务账户分别适用什么规则

    解释Google Workspace MCP 11月11日与12日的agentic OAuth客户端迁移节点,区分普通REST应用、混合客户端、预览资格、用户权限和服务账户、Apps Script边界。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。