设计目标
信源接入涉及身份、权限、路径和记录,如果全部压在一个系统里,改一处就可能影响其他环节。网关按职责拆分模块,让接入校验、权限判断、路径选择和记录各自独立,出现问题时也能定位到具体环节。
模块之间只传递必要信息:请求标识、调用主体、路由信息、鉴权结论和处理结果。业务正文在转发过程中不落地,审计模块只取所需字段。
模块划分以职责清晰为目标,让每个环节只做一件事。入口不选择信源,鉴权不处理业务,审计不参与判断,出现异常时可以快速判断问题落在哪一段。
模块职责
六个模块各管一段,边界清晰。理解这些边界,有助于在接入时判断问题应当由谁处理。
模块之间不交叉判断,配置调整也只影响对应环节。例如调整路由条件不会改变凭据校验规则,更换凭据也不会改变信源选择逻辑。
| 模块 | 职责 | 不处理 |
|---|---|---|
| 入口 | 接收请求、校验格式、限制请求体大小 | 不选择信源 |
| 策略 | 匹配路由、区域和调用方条件 | 不修改信源内容 |
| 鉴权 | 校验凭据、租户和权限范围 | 不处理业务逻辑 |
| 调度 | 选择信源、处理失败切换 | 不保存业务正文 |
| 审计 | 记录请求、结果和错误 | 不参与权限判断 |
| 出口 | 转发请求、接收信源响应 | 不缓存业务正文 |
请求顺序
请求按固定顺序推进,前一步的结论决定后一步是否执行。顺序稳定带来可预期的排查路径:在入口失败,先看格式和大小;在鉴权失败,先看凭据和授权范围;在调度失败,先看路由键和信源状态。
审计在请求结束后写入,不阻塞转发,也不改变返回结果。记录内容与请求编号绑定,调用方、信源和结果可以按编号串联核对。
- 入口校验请求格式和大小。
- 策略匹配路由和调用方条件。
- 鉴权校验凭据和权限范围。
- 调度选择信源并转发。
- 审计写入请求和结果。
旁路与串联
旁路部署只复制请求用于审计,不改变业务链路。请求是否经过网关不由网关决定,因此旁路适合先观察调用情况,不适合承担拒绝职责。
串联部署由网关转发请求,可以执行拒绝和切换。调用方只面向网关地址,权限判断和路径选择在转发前完成,审计记录与业务结果一一对应。
网络位置决定安全边界。旁路通常部署在旁侧链路,串联部署在业务必经路径上;同一企业可以在不同链路上采用不同模式,分别管理。
架构边界
网关不保存业务正文,不修改信源内容,也不判断信源返回的业务结果。信源超时或返回可识别错误时,调度模块按策略处理,切换只影响本次请求。
网关负责单次请求的路径选择与切换,节点与路径规则以接入时确认的配置为准。
接入时会把模块边界和调用路径一并说明,避免把信源业务问题与网关转发问题混在一起排查。