IAM 入门:一次登录,如何连接终端与网页?

从 Google 登录出发,理解身份、权限、会话与退出登录

November 3, 2026·6 min read·Yimin
#IAM#JWT#OAuth#系统设计#身份认证

从 Google 登录、终端授权到打开后台网页,用一条完整链路理解 IAM 如何管理身份、权限和会话。

🎯 为什么需要 IAM?

一个工具平台可能同时提供网页控制台、CLI 和多个后台。用户希望登录一次就能方便地使用它们;管理员则需要控制谁能进入哪个工具,并在退出或权限变化时收回访问。这正是 IAM 要管理的事情。

比如,你在终端发起登录,在浏览器完成 Google 身份验证并允许该终端登录,随后让 CLI 打开日志后台。浏览器弹出来,已经可以查数据,没有要求再输入后台密码。

这段体验背后,有几个值得拆开的问题:

  • Google 登录的结果,怎样变成了 CLI 的访问凭据?
  • JWT 明明在终端里,浏览器怎么就登录了?
  • Cookie 和 JWT 是两套互斥的认证方式吗?
  • 点了退出,再打开为什么有时还进得去?

这些问题牵涉到不同层面的事情。先把它们拆开,再串起来。

本文使用抽象的控制台、CLI 和日志工具说明一种设计,不对应某家公司的部署,也不提供实际环境的地址、凭据或配置步骤。


🧠 IAM、JWT、Cookie,分别在解决什么?

IAM 是 Identity and Access Management,也就是身份与访问管理。 它关心三件事:你是谁、允许做什么,以及何时收回访问。

IAM 是一个成熟的系统类别,不是一份统一的通信协议。云平台中的身份与权限管理就是它的常见应用。AWS 的 IAM 介绍也分别讨论了身份认证与访问授权。

下面这些词经常一起出现,但不在同一个层面:

名称主要回答的问题
IAM整套身份、权限和会话由谁管理?
OAuth 2.0客户端如何获得访问资源的授权?
OpenID Connect(OIDC)客户端如何在 OAuth 2.0 的基础上核验用户登录身份?
JWT如何用一种可携带声明、可做签名校验的格式表示凭据?
Cookie浏览器怎样保存数据,并在匹配的请求中自动携带它?
RBAC如何通过角色组织用户的权限?

OIDC 是具体的身份协议;一个系统使用了 JWT、浏览器跳转或 PKCE,并不能单凭这些特征就宣称完整兼容 OIDC。OIDC Core定义了协议需要满足的具体要求。

理解后面流程时,尤其要记住:JWT 是凭据的表示格式,Cookie 是浏览器保存和发送数据的机制。 Cookie 里可以装 JWT,也可以装一个没有可读内容的随机字符串。

在本文的设计中,CLI 使用自己的访问凭据;浏览器访问某个后台时,Cookie 中装的是一个随机会话 Token。服务端通过它找到会话记录,判断是否允许访问。


⚙️ 第一步:Google 登录怎样授权给 CLI?

Google 帮平台确认“你是谁”,平台再决定是否允许这个 CLI 使用你的平台账号。 CLI 最后拿到的是平台签发的凭据,整个流程不需要把 Google 密码交给 CLI。

这里分为两段:先让浏览器登录平台,再让已登录的用户批准终端。

第一段:浏览器登录平台
用户 → Google 身份验证 → 平台核验身份 → 建立平台浏览器会话

第二段:批准 CLI 登录
已登录用户 → 允许此终端 → 平台授权码 → CLI 兑换独立的平台凭据

1. CLI 创建一笔等待批准的请求

CLI 准备一个随机秘密,暂时只留在本机,把对应的校验信息提交给平台,然后打开系统浏览器中的终端授权页。此时 CLI 仍在等待,还没有获得用户的访问资格。

2. 用户在浏览器里完成 Google 登录

