2. 权限审计网关概述
2.1 什么是权限审计网关
权限审计网关（Permission & Audit Gateway）是部署在微服务架构入口层与业务服务之间的中间件组件，负责对进入系统的每一次 API 请求执行身份认证、权限校验和操作审计三大职责。它既不是传统的 API 网关（只做路由与限流），也不是独立的权限中心（只管理策略），而是将“鉴权”与“审计”两个关键安全环节内嵌到网关层，形成一道不可绕过的安全屏障。
核心定位：权限审计网关 = 请求拦截点 + 策略执行点 + 审计日志生成点。所有业务流量必须经过它才能到达后端服务，确保“先鉴权、后路由、再审计”。
2.2 核心功能矩阵
| 功能模块 | 子功能 | 说明 |
|---|---|---|
| 身份认证 | Token 校验 | 解析 JWT / OAuth2 Token，验证签名与有效期 |
| 会话管理 | 支持 SSO、Session 同步、Token 刷新 | |
| 权限校验 | RBAC / ABAC | 基于角色或属性的细粒度访问控制 |
| 资源级鉴权 | 校验用户对特定资源（如订单、文档）的操作权限 | |
| 动态策略 | 支持热更新权限规则，无需重启网关 | |
| 操作审计 | 请求日志 | 记录请求来源、路径、参数、响应状态 |
| 敏感操作告警 | 对删除、修改关键数据等操作触发实时告警 | |
| 审计溯源 | 提供全链路 TraceID，支持日志回放与取证 | |
| 附加能力 | 限流熔断 | 防止恶意请求冲击后端服务 |
| 协议转换 | 支持 gRPC / HTTP 协议互转，适配异构服务 |
2.3 在微服务架构中的位置
权限审计网关位于流量入口层与业务服务层之间，是南北向流量的唯一安全关口。下图展示了它在典型微服务部署中的位置与交互关系：
2.4 为什么需要独立的权限审计网关
在微服务架构中，如果每个业务服务都自行实现鉴权与审计，会导致以下问题：
- 逻辑重复：每个服务都要写一遍 Token 解析、权限校验代码，维护成本高。
- 安全漏洞：某个服务可能遗漏鉴权逻辑，形成安全缺口。
- 审计不统一：各服务日志格式不同，难以进行全局审计溯源。
- 策略更新困难：修改权限规则需要逐个服务发布，效率低且风险大。
最佳实践：将鉴权与审计能力下沉到网关层，业务服务只关注业务逻辑。权限审计网关作为独立组件发布，支持灰度发布与快速回滚，这正是本课程《Go权限审计网关发布回滚》要解决的核心工程问题。
2.5 典型请求处理流程
一次完整的请求经过权限审计网关的处理步骤如下：
- 接收请求：网关拦截 HTTP/gRPC 请求，提取 Token 与请求参数。
- 身份认证：校验 Token 有效性，解析用户身份与角色。
- 权限匹配：根据请求路径、方法、资源 ID，匹配 RBAC/ABAC 策略。
- 决策执行：允许/拒绝请求，拒绝时返回 403 并记录原因。
- 审计写入：将请求上下文、鉴权结果、时间戳写入审计日志。
- 路由转发：允许的请求转发到目标业务服务，附带用户身份上下文。
2.6 与 API 网关的区别
| 对比维度 | 传统 API 网关 | 权限审计网关 |
|---|---|---|
| 核心职责 | 路由、限流、负载均衡 | 认证、鉴权、审计 |
| 鉴权深度 | 简单 Token 校验 | RBAC/ABAC 细粒度策略 |
| 审计能力 | 无或基础访问日志 | 全量操作审计 + 敏感告警 |
| 策略热更新 | 通常不支持 | 支持动态加载权限规则 |
| 部署位置 | 入口层最前端 | 入口层之后，业务服务之前 |
注意：在实际生产环境中，权限审计网关通常与 API 网关配合使用——API 网关负责流量治理，权限审计网关负责安全管控。两者可以合并部署，也可以独立部署，取决于团队架构与性能要求。