网络与安全
请将代理监听器、Admin 监听器、指标端点、etcd 和托管 Cloud 连接视为彼此独立的信任区域。
网络边界
可以参考下表决定每个网络中允许访问哪些内容：
| 暴露面 | 承载内容 | 暴露范围 |
|---|---|---|
| 代理监听器 | 面向调用方的 AI 流量，例如 /v1/chat/completions | 预期调用方或入口层 |
| Admin 监听器 | Admin API、Admin 健康检查、OpenAPI 和 playground | loopback、私有子网或仅管理员可访问网络 |
| 指标监听器 | Prometheus 指标 | 可信监控网络 |
| 配置存储 | 自托管部署中位于 etcd 的动态网关资源 | 仅 AISIX 和配置管理系统 |
| 托管 Cloud 连接 | 与 AISIX Cloud 控制面之间经过 mTLS 认证的网关通信 | 到 AISIX Cloud 控制面的出站 mTLS 路径 |
只向调用方暴露代理监听器。Admin、指标、OpenAPI、playground 和 etcd 应保留在私有网络中。指标端点不做认证，并通过专用指标监听器提供。
当网络位置要求加密传输或双向认证传输时，请使用 TLS 或 mTLS。如果启用 etcd TLS，启动配置必须指向网关进程可读取的证书文件。
凭证边界
调用方 API Key 和上游服务提供方凭证有不同的存储和转发规则：
| 凭证或密钥 | AISIX 如何使用 | 需要保护的内容 |
|---|---|---|
| 调用方 API Key | 以哈希形式存储；明文由调用应用持有 | 应用密钥存储和 API Key 轮换流程 |
| 服务提供方密钥 | 用于认证上游服务提供方请求 | 配置存储、Admin 访问和备份 |
| 可观测性导出器凭证 | 发送到配置的遥测目标，或为该目标解析 | 动态资源存储和可观测性配置访问权限 |
| 托管证书包 | 用于将托管网关认证到 AISIX Cloud | 运行时状态目录、信任根和托管引导流程 |
在自托管部署中，服务提供方凭证可能存放在配置存储中。OTLP HTTP 导出器请求头可以存储在动态配置里；对象存储、阿里云 SLS 和 Datadog 导出器使用网关本地解析的凭证引用。请将 etcd、备份和 Admin API 访问路径视为携带密钥的暴露面。在托管部署中，AISIX Cloud 控制服务提供方密钥处理，并将运行时配置投射到托管网关。
AISIX 使用调用方 API Key 认证调用方，并使用服务提供方凭证认证上游请求。透传默认会剥离敏感入站请求头。服务提供方密钥的剥离设置会影响转发内容，因此除非特定上游集成要求，否则应继续剥离 authorization、cookie 和 x-api-key 等携带凭证的请求头。
安全基线
路由生产流量前，请确认以下控制项：
- 代理监听器只能被预期调用方或入口访问。
- 自托管部署中的 Admin 监听器是私有的。
- 指标端点是私有的。
- 自托管部署中的 etcd 是私有、持久化、有备份且受访问控制的。
- 服务提供方密钥 secret 和导出器凭证被视为敏感运维数据。
- 当部署要求加密传输或双向认证传输时，已配置监听器 TLS、etcd TLS 或托管 mTLS。
- 托管网关身份通过基于证书的引导路径验证。
- 备份和可观测性流水线不会暴露动态资源载荷或服务提供方凭证。
下一步
你已经了解在暴露 AISIX 前需要保护的网络和凭证边界。接下来阅读 TLS 与 mTLS 了解传输安全。