如果浏览器尚未登录平台,用户先选择 Google 登录,在 Google 页面完成账号选择、密码或 Passkey 等验证。

采用授权码流程时,Google 把临时授权结果经浏览器送回平台注册的回调地址。平台后端完成兑换并核验身份信息,把经验证的 Google 账号标识关联到平台用户,再建立平台自己的浏览器会话。

此时浏览器已经登录平台,CLI 仍在等待批准。 如果浏览器原本就有有效的平台登录会话,这一段可以跳过。

Google 账号证明了用户身份,平台仍需根据自己的用户状态与权限规则决定是否允许访问。拥有 Google 账号,并不等于拥有该平台的使用权限。

3. 用户明确允许这个终端

平台授权页展示当前终端的登录请求。用户确认“允许此终端”后,平台才为这笔请求签发一个短效、一次性的授权码。

两次授权面向不同对象:

环节用户允许什么
Google 登录与相关授权允许平台获取所请求的身份信息,用来确认用户身份
平台终端授权允许当前这笔 CLI 登录请求使用自己的平台账号

Google 登录成功,不应自动批准其他终端发起的请求。平台需要把用户的确认与具体的 CLI 请求关联起来。

4. 浏览器把平台授权码送回 CLI

CLI 临时监听一个只供本机访问的回环地址。平台引导浏览器跳转到该地址,把授权码交给正在等待的 CLI。

这里有两个不同的回调:Google 的结果回到平台,平台批准终端的结果再回到 CLI。 两段使用的授权码也不同。

5. CLI 兑换自己的平台凭据

CLI 将收到的授权码和最初保留的秘密提交给平台。平台校验请求已经批准、授权码未过期且未被消费,并确认秘密匹配后,创建独立的 CLI 会话,签发平台访问凭据。

CLI 保存这份凭据,后续直接用它请求平台 API。它可以是 JWT,也可以采用其他凭据形式。

CLI                 浏览器                    平台
准备随机秘密
创建授权请求 ───────────────────────────────→ 记录请求
打开授权页 ────────→ 若未登录,先经 Google 登录平台
                    确认允许此终端 ─────────→ 批准请求
接收本机回调 ←────── 携带平台的一次性授权码
授权码 + 秘密 ─────────────────────────────→ 校验
保存 CLI 凭据 ←──────────────────────────── 创建独立会话

Google 的登录状态、平台的浏览器会话和平台的 CLI 会话有各自的生命周期。退出其中一个,不会天然清除另外两个;需要平台明确设计关联和撤销规则。

浏览器为什么能“回到本机”?

这叫 loopback callback,回环回调。

真正访问本机回调地址的是你电脑上的浏览器。身份服务先向浏览器返回重定向,浏览器再把授权码送给同一台电脑上的 CLI。因此,这一步不需要让远端身份服务直接连进你的电脑。

RFC 8252介绍了原生应用使用外部浏览器和回环回调的方式。回调地址、监听范围、请求有效期和授权码消费都需要按协议约束处理,不能只做到“有个地址能接收参数”。

PKCE 又保护了什么?

CLI 在开始时保留随机的 verifier,把它经过转换得到的 challenge 随授权请求提交。使用 S256 时,这个转换包含 SHA-256 和相应编码。

兑换授权码时,身份服务检查提交的 verifier 是否对应原来的 challenge。仅拿到授权码,而没有匹配的 verifier,不能完成这次兑换。 这是 PKCE 的主要用途,详见 RFC 7636。

它不能代替其他检查:还需要关联原始请求、校验回调与有效期,并防止授权码重复消费。常见的 state 参数用于关联请求、降低登录流程被混淆的风险,与 verifier 承担不同职责。

登录完成后,浏览器会话和 CLI 会话可以属于同一个用户,但拥有不同的会话 ID,分别到期、分别撤销。


⚙️ 第二步:CLI 怎样把访问资格交给网页?

