一次性 Ticket:跨站单点登录的安全交换
令牌绝不进 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 应用兑换。
回调页的处理顺序不能换
- 先比对
state(与发起时存入会话的值),不一致立即拒绝 —— 这是防 CSRF 的关键; - 取出
ticket,由服务端调换票接口,别把client_secret放进前端; - 换到令牌后写业务站自己的会话,然后 302 到干净地址,清掉 URL 里的 ticket;
- 需要浏览器也持有认证中心会话时,前端凭 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'。登录页是全站最该收紧的一页。