oauth回调接口必须严格校验code、state、redirect_uri：state需加密签名双向绑定防csrf；code须一次性限时使用并立即失效；redirect_uri要全路径精确匹配白名单；多租户场景下由路由中间件统一剥离校验后透传。
OAuth回调接口的路由参数不是拿来就用的，必须经过安全提取和严格校验。核心在于：不能信任任何来自第三方的输入，所有参数都要“先验证、再使用”，尤其是code、state、redirect_uri这三个关键字段。
state参数必须双向绑定且不可预测
它不只是防CSRF的随机字符串，更是业务状态的安全载体。提取时不能直接解码明文，而应采用加密+签名方式封装业务数据（比如用户原始跳转路径或订单ID）。校验时需同时完成两件事：验证签名有效性，再比对本地会话中存储的原始state值。若任一环节失败，立即拒绝请求并记录告警。
- 生成时用HMAC-SHA256对业务数据签名，再Base64Url编码
- 回调时先校验签名，再解密还原原始数据
- 严禁将state作为URL参数透出前端或写入日志
code参数需一次性消费且时效严格
授权码是临时票据，本质是一次性口令。提取后必须立即用于换取access_token，且不能缓存、不能重放。校验逻辑要嵌入时间窗口控制（通常5分钟）和使用次数限制（仅允许调用一次token接口）。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 收到code后立刻记录时间戳和关联session ID
- 调用/token接口前检查是否超时或已被使用
- 成功换取token后，立即将该code标记为已失效
redirect_uri必须精确匹配且来源可信
这个参数决定授权服务器把用户送回哪里，一旦被篡改，就可能造成开放重定向或token劫持。校验不能只看域名，而要完整比对协议、主机、端口、路径，甚至查询参数（若业务要求）。
- 从数据库或配置中心读取白名单URI，而非硬编码在代码里
- 对比时使用标准URL解析器，避免手动字符串截断引发绕过
- 生产环境禁止使用localhost或127.0.0.1作为回调地址
动态路由分发场景下的参数隔离
当多个第三方服务共用同一回调入口（如通过OpenClaw-Codex-OAuth-Routing-Kit统一接入），路由层需提前剥离并校验通用参数，再将干净的code/state转发给下游业务服务。此时，路由中间件本身不处理token交换，只做参数合法性过滤和目标服务分发。
- 路由层只解析query string，不读取body
- 校验通过后，以HTTP Header方式透传code和state，避免二次拼接风险
- 下游服务不再重复校验redirect_uri，由路由层统一管控
