# 安全与合规概览

API7 网关位于 API 客户端和上游服务之间，控制面管理整个部署中的路由、凭证、插件以及操作人员的访问。保护这一架构需要对客户端和管理员进行身份认证、授权访问、保护流量、限制管理接口访问，并审查受支持的管理活动。这些控制措施适用于不同的信任边界，应根据部署拓扑、安全策略和合规要求进行配置。

### 身份认证与访问管理[​](#身份认证与访问管理 "身份认证与访问管理的直接链接")

验证每个客户端、用户和系统组件的身份，是构建零信任安全体系的基础。API7 支持多种行业标准身份认证机制，确保只有合法流量才能访问 API 和管理界面。

* **双向 TLS（mTLS）**：由控制台生成的数据面部署在 DP Manager 的 `7943` 端口使用基于证书的身份认证。`7900` 端口也接受使用实例 Token 认证的 HTTP 连接；此端口上的流量未加密，因此应将其限制在可信网络中。
* **OAuth 2.0 和 OIDC**：与 Okta、Keycloak 等外部身份提供商（IdP）集成，为 API 提供现代的 Token 身份认证。
* **单点登录（SSO）**：通过企业身份提供商集中管理对 API7 控制台的用户访问，简化用户管理并增强安全性。
* **基于角色的访问控制（RBAC）**：对 API7 控制台中的用户权限进行细粒度控制，可以定义符合组织结构的角色。
* **密码策略**：启用后，要求内置控制台用户定期修改密码，并禁止重复使用最近用过的密码。
* **两步验证**：内置控制台用户可以为登录添加第二因素，也可以将其设为所有内置用户的必选项。

### 授权与访问控制[​](#授权与访问控制 "授权与访问控制的直接链接")

客户端完成身份认证后，授权机制决定其可以执行的操作。API7 提供强大而灵活的工具来实施细粒度访问控制策略，确保客户端只能访问明确获准使用的资源。

* **访问控制列表**：将 API 访问限制为特定消费者、服务或路由，通常与 API Key（API 密钥）或其他身份认证方式配合使用。
* **基于角色的访问控制（RBAC）**：管理管理员和操作员可以通过控制台和 Admin API 执行的操作。对于代理的 API 流量，请在路由和服务上配置授权插件。
* **权限策略和权限边界**：限制授予用户的控制面操作和资源。无论为用户分配了哪些角色，权限边界都会限制其有效权限。

### API 威胁防护[​](#api-威胁防护 "API 威胁防护的直接链接")

保护 API 不仅需要验证客户端身份和权限，还需要检查请求内容和行为。

* **Web 应用防火墙（WAF）**：将 WAF 与 API7 网关集成，检查 SQL 注入和 XSS 等常见 Web 攻击。请参阅[Web 应用防火墙（WAF）](https://docs.apiseven.com/api7-gateway/security-and-compliance/web-application-firewall.md)。

### 数据保护与加密[​](#数据保护与加密 "数据保护与加密的直接链接")

保护传输中和静态数据的机密性与完整性，是重要的合规要求。API7 提供可靠的加密能力和安全凭证管理，以保护敏感信息。

* **安全凭证管理**：安全存储和管理 SSL 证书、密码和 API Token 等敏感值。支持与 HashiCorp Vault 和 AWS Secrets Manager 等外部密钥管理器集成，实现集中控制。
* **端到端加密**：使用 TLS 加密从客户端到网关，以及从网关到上游服务的传输数据，防止窃听和中间人攻击。

### 基础设施安全[​](#基础设施安全 "基础设施安全的直接链接")

保护网关基础设施本身与保护其管理的 API 流量同样重要。API7 提供用于加固控制面和数据面的特性，防止直接攻击和未经授权的配置变更。

* **使用 IP 限制保护控制面**：仅允许受信任的 IP 地址访问 Admin API 和控制台，显著缩小攻击面。
* **验证镜像签名**：确保部署的 API7 网关容器镜像具有完整性和真实性，未被篡改且来自受信任的来源。

### 监控与审计[​](#监控与审计 "监控与审计的直接链接")

了解管理活动对于威胁检测、事件响应和合规至关重要。API7 会记录审计范围内的管理操作，以支持调查和合规审查。

* **审计日志**：记录审计范围内的路由、插件、安全策略和其他资源变更，并记录操作人员信息和请求上下文。有关覆盖范围限制和敏感数据处理，请参阅[审计日志](https://docs.apiseven.com/api7-gateway/security-and-compliance/audit-logs.md)。
* **SIEM 集成**：可以将审计日志导出为 JSON 或 CSV，再导入外部安全信息与事件管理（SIEM）系统进行分析。

### 合规与治理[​](#合规与治理 "合规与治理的直接链接")

满足行业和监管合规标准是企业级 API 网关的重要职责。API7 在设计时充分考虑合规要求，提供通过安全审计所需的特性和透明度。

* **开源软件许可证**：清晰记录 API7 使用的开源组件及其相应许可证，简化许可证合规工作。
* **漏洞扫描**：每周运行的工作流分别扫描控制面和网关的开发镜像，并为可修复的高危和严重级别问题创建跟踪事项。这些工作流支持监控和分诊，但不会阻断发布。
* **信任中心**：集中提供所有安全与合规信息，包括认证、安全报告和最佳实践指南。
