鉴权与权限参考

鉴权确认调用方是谁,权限确认可以访问哪些信源和字段。参考把凭据类型、判断输入、拒绝原因和轮换操作集中列出,便于对接时逐项核对,也便于排障时快速定位问题所在的环节。

凭据用途对照

凭据按用途分开管理,是为了让泄露影响停留在有限范围。调用方只持有调用凭据,信源凭据由网关保存和使用,管理凭据仅用于配置变更,三类凭据不互相替代。

凭据管理的关键在范围和期限。范围越小、期限越明确,泄露后的影响越容易控制。凭据不写入前端代码、公开仓库和日志,配置变更由授权人员操作。

凭据使用场景管理要求
调用凭据调用方访问网关按租户和用途签发,设置有效期
信源凭据网关访问信源按信源单独配置,不向调用方暴露
管理凭据配置和变更仅限授权人员使用,与调用凭据分开

权限判断的输入

判断在转发前完成,输入来自接入时登记的调用方、租户、信源和授权信息。任一项不满足时,网关直接拒绝,请求不会到达信源,拒绝原因写入审计记录。

判断按顺序执行,前一项不通过即停止,不进入后续校验。

  • 调用方标识与凭据有效性。
  • 租户状态与调用方所属关系。
  • 信源范围和可用字段。
  • 授权的开始与结束时间。

拒绝原因与处理

拒绝原因对应不同的处理方向。排障时先看故障码,再核对调用方、凭据、路由键和信源状态,避免把权限问题当作网络问题处理。

故障码说明失败发生在哪一步,不代替信源业务错误。处理时先区分凭据、权限、路由和信源四类原因,再决定由哪一方修正。修改完成后使用原请求编号复测,便于比对前后结果。

拒绝原因对应故障码处理动作
凭据缺失或过期GW-401更新凭据后重新提交
调用方不在授权范围GW-403核对并调整授权范围
路由键不存在GW-404核对路由键与信源登记
请求编号重复GW-409使用原请求结果,不重复提交
请求过于频繁GW-429按业务规则降低请求频率

租户与范围隔离

租户是调用方在网关中的配置与记录隔离单位。不同租户使用独立凭据和独立配置,记录按租户分开,避免一处配置变化影响其他调用方。调用方、租户和信源的对应关系在接入时登记,后续判断以登记内容为准。

身份可信不代表可以访问全部信源。同一调用方可以在不更换身份的情况下调整权限,也可以为不同用途签发独立凭据。范围收窄后,下一次请求即按新范围判断,调用方需要同步确认业务预期。范围扩大时补充授权材料,不临时放行。

租户隔离也影响记录查询。调用方只能查看本租户范围内的记录,跨租户查询需要单独授权。配置变更按租户分别生效,避免一次调整影响多个调用方。

轮换与停用

轮换按计划进行,停用按事件处理。计划内轮换保留新旧凭据的过渡使用,事件停用以控制影响为先,处理后再重新签发。

停用凭据时同步核对关联配置,避免其他系统仍引用旧值。轮换记录写明新旧凭据的切换时间,便于审计时确认请求归属。

  1. 在凭据到期前签发新凭据,保留新旧凭据的过渡使用。
  2. 通知调用方更新配置,确认切换计划避开业务高峰。
  3. 切换后核对请求是否落到新凭据,检查拒绝记录。
  4. 凭据泄露或人员离职时立即停用,并核对近期访问记录。
  5. 停用后如需恢复,重新签发凭据,不启用已停用的旧凭据。
  6. 轮换完成后更新凭据台账,注明签发时间、用途和责任人。

排障次序

排障按从近到远的次序进行,先确认调用方侧配置,再核对网关判断,最后检查信源端点。每一步保留故障码和请求编号,便于交接和复核。

  1. 记录故障码、请求编号、调用方和时间。
  2. 核对凭据是否有效、租户状态是否正常。
  3. 核对调用方与信源的授权范围及期限。
  4. 核对路由键和信源状态。
  5. 需要时切换备选信源,并将处理结果写入记录。
  6. 把处理过程和结论写入记录,便于后续复核。

常见问题

调用凭据可以给多个系统共用吗
不建议。不同租户、不同信源使用独立凭据,避免一处泄露影响多个范围。
权限调整后需要改代码吗
通常不需要。网关在下一次请求按新范围判断,调用方应确认业务预期是否同步调整。
信源凭据会返回给调用方吗
不会。信源凭据由网关保存和使用,调用方只持有调用凭据。
拒绝请求会到达信源吗
不会。鉴权任一项不通过时,请求在网关侧终止,并写入拒绝记录。
过渡期新旧凭据都能用吗
在约定的过渡范围内同时可用,切换完成后停用旧凭据并核对访问记录。
凭据过期前会提醒吗
按接入约定提供到期提醒,调用方仍需自行维护更新计划,避免只依赖提醒。
管理凭据可以给业务系统使用吗
不可以。管理凭据仅限授权人员用于配置和变更,业务系统只使用调用凭据。

核对凭据范围

按租户、用途和信源分别梳理凭据,确认有效期与授权范围一致。

了解服务