1. 课程导论：平台门户对接Kong网关的背景、回滚护栏的定义与重要性、权限分级设计的核心目标

1.1 平台门户对接Kong网关的背景

在微服务架构中，API 网关作为所有流量的统一入口，承担着路由、认证、限流、日志等核心职责。Kong 网关凭借其插件生态、高性能和声明式配置，已成为企业级 API 管理的首选。然而，当平台门户（Portal）直接对接 Kong 网关时，运维团队面临以下挑战：

• 配置变更风险高：路由、上游、插件等配置的误操作可能导致生产流量中断。
• 多团队协作冲突：不同业务线同时修改 Kong 配置，缺乏变更隔离与审批机制。
• 回滚能力缺失：传统 Kong 管理方式缺乏版本化回滚能力，一旦出错恢复周期长。
• 权限粒度粗放：全量管理员权限导致“一人误操作，全站受影响”。

1.2 回滚护栏的定义与重要性

回滚护栏是指在 API 网关配置变更过程中，通过版本控制、变更审计、自动校验和快速回退机制，形成的一道安全防线。它确保任何配置变更都可追溯、可验证、可恢复。

1.3 权限分级设计的核心目标

权限分级设计旨在将 Kong 网关的管理权限按角色、环境和操作类型进行精细化拆分，实现“最小权限原则”与“变更安全”的平衡。其核心目标包括：

1. 角色隔离：区分只读用户、配置编辑者、审批者、超级管理员，避免越权操作。
2. 环境分级：开发、测试、预发布、生产环境配置权限逐级收紧，生产环境变更必须经过审批。
3. 操作分级：查询、创建、更新、删除、回滚等操作分别授权，关键操作（如删除路由、修改上游）需二次确认。
4. 变更流程化：配置变更必须经过“编辑 → 提交 → 审批 → 发布 → 回滚就绪”的标准化流程。
5. 审计与追溯：所有操作记录完整，支持按时间、用户、资源维度快速检索。

1.4 整体架构概览

下图展示了平台门户对接 Kong 网关时，回滚护栏与权限分级在整体架构中的位置：

1.5 课程学习路径

本课程将围绕以下主线展开：