← Back to all notes

一次性 Ticket:跨站单点登录的安全交换

Published By 半盏灯 Last updated

  • Go
  • SSO
  • OAuth
  • 安全

令牌绝不进 URL

跨站登录的流程是「业务站 → 认证中心 → 业务站」。最省事的写法是把 access token 拼进回调地址,但 URL 会进入浏览器历史、网关访问日志、Referer 头与前端埋点,等同于把令牌公开发布一次。

稳妥的做法是浏览器只带一个 ticket:短时、随机、一次性、与具体应用绑定;真正的双令牌由业务站服务端到服务端换取。

业务站 302 → 授权端点?client_id&redirect_uri&state
认证中心    → 校验白名单 / 登录态 → 写 ticket(30s)
           → 302 回 redirect_uri?ticket=xxx&state=xxx
业务站服务端 → 服务端换票接口(client_secret + ticket)→ access + refresh

令牌从不出现在 URL 里,这是整个流程里最不可让步的一条。

授权入口的四道校验

参数 必填 校验内容
client_id 是 接入应用是否存在、状态是否正常
redirect_uri 是 与应用登记的回调地址精确匹配
state 建议 业务站生成并存入会话,回调时原样回传
scope 否 必须落在应用允许的范围集合内

回调白名单不做前缀匹配、不做任意子域通配,也不允许「校验后再拼接路径」—— 这几种宽松写法都会变成开放重定向。prompt=none 支持静默模式:未登录时直接返回 401 而不跳登录页,适合前端探活。

GETDEL:一次性消费是缓存的活

raw, err := cache.GetDel(ctx, "ticket:"+id).Bytes()

GETDEL 把「读 + 删」合成一个原子操作,并发兑换同一 ticket 时只有一个请求能拿到内容。ticket 的 TTL 建议 30s,足够完成一次跳转,又不足以被人捡漏。

错误类型 含义 处理
票据无效或已过期 ticket 已被消费或超时 重新走授权流程
应用凭据错误 / 票据归属不符 密钥不对,或 ticket 属于另一个应用 核对 client_id 与密钥
回调地址不在白名单 与登记值不一致 补登记(精确匹配)
缓存不可用 一次性票据依赖共享缓存 启用缓存

最后一条是刻意的 fail-closed:缓存不可用时不能退化成「无状态、可重放」的流程。client_secret 只在创建应用时返回一次,库里存哈希;ticket 本身也绑定 client_id,A 应用拿到的票不能交给 B 应用兑换。

回调页的处理顺序不能换

  1. 先比对 state(与发起时存入会话的值),不一致立即拒绝 —— 这是防 CSRF 的关键;
  2. 取出 ticket,由服务端调换票接口,别把 client_secret 放进前端;
  3. 换到令牌后写业务站自己的会话,然后 302 到干净地址,清掉 URL 里的 ticket;
  4. 需要浏览器也持有认证中心会话时,前端凭 HttpOnly Cookie 刷新取 access token,存内存,不写 localStorage。
curl -s -X POST https://sso.example.com/token \
  -H 'Content-Type: application/json' \
  -d '{"grant_type":"ticket","client_id":"site-a",
       "client_secret":"<只保存一次的应用密钥>","ticket":"回调地址里带回来的 ticket"}'

换票响应里通常给 expires_in 与 refresh_expires_in(分别对应短、长两个有效期),业务站必须把新的 refresh 覆盖旧值 —— 它是轮换的。

别把登录票据和 OAuth state 混为一谈

登录 ticket 第三方 OAuth state
保护对象 一次应用间登录交换 第三方授权回调流程
建议 TTL 30s 10m
携带什么 已登录身份 + 应用绑定 发起方上下文(渠道、跳转目标)
消费方式 缓存 GETDEL 缓存 GETDEL,同一套一次性语义

两者都用 GETDEL,但承载的语义完全不同。第三方回调不带任何令牌跳回落地页,前端再凭 Cookie 刷新取令牌。回调时还应重新检查用户状态与接入方策略,不能只依赖几分钟前那次授权时的状态快照。

统一登录页值得单独加一层保护:access token 只放内存、refresh 放 HttpOnly Cookie,并配 Content-Security-Policy: default-src 'none'; script-src 'self'。登录页是全站最该收紧的一页。