凭据、撤销与安全重试
凭据、撤销与安全重试
令牌、断线与重试需要一起设计。请求失败不代表企业没有处理;同一个业务重试也不意味着所有认证字段都应原样重用。
分开保存两类令牌
Session Token 是短期访问凭据,Account Token 是用于取得已登录 Session Token 的长期 OAuth refresh token。Account Token 只应发往适用的 token endpoint,不能放进模型上下文、对话、URL 或日志。
Session Token 的密钥绑定与 DPoP 按规范实现;不要因为知道 token 字符串就认为任何调用者都能合法使用。注销、断开 Agent 关联和会话结束具有不同效果,要按官方生命周期处理。
同一个业务,新的认证证明
官方指南建议:支持 Idempotency-Key 的写 API,在同一请求重试时复用业务幂等键;每次重试创建新的 DPoP proof,重试 token 请求时创建新的 assertion。旧 jti 可能被判为重放。两种标识承担不同职责。
收到 429 时遵循 Retry-After;其他可重试故障使用有上限的指数退避和抖动。不要在授权失败后无限重试,也不要把超时直接显示成确定未执行。
日志边界
在进入日志与追踪系统之前脱敏 Authorization、DPoP、Cookie 及凭据字段。记录相关阶段、错误分类与不含秘密的关联标识,避免把完整请求复制到模型排障上下文。
最后更新于