CLI 登录成功,只代表 CLI 有自己的凭据。浏览器打开一个网址,并不会自动读取 CLI 的凭据文件,也不会自动附上 CLI 的 Authorization 请求头。

可以在两者之间使用一张短效、一次性的交接票。

先申请一张用途很窄的票

CLI 用自己的登录凭据,向身份服务申请进入“日志后台”。服务端检查当前登录和对应管理权限,通过后生成一张随机票。

这张票关联的信息可以包括:

信息目的
用户这是谁申请的访问?
来源会话 ID是哪次 CLI 或浏览器登录授予的?
指定服务只能进入日志后台,还是其他工具?
到期时间允许多长的交接窗口?
消费状态是否已经兑换过?

票本身也是秘密凭据。它的安全性需要来自足够的随机性、短有效期、服务绑定和服务端原子消费,不能只靠名字叫“一次性”。服务端可保存票的哈希,用于匹配兑换请求。

再由目标站把票兑换成 Cookie

CLI 打开目标站的交接链接。浏览器到达以后,把票提交给目标站;服务端验证并消费票,创建一个范围更窄的网页会话,再通过 Set-Cookie 响应头告诉浏览器保存它。

CLI 的登录凭据
      │ 申请指定服务的访问
      ▼
短效、只能兑换一次的票
      │ 系统浏览器打开交接链接
      ▼
目标站验证并消费票
      │ Set-Cookie
      ▼
浏览器持有该站网页会话

一种交接方式是把票暂放在 URL fragment,也就是 # 后面的部分。首次 HTTP 请求不会携带 fragment,由交接页读取、清掉地址中的票,再向同域提交兑换请求。

fragment 并不负责保密。 浏览器中的脚本仍能读取它,因此交接页应尽量简单,避免第三方脚本、遥测和错误上报把票带出去。它的价值是减少票直接进入请求 URL、常规访问日志等位置的机会。

票消费成功以后,浏览器后续发送的是网页会话 Token。根据 Set-Cookie 的浏览器语义,可以用 Secure 限定 HTTPS 发送、用 HttpOnly 阻止页面脚本直接读取,并设置合适的 SameSite 与作用范围。这些属性需要配合服务端授权和 CSRF 防护,不能独立保证整个应用安全。

CLI 负责领票、打开浏览器;目标站服务器负责写入自己的 Cookie。 这就是两种客户端之间的连接点。


🏛️ 两种“码”,不要混成同一种东西

前面的流程出现了两次交接,但作用不同:

交接换到什么谁来兑换
浏览器批准 CLI 登录后的授权码CLI 自己的登录凭据持有 PKCE verifier 的 CLI
CLI 申请的单站网页交接票某个后台的网页会话接收交接的浏览器,经目标站兑换

第一段建立 CLI 身份;第二段把已有身份获准的某项访问能力交给网页。

后者可以是项目自己的内部交接协议。即使它也叫“换票”,也不能直接等同于某项标准 OAuth Token Exchange 协议,更不能把它的票当作通用登录凭据。

网页版控制台的“打开后台”按钮,则省去了 CLI 那个入口:它使用当前控制台登录凭据申请同一类单站票,之后仍然交给目标站兑换 Cookie。

CLI 登录会话 ──────→ 申请单站票 ──┐
                               ├──→ 目标站 Cookie → 后台访问
控制台浏览器会话 ──→ 申请单站票 ──┘

两种入口可以共用签票能力,但网页会话应记录自己由哪次登录授予。CLI 打开一个后台,也不必顺便把整个控制台登录到这个浏览器里。


🧠 后台自己的登录又是怎么完成的?

拿到网页 Cookie 后,请求首先到访问网关。网关核验网页会话、当前权限和来源登录,再访问后面的应用。

如果应用支持 OIDC 等登录集成,可以让它直接参与统一身份流程。对于暂时没有这种集成的工具,也可以由网关代办原生认证:向上游附上服务端持有的凭据,或者通过上游正式登录接口取得原生会话。

