1. 课程导论与项目背景
1.1 什么是权限审计网关
权限审计网关是一种位于微服务入口与内部服务之间的中间层代理，专门负责对进入系统的每一次请求执行身份认证、权限校验和操作审计三大核心职责。它不同于普通的 API 网关（仅做路由转发或限流），权限审计网关将安全策略从业务代码中剥离，形成统一的、可审计的安全边界。
核心定位： 权限审计网关 = 统一认证 + 细粒度授权 + 全量审计日志，三者缺一不可。
在微服务架构中，每个服务原本可能需要重复实现登录校验、角色判断、操作记录等功能。引入权限审计网关后，这些横切关注点被集中到网关层，业务服务只需关注自身逻辑，大幅降低安全漏洞风险。
| 维度 | 普通 API 网关 | 权限审计网关 |
|---|---|---|
| 认证 | 可选，通常只做简单 Token 校验 | 强制，支持 OAuth2、JWT、mTLS 等多种方式 |
| 授权 | 无或仅 URL 级白名单 | 支持 RBAC/ABAC，资源级、字段级权限控制 |
| 审计 | 通常不记录或只记录基础访问日志 | 全量记录请求/响应、用户身份、时间戳、操作结果 |
| 链路追踪 | 无 | 内置 TraceID 传播，与审计日志关联 |
1.2 为什么需要链路追踪
在微服务架构中，一次用户请求往往需要经过多个服务协作完成。当权限审计网关拦截并校验请求后，请求会继续向下游服务传递。如果某个环节出现性能瓶颈、权限误判或审计日志丢失，传统日志排查方式难以快速定位问题。
链路追踪（Distributed Tracing）通过为每个请求分配全局唯一的 TraceID，并在服务间传递 Span 上下文，将一次请求的完整调用链串联起来。对于权限审计网关而言，链路追踪的价值体现在以下三个关键场景：
- 审计溯源： 将网关的认证/授权结果与下游服务的业务操作关联，形成端到端的审计证据链。
- 性能诊断： 精确测量网关层权限校验耗时、下游服务响应时间，快速定位慢请求。
- 错误排查： 当权限校验失败或审计日志缺失时，通过 TraceID 回溯完整调用路径，确定故障点。
实践要点： 权限审计网关的链路追踪不是可选项，而是合规性要求。在金融、医疗等监管严格的行业，审计日志必须能够与请求链路一一对应，否则无法通过安全审计。
1.3 课程目标与学习路径
本课程旨在帮助学员从零构建一个生产级别的 Go 权限审计网关，并为其集成完整的链路追踪能力。课程覆盖从理论到实战的全过程，最终交付一个可运行、可审计、可观测的网关系统。
课程核心目标
- 掌握 Go 语言构建高性能网关的核心技术（net/http、中间件模式、并发安全）。
- 实现基于 JWT 的统一认证与基于 RBAC 的细粒度权限校验。
- 设计全量审计日志系统，支持结构化存储与查询。
- 集成 OpenTelemetry 链路追踪，实现 TraceID 自动传播与 Span 上报。
- 通过实战项目，理解权限审计网关在微服务安全体系中的最佳实践。
学习路径
课程共 30 章，分为五个阶段，建议按顺序学习：
| 阶段 | 章节范围 | 核心内容 |
|---|---|---|
| 基础篇 | 第 1-5 章 | Go 网络编程基础、中间件模式、JWT 认证实现 |
| 核心篇 | 第 6-12 章 | RBAC 权限模型、资源级授权、审计日志设计与存储 |
| 链路追踪篇 | 第 13-18 章 | OpenTelemetry 集成、TraceID 传播、Span 采样与上报 |
| 高级篇 | 第 19-25 章 | 网关高可用、限流熔断、安全加固、性能优化 |
| 实战篇 | 第 26-30 章 | 完整项目搭建、测试、部署与监控看板 |
前置要求： 学员需具备 Go 语言基础（goroutine、channel、interface 等），了解 HTTP 协议基本概念。如对微服务架构有初步认识更佳，但非必须。