身份与权限
身份与权限分开处理,是为了避免把可信身份等同于全部权限。调用方通过凭据证明身份,权限范围决定它可以访问的信源、字段以及授权期限。
判断在转发前完成。任一项不满足时,网关直接拒绝并返回明确错误,请求不会到达信源,审计记录保留拒绝原因。
身份可信不代表可以访问全部信源。把两者分开,企业可以给同一调用方授予有限范围,也可以在不更换身份的情况下调整权限。
租户是调用方在网关中的配置与记录隔离单位;调用方、租户和信源之间的关系在接入时登记,后续判断以登记内容为准。
凭据类型
凭据按用途区分,各自独立管理,不跨场景复用。
凭据按租户和用途签发,管理凭据与调用凭据分开,减少配置权限被业务系统持有的情况。信源凭据由网关保存和使用,不向调用方暴露。
| 凭据 | 使用场景 | 管理方式 |
|---|---|---|
| 调用凭据 | 调用方访问网关 | 按租户和用途签发 |
| 信源凭据 | 网关访问信源 | 按信源单独配置 |
| 管理凭据 | 配置和变更 | 仅限授权人员使用 |
权限判断
判断逐项进行,前一项不通过即停止,不进入后续校验。
判断结果只有通过与拒绝两种,拒绝时返回明确错误类型,便于调用方区分是凭据问题、权限问题还是期限问题。
- 校验凭据有效性和租户状态。
- 校验调用方是否在信源授权范围内。
- 校验请求字段是否在允许范围内。
- 校验请求时间是否在授权期限内。
- 任一项不满足时拒绝请求,返回明确错误,不转发到信源。
轮换与停用
凭据设置有效期,到期前签发新凭据,新旧凭据在过渡期内同时可用,调用方按计划切换。凭据泄露或人员离职时立即停用。
不同租户、不同信源使用独立凭据,不跨范围复用。停用后相关请求按凭据无效处理,必要时核对近期审计记录。
轮换计划应避开业务高峰,并提前确认调用方已更新配置;切换完成后核对新旧凭据的调用是否都已落到新凭据。
风险控制
凭据管理的关键在于范围和期限,范围越小、期限越明确,泄露后的影响越容易控制。
- 凭据能否跨系统复用?
- 不同租户、不同信源使用独立凭据,不跨范围复用,避免一处泄露影响多个信源。
- 人员离职后如何处理?
- 立即停用相关凭据,并核对近期审计记录,确认没有异常访问。
- 授权范围调整后何时生效?
- 下一次请求即按新范围判断,调用方无需修改代码,但应同步确认业务预期。