OAuth2 授权码流程 · 动画讲解

一个生活场景讲透 OAuth2:阿珍想用第三方「印图 App」打印自己云相册里的照片,但又不想把账号密码交给它。看四位主角如何用「授权码 + 双令牌」把这件事安全地办成——包括令牌过期后如何刷新令牌、用户如何撤销授权。按播放,就像看视频一样往下走;也可以点任意一步直接跳过去看。

先打个比方OAuth2 就像酒店房卡:你不会把家门钥匙交给代客泊车的人,而是去前台办一张限时、限楼层的临时卡。密码是「家门钥匙」,永远不离手;令牌就是那张随时能作废的「临时房卡」。
开场 场景:阿珍的手机 · 云相册照片打印
阿珍
用户 · 资源所有者
照片是她的,密码只在她手里
Resource Owner
印图 App
第三方客户端
想访问照片,但不该知道密码
Client
账号中心
授权服务器
验明身份、发放授权码与令牌
Authorization Server
云相册 API
资源服务器
只认令牌,令牌对了才给照片
Resource Server
📦
点击下方「▶ 播放」开始。

序为什么不能直接把密码给 App?

快捷模拟:

全流程目录 点任意一步跳转,动画会演到那一步

    令牌钱包 跟着动画看三张「证件」的状态变化

    🎫 授权码 Authorization Code未发放
    code = —
    一次性临时凭证:寿命约 10 分钟,只能用一次,用完即焚。
    🪪 访问令牌 Access Token未发放
    access_token = —
    干活时出示的通行证:寿命短(示例 1 小时),丢了损失也有限。
    ♻️ 刷新令牌 Refresh Token未发放
    refresh_token = —
    续证专用:只交给账号中心换新通行证,绝不拿去访问资源;寿命长(示例 30 天),可被撤销。

    这一步在「说什么」 对应的真实请求(简化)

    
            

      AUTHORIZATION CODE为什么先发「码」,不直接发令牌?

      令牌如果直接经浏览器回传,会暴露在地址栏、历史记录和日志里。先给一张短命的一次性授权码,真正的令牌走后端直连通道领取——浏览器只当「快递员」,不接触贵重物品。

      SCOPE · STATE · PKCE三个容易忽略的安全细节

      scope 限定权限范围(如只读照片,不能删);state 是防伪随机串,防止有人伪造授权回调;PKCE 靠一对参数证明「换令牌的人就是发起授权的人」:code_verifier 是 App 每次授权时在本地随机生成的秘密原文(43–128 个字符),只留在 App 本地、到换令牌时才发送;code_challenge 是它的哈希指纹——BASE64URL(SHA-256(code_verifier)),在发起授权时就先发给账号中心存好。截获授权码的人没有 verifier 原文,哈希对不上,照样换不到令牌。

      REFRESH TOKEN ROTATION刷新时为什么常「换新续证」?

      很多服务在每次刷新时同时发一个新的 refresh_token 并作废旧的,这叫轮换。一旦发现同一个旧刷新令牌被用两次,说明可能被盗,整条令牌链会被立即吊销。

      OAuth 2.0 vs 2.1 对照:流程没变,规矩变严了

      2.1 仍为 IETF 草案 · 尚未正式发布为 RFC

      OAuth 2.1 不是一套新协议,而是把 OAuth 2.0 十几年的补丁打包成一份「合订本」:合并了核心规范(RFC 6749)、令牌使用(6750)、PKCE(7636)、令牌撤销(7009)、授权服务器元数据(8414)、动态客户端注册(7591)和安全最佳实践(RFC 9700)。上面动画演的授权码主线完全不变,变的是下面这些做法从「可选 / 允许」变成了「必填 / 禁止」。

      和本页动画的对应:第 1 步和第 4 步演的 PKCE,在 2.0 里只是扩展,在 2.1 里已经是全员必填——所以这支动画的主线其实已经是按 2.1 的写法在演了。
      PKCE 防拦截code_verifier / code_challenge可选 → 全员必填
      OAUTH 2.0

      PKCE 是单独的扩展规范(RFC 7636),本体里没有。主要推荐给藏不住 client_secret 的公开客户端(手机 App、单页应用),机密客户端可以省。

      OAUTH 2.1

      授权码模式对所有客户端都必须用 PKCE,包括能保管 secret 的机密客户端。这是 2.1 与 2.0 最实际的区别。

      隐式模式Implicit · response_type=token直接删除
      OAUTH 2.0

      允许令牌直接从授权端点经浏览器地址栏回传给应用,当年是为没有后端的单页应用准备的简化路径。

      OAUTH 2.1

      不再允许。令牌走地址栏会暴露在历史记录、日志和 Referer 里,统一改走授权码模式 + PKCE。

      密码模式ROPC · Resource Owner Password Credentials直接删除
      OAUTH 2.0

      允许应用直接收集用户的账号密码,再拿密码去换令牌——省事,但等于又回到了「把密码交给 App」。

      OAUTH 2.1

      移除。用户密码只能出现在授权服务器自己的登录页上(如本页第 2 步),第三方应用永远不经手。

      刷新令牌Refresh Token收紧 · 必须防重放
      OAUTH 2.0

      刷新令牌可以长期反复使用,轮换只是可选做法。旧令牌被盗后,可能在有效期内被一直续命。

      OAUTH 2.1

      对公开客户端必须二选一:要么与发送方绑定(如 DPoP / mTLS,别人拿到也用不了),要么一次性使用、用后轮换——旧的被重放就能发现并吊销整条链。本页第 8 步演的就是轮换。

      回调地址redirect_uri模糊匹配 → 精确匹配
      OAUTH 2.0

      实践中常见通配、前缀或模糊匹配,配置方便,但给授权码被劫持到假地址留了口子。

      OAUTH 2.1

      必须与预注册地址逐字符完全一致,不允许通配或模糊匹配。对不上就直接拒绝,不发码。

      访问令牌怎么传Access Token Transport禁止放 URL 里
      OAUTH 2.0

      除了请求头,也允许把 access_token 放在 URL 查询串里(如 ?access_token=…)或表单体里传递。

      OAUTH 2.1

      不许放在 URL 查询串里,只能走 Authorization: Bearer 头(或表单体)。因为 URL 会进浏览器历史和服务器日志,等于把通行证到处复印。本页第 6 步用的就是请求头。

      一句话记住 2.1:流程还是那条流程,只是把「能跑通但不安全」的老选项逐个关掉。虽然它还没正式成为 RFC,但里面的要求基本就是现行安全最佳实践本身,主流授权服务器大多已按 2.1 执行——新项目直接按 2.1 写,是稳妥选择,不用等它正式发布。

      看完记住这四句,就懂了 OAuth2