支流科技-API7

[hoseake]

Integrate API7 Enterprise into OctoBus

• 厂商：API7.ai
• 产品：API7 Enterprise
• 版本：3.10.2
• 类别：API Gateway / API Security / Security Operations

产品简介

API7 Enterprise 是基于 Apache APISIX 构建的企业级 API 网关与管理平台，提供服务发布、路由治理、消费者与凭证管理、证书管理、插件策略编排、审计日志、告警策略等能力，适用于 API 治理与安全运营场景。

对于 chaitin/OctoBus 而言，API7 很适合作为外部安全能力源接入，通过 OctoBus 的 service package 模型，将其 REST API 封装为统一的 gRPC / Connect RPC / MCP 能力，供 agent 或平台侧调用。

• 项目地址: https://github.com/chaitin/OctoBus
• API7 官网: https://api7.ai/
• API7 文档: https://docs.api7.ai/api7-gateway/reference/admin-api
• API 认证方式: X-API-KEY / Basic Auth

API 特征

API7 Enterprise Admin API 提供较完整的 REST 接口，重点能力包括：

• 用户、角色、Token、审批等权限治理
• 审计日志查询与导出
• 告警策略与告警历史
• 证书、CA、SNI、SSL 生命周期管理
• Consumer 与 Credential 管理
• Route、Service、Upstream、Global Rule、Plugin 管理
• Gateway Group 与实例管理
• Debug Session / Trace / Health Check 能力

从安全运营角度看，建议优先接入以下方向：

• 审计日志中心
• 账号 / Token / 权限治理
• 证书与 TLS 安全治理
• Consumer / Credential 身份治理
• 安全策略编排（Route / Service / Global Rule / Plugin）

建议适配方法

建议在 OctoBus 中新增一个 api7-enterprise service package，优先封装安全运营相关能力，包括只读查询能力，以及适用于测试环境和受控场景的低风险写入能力。

gRPC 方法	说明
API7/ListAuditLogs	查询审计日志
API7/ExportAuditLogs	导出审计日志
API7/ListAlertPolicies	查询告警策略
API7/ListAlertHistories	查询告警历史
API7/ListUsers	查询用户列表
API7/ListRoles	查询角色列表
API7/ListTokens	查询 Token 列表
API7/CreateToken	创建 Token
API7/ListConsumers	查询 Consumer 列表
API7/CreateConsumer	创建 Consumer
API7/ListConsumerCredentials	查询 Consumer 凭证列表
API7/CreateConsumerCredential	创建 Consumer 凭证
API7/ListCertificates	查询证书列表
API7/CreateCertificate	创建证书
API7/ListCACertificates	查询 CA 证书列表
API7/ListSNIs	查询 SNI 列表
API7/CreateSNI	创建 SNI
API7/GetCertificateUsage	查询证书使用关系
API7/ParseCertificate	解析证书内容
API7/ValidateCertificateKey	校验证书与私钥是否匹配
API7/ListGatewayGroups	查询网关分组
API7/ListGatewayInstances	查询网关实例
API7/ListServices	查询服务列表
API7/CreateService	创建服务
API7/ListRoutes	查询路由列表（需传 serviceId）
API7/CreateRoute	创建路由
API7/ListGlobalRules	查询全局规则
API7/CreateGlobalRule	创建全局规则
API7/ListPlugins	查询插件列表
API7/GetPluginSchema	查询插件 Schema
API7/ListApprovals	查询审批记录
API7/ListSecretProviders	查询 Secret Provider 列表
API7/GetSecretProviderUsage	查询 Secret Provider 使用情况
API7/ListDebugSessions	查询调试会话
API7/ListDebugTraces	查询调试追踪
API7/GetServiceHealthcheck	查询服务健康检查状态