实施前的准备
准备阶段的目标是把未知项提前暴露。管控目标、调用方清单、信源端点和责任人四项不清楚时,后续配置容易反复。准备材料由业务、网络、平台和安全共同确认,不以单一部门的理解代替。
- 明确管控目标:只观察调用,还是需要统一入口并执行拒绝与切换。
- 列出调用方、信源和负责部门,确认每类请求的归属。
- 确认信源端点、协议和访问方式,避免联调阶段才发现不可达。
- 指定对接人,覆盖网络、平台、安全和业务系统。
- 准备变更与回退方案,涉及链路的调整按内部变更流程执行。
- 确认日志交付范围和保管方式,避免上线后再补约定。
- 确认业务高峰时段,避免在高峰执行链路切换。
- 明确故障联系人及其替补,保证问题能够及时分流。
- 确认变更窗口和通知范围,保证相关方知晓时间安排。
现场信息核对
现场信息以书面确认为准。同一项信息由多个部门提供时,先核对是否一致,再写入实施记录。信息变更时更新记录并通知相关方,避免配置与现场脱节。
| 信息项 | 用途 | 提供方 |
|---|---|---|
| 网络位置 | 判断旁路或串联 | 网络负责人 |
| 入口地址 | 调用方访问网关 | 平台运维 |
| 信源端点 | 确定转发目标 | 信源方 |
| 调用方清单 | 配置凭据与权限 | 业务系统负责人 |
| 日志要求 | 确定记录交付与保管 | 安全与审计 |
| 时间同步 | 保证审计记录对齐 | 平台运维 |
模式与节点确定
旁路复制请求用于审计,不改变现有业务链路,适合先观察调用结构;串联由网关转发请求,可以执行鉴权、拒绝、限流和故障切换,适合需要统一入口的场景。两种模式可以在不同链路上并存,关键链路串联,非关键链路先旁路观察。
节点数量按请求分布和连续性要求确定。多节点需要统一配置来源和凭据管理,节点之间不共享业务正文。入口分配方式在部署时确定,单节点故障由入口切换,调用方不需要感知具体节点。旁路模式不保证请求一定经过网关,安全判断以串联模式为准。
模式确定后先做小范围验证,确认网关行为与预期一致,再扩大链路。节点数量增加不改变旁路与串联的安全边界,旁路仍以观察为主,拒绝和切换由串联承担。
配置与联调
配置按租户、信源和用途分别进行,避免一套配置覆盖全部场景。联调使用少量真实请求,覆盖成功、拒绝和超时几类结果,确认网关行为与预期一致后再扩大。
联调通过后再进入上线观察。未通过项记录在案,涉及网络或凭据的,先修正再复测,不带问题扩大范围。联调记录由参与方共同确认,作为上线前的检查依据。
- 按租户和用途签发调用凭据,按信源配置信源凭据。
- 配置路由键、租户、信源状态和权限范围。
- 设置授权期限和字段范围,确认拒绝条件。
- 用少量请求验证转发、鉴权和审计记录。
- 核对成功返回、拒绝记录和故障码是否符合预期。
- 记录联调结果和未通过项,作为上线前的检查依据。
上线与观察
上线以可控范围为起点,先接入少量调用方或非关键链路。观察期关注请求结果、错误码、切换记录和审计完整性,发现异常先回退到原链路,再定位原因。
- 选择少量调用方或非关键链路先行接入。
- 观察请求结果、错误码和切换记录,核对与预期是否一致。
- 确认调用方已更新入口地址和凭据配置。
- 逐步扩大接入范围,保留原链路的回退配置。
- 观察期结束后整理问题清单,明确后续维护责任。
验收与交接
验收以可复核的记录为依据,不以口头确认结束。每项验收完成后留存结果,交接时把配置、凭据、日志和回退步骤一并移交,并说明责任边界。
交接完成后,配置变更仍按约定流程执行。验收记录与回退步骤一并归档,后续排查时可以对照当时配置。
| 验收项 | 通过标准 | 记录 |
|---|---|---|
| 连通性 | 调用方、网关、信源路径可达 | 连通性检查记录 |
| 鉴权 | 无效凭据被拒绝 | 拒绝记录与错误码 |
| 转发 | 请求到达目标信源 | 请求编号与响应 |
| 审计 | 访问与拒绝均有记录 | 审计查询结果 |
| 回退 | 原链路恢复步骤可执行 | 回退步骤确认 |
常见问题
- 可以先用旁路再改串联吗
- 可以。先观察调用结构,再在关键链路改为串联。模式调整涉及网络配置,按变更流程推进。
- 多节点需要共享业务正文吗
- 不需要。节点统一配置和凭据管理,业务正文不在节点之间共享。
- 联调需要准备多少请求
- 按调用类型覆盖成功、拒绝和超时几类情形,数量以能验证路径和记录为准。
- 上线后发现配置不一致怎么办
- 先暂停新增接入,核对节点配置和凭据范围,统一后再扩大范围。
- 验收由谁确认
- 由业务、网络、平台和安全按各自范围确认,结果写入同一份验收记录。
- 回退需要满足什么条件
- 原链路仍可用、调用方配置可恢复、凭据与路由记录完整。回退后核对调用结果,再定位问题。