凭据、撤销与安全重试
令牌、断线与重试需要一起设计。请求失败不代表企业没有处理;同一个业务重试也不意味着所有认证字段都应原样重用。
分清三类凭据
正式 1.0 使用标准 OAuth 名称:refresh token 是登录得到的长期凭据,只应发往该 issuer 的 token endpoint;access token 是短期账号凭据,可按 issuer 选择绑定 DPoP;会话 JWT(Poppy-Session 头)是个人 Agent 为每个请求新签的一次性证明,绑定请求方法与地址,携带 access token 时还绑定其哈希,复制到别的请求无法使用。
会话 JWT 用委托密钥签署:客户端元数据 jwks_uri 里的公钥只为委托(不超过 24 小时)和 client assertion 签名,委托再担保一个只能代表单个用户的委托密钥。泄漏一把委托密钥只暴露一个用户在一家企业,也让元数据公钥不暴露用户与哪些企业往来。client assertion 的有效期至多 5 分钟。
三类凭据都不能进入模型上下文、对话、URL 或日志——这是正式 1.0 的强制要求。注销、断开 Agent 关联和会话结束具有不同效果:账号登出是撤销全部 refresh token;企业侧断开会让后续刷新失败,会话继续以未登录方式工作。
同一个业务,新的认证证明
官方指南建议:支持 Idempotency-Key 的写 API,在同一请求重试时复用业务幂等键;每次重试创建新的 DPoP proof 与新的会话 JWT,重试 token 请求时创建新的 client assertion。旧 jti 可能被判为重放;刷新必须使用取得 refresh token 时的同一 DPoP 密钥。幂等键与重放标识承担不同职责。
收到 429 时遵循 Retry-After;其他可重试故障使用有上限的指数退避和抖动。不要在授权失败后无限重试,也不要把超时直接显示成确定未执行。
日志边界
在进入日志与追踪系统之前脱敏 Authorization、Poppy-Session、DPoP、Cookie 及凭据字段。记录相关阶段、错误分类与不含秘密的关联标识,避免把完整请求复制到模型排障上下文。