这时用户免去了重复输入后台密码,但网关仍然执行身份和权限检查。下游如果使用共享托管账号,原生应用看到的也是那个账号;个人身份关联需要在网关保留。如果需要应用原生的逐用户权限和审计,应优先评估它自身的身份集成能力。

这条访问边界还要求:

  • 上游应限制为预先配置的目标,不能变成任意地址代理。
  • 外部请求携带的身份头、上游密钥等,不能直接被信任。
  • 原生站点、其他端口和备用域名不能留下绕开身份检查的直达入口。
  • 静态资源、API、下载和 WebSocket 都要纳入访问控制范围。

这是一种应用访问设计。IAM 也可以由各应用直接集成,并不要求所有系统都采用同一个网关形态。


⏱️ 能访问多久,为什么退出以后还能进去?

先分别定义三种时长:CLI 登录的有效期、交接票的兑换窗口,以及网页会话的有效期。它们不需要相同。

在一种保守设计中,网页授权的到期时间可取“来源访问凭据的到期时间”与“签票时刻加网页会话上限”中的较早者。比如网页上限是 20 分钟,而签票凭据只剩 7 分钟,这次网页授权最多再持续约 7 分钟。这里的数字仅用于说明规则。

刷新页面是否续期,需要另外定义;短期会话不会因为用户仍在操作,就天然获得无限续期能力。

JWT 验签通过,是否代表没有退出?

不能只据此判断。

一个尚未到期、签名正确的 JWT,可能仍能通过离线校验。若希望退出后尽快收回访问,就需要可检查的服务端状态,例如登录会话记录、撤销状态或当前授权。本文采用来源会话绑定:网页会话记录它由哪次登录授予,每次请求重新判断该来源是否仍有效。

用户
 ├── 浏览器登录 A ──→ 从控制台打开的网页会话
 └── CLI 登录 B ────→ 从终端打开的网页会话

于是,“退出”要说明具体对象:

操作一种明确的退出语义
退出某个后台网页撤销该站当前网页会话,不自动退出 CLI 和控制台
退出控制台撤销浏览器登录 A,以及依赖 A 的网页授权
退出 CLI撤销终端登录 B,以及依赖 B 的网页授权
退出全部平台会话撤销该用户相关登录会话及其派生访问;外部身份提供方的登录另有生命周期

这里有个容易误判的情况:退出 CLI 后,旧网页授权已经失效,但控制台浏览器仍然登录。再次打开后台,可能经控制台重新签票,于是用户又直接进入。 这次进入使用了新的授权来源。

为了让主动退出符合直觉,可以在原生网页退出后保留一个明确的“已退出”标记,把用户送回服务列表,等待再次主动打开;自然过期则可以采用另一种重新授权策略。

关闭浏览器是否清掉 Cookie,还会受到 Cookie 类型和浏览器会话恢复行为影响,不能把“关窗口”当作可靠的服务端撤销。

对于 WebSocket 等长连接,建立连接时验权不够。周期复查、撤销通知或连接租约都可以用于收回访问;退出接口失败、身份服务不可用以及轮询间隔,也要纳入撤销生效时间的定义。


📝 把整条链路重新连起来

Google 帮助平台确认用户身份,平台建立浏览器会话;用户再批准具体的终端请求,CLI 通过受保护的授权码兑换获得独立会话。之后,CLI 或控制台可以申请短效单站票,由目标站兑换出自己的网页 Cookie。网关或原应用继续检查身份与权限,来源会话关系决定退出时需要收回哪些访问。

JWT 负责的只是其中一部分。要把系统做完整,还需要明确凭据放在哪里、允许访问什么、什么时候到期、如何撤销,以及用户重新打开页面时是否应获得新授权。

IAM 把这些规则组织起来,让同一个用户能够跨终端和网页使用服务,也让每次访问都有明确的权限边界与撤销方式。


📚 参考资料