
转发目标
信源接入后,调用方关心的是请求能否到达可用的信源,企业关心的是请求是否在授权范围内。网关把这两个问题放在同一次判断里:先确认调用方可以访问什么,再决定请求送往哪里。
路径选择不影响信源登记。信源状态变化、凭据范围调整或部署模式切换,都会在下次请求时生效,不需要调用方改写业务代码。
信源登记、凭据范围和路由条件共同决定候选集合。候选集合之外的请求不会被尝试,避免把请求送到未授权或未登记的信源。
调用方按路由键表达意图,网关负责把意图落实到具体信源。信源增减时更新登记与路由即可,调用方通常无需改动。
路由条件
条件按顺序生效,任一条件不满足都会缩小候选范围。
条件之间是逐层收窄的关系,不满足任一条件即停止匹配。这样可以在转发前排除大部分不合适的目标,减少无效调用。
| 条件 | 说明 | 作用 |
|---|---|---|
| 路由键 | 信源或能力的命名空间 | 确定候选信源 |
| 租户 | 调用方所属租户 | 隔离配置和记录 |
| 凭据范围 | 凭据可访问的信源和字段 | 过滤未授权信源 |
| 部署模式 | 旁路只审计,串联可拒绝和切换 | 决定是否改变业务链路 |
| 信源状态 | 可用、受限、维护、不可用 | 排除不可用信源 |
转发流程
转发过程从读取请求信息开始,到写入审计记录结束,中间不修改业务正文。
流程在网关内部完成,调用方只看到最终结果。转发过程中的判断结论写入审计记录,用于核对路径是否符合预期。
- 读取路由键、租户和凭据范围。
- 按租户隔离配置和候选信源。
- 按凭据范围过滤未授权信源。
- 按部署模式决定是否转发。
- 选择信源并写入审计记录。
失败切换
信源超时或返回可识别错误时,按策略选择备选信源。切换只影响本次请求,不修改信源登记。
没有备选信源时返回无可用信源错误,不循环尝试,不降级到未授权信源。切换过程写入审计记录,便于事后核对调度是否符合预期。
切换策略按信源状态和业务约定设置,不改变信源登记,也不扩大到未授权范围。频繁切换应视为信源不稳定的信号,需要与信源方核对。
观察与调整
转发规则上线后,可通过审计记录观察实际走向,再决定是否调整。
规则调整前先看记录,确认调整依据;调整后继续观察,避免一次改动引入新的路径问题。
- 查看切换记录,判断信源状态是否稳定。
- 按调用方和信源核对路径,确认没有越权访问。
- 路由键命名保持稳定,变更时同步调用方。
- 新增信源先登记并验证端点,再纳入候选范围。