凭据用途对照
凭据按用途分开管理,是为了让泄露影响停留在有限范围。调用方只持有调用凭据,信源凭据由网关保存和使用,管理凭据仅用于配置变更,三类凭据不互相替代。
凭据管理的关键在范围和期限。范围越小、期限越明确,泄露后的影响越容易控制。凭据不写入前端代码、公开仓库和日志,配置变更由授权人员操作。
| 凭据 | 使用场景 | 管理要求 |
|---|---|---|
| 调用凭据 | 调用方访问网关 | 按租户和用途签发,设置有效期 |
| 信源凭据 | 网关访问信源 | 按信源单独配置,不向调用方暴露 |
| 管理凭据 | 配置和变更 | 仅限授权人员使用,与调用凭据分开 |
权限判断的输入
判断在转发前完成,输入来自接入时登记的调用方、租户、信源和授权信息。任一项不满足时,网关直接拒绝,请求不会到达信源,拒绝原因写入审计记录。
判断按顺序执行,前一项不通过即停止,不进入后续校验。
- 调用方标识与凭据有效性。
- 租户状态与调用方所属关系。
- 信源范围和可用字段。
- 授权的开始与结束时间。
拒绝原因与处理
拒绝原因对应不同的处理方向。排障时先看故障码,再核对调用方、凭据、路由键和信源状态,避免把权限问题当作网络问题处理。
故障码说明失败发生在哪一步,不代替信源业务错误。处理时先区分凭据、权限、路由和信源四类原因,再决定由哪一方修正。修改完成后使用原请求编号复测,便于比对前后结果。
| 拒绝原因 | 对应故障码 | 处理动作 |
|---|---|---|
| 凭据缺失或过期 | GW-401 | 更新凭据后重新提交 |
| 调用方不在授权范围 | GW-403 | 核对并调整授权范围 |
| 路由键不存在 | GW-404 | 核对路由键与信源登记 |
| 请求编号重复 | GW-409 | 使用原请求结果,不重复提交 |
| 请求过于频繁 | GW-429 | 按业务规则降低请求频率 |
租户与范围隔离
租户是调用方在网关中的配置与记录隔离单位。不同租户使用独立凭据和独立配置,记录按租户分开,避免一处配置变化影响其他调用方。调用方、租户和信源的对应关系在接入时登记,后续判断以登记内容为准。
身份可信不代表可以访问全部信源。同一调用方可以在不更换身份的情况下调整权限,也可以为不同用途签发独立凭据。范围收窄后,下一次请求即按新范围判断,调用方需要同步确认业务预期。范围扩大时补充授权材料,不临时放行。
租户隔离也影响记录查询。调用方只能查看本租户范围内的记录,跨租户查询需要单独授权。配置变更按租户分别生效,避免一次调整影响多个调用方。
轮换与停用
轮换按计划进行,停用按事件处理。计划内轮换保留新旧凭据的过渡使用,事件停用以控制影响为先,处理后再重新签发。
停用凭据时同步核对关联配置,避免其他系统仍引用旧值。轮换记录写明新旧凭据的切换时间,便于审计时确认请求归属。
- 在凭据到期前签发新凭据,保留新旧凭据的过渡使用。
- 通知调用方更新配置,确认切换计划避开业务高峰。
- 切换后核对请求是否落到新凭据,检查拒绝记录。
- 凭据泄露或人员离职时立即停用,并核对近期访问记录。
- 停用后如需恢复,重新签发凭据,不启用已停用的旧凭据。
- 轮换完成后更新凭据台账,注明签发时间、用途和责任人。
排障次序
排障按从近到远的次序进行,先确认调用方侧配置,再核对网关判断,最后检查信源端点。每一步保留故障码和请求编号,便于交接和复核。
- 记录故障码、请求编号、调用方和时间。
- 核对凭据是否有效、租户状态是否正常。
- 核对调用方与信源的授权范围及期限。
- 核对路由键和信源状态。
- 需要时切换备选信源,并将处理结果写入记录。
- 把处理过程和结论写入记录,便于后续复核。
常见问题
- 调用凭据可以给多个系统共用吗
- 不建议。不同租户、不同信源使用独立凭据,避免一处泄露影响多个范围。
- 权限调整后需要改代码吗
- 通常不需要。网关在下一次请求按新范围判断,调用方应确认业务预期是否同步调整。
- 信源凭据会返回给调用方吗
- 不会。信源凭据由网关保存和使用,调用方只持有调用凭据。
- 拒绝请求会到达信源吗
- 不会。鉴权任一项不通过时,请求在网关侧终止,并写入拒绝记录。
- 过渡期新旧凭据都能用吗
- 在约定的过渡范围内同时可用,切换完成后停用旧凭据并核对访问记录。
- 凭据过期前会提醒吗
- 按接入约定提供到期提醒,调用方仍需自行维护更新计划,避免只依赖提醒。
- 管理凭据可以给业务系统使用吗
- 不可以。管理凭据仅限授权人员用于配置和变更,业务系统只使用调用凭据。