消费者
在本文档中，你将学习 API7 企业版中消费者的基本概念以及为什么需要它们。你将了解一些相关概念，包括如何将消费者信息传递到上游、消费者访问限制以及消费者身份验证和授权。
概述
消费者表示向 API 网关发送请求并使用后端服务的用户、应用程序或主机。它与身份验证系统一起使用。每个消费者都必须至少配置一个身份验证凭据或使用插件（如 Authz Keycloak 或 OpenID Connect）与外部身份验证系统集成。
下图说明了具有一个路由和两个消费者的 API7 企业版示例。一个消费者 FetchBot 是一个数据获取机器人，另一个消费者 JohnDoe 是一个用户。路由和消费者都启用了 key-auth 插件，因此，请求将使用 API 密钥进行身份验证。要访问内部服务，FetchBot 使用 bot-key 发送其请求，JohnDoe 使用 john-key 发送其请求。
此配置可确保只有经过身份验证的请求才能与 /petstore 上公开的内部服务进行交互。
- 如果向 API7 企业版发送的请求没有任何密钥或密钥错误，则该请求将被拒绝。
- 如果使用
bot-key向 API7 企业版发送请求，则该请求将被验证并由FetchBot发送以从内部服务获取数据。FetchBot消费者上的limit-count限速插件将生效，将 5 秒窗口内的请求数限制为2。如果未达到限速阈值，则请求将转发到上游服务。否则，它将被拒绝。 - 如果使用
john-key向 API7 企业版发送请求，则该请求将被验证并由JohnDoe发送，随后转发到上游端点。
在这种情况下，身份验证插件将根据插件执行阶段在 limit-count 限速插件之前执行。
消费者身份验证和授权
在基于 API7 企业版的架构中构建身份验证和授权有两种主要设计模式。
第一种也是最常用的方法是通过第三方身份提供商 (IdP)（例如 Keycloak）对请求进行身份验证和授权：
在某些环境中，请求可能需要经过多个 IdP 才能转发到上游端点。在这种情况下，你可以在一个消费者上配置多个身份验证插件，每个插件对应一个 IdP。在所有 IdP 都授予请求访问权限之前，API7 企业版不会显示成功的响应。
第二种也是更基本的方法是直接在 API 网关上使用内置凭据执行身份验证和授权。到目前为止，支持 Key Authentication 验证、Basic Authentication 验证、JWT Authentication 验证和 HMAC Authentication 凭据验证。
与传统的用户登录类似，每个消费者可以创建多个凭据，所有凭据都链接到一个消费者身份。凭据应安全存储并定期更新。
消费者凭据通过允许多个凭据对应每个消费者来增强灵活性。它们取代了传统的身份验证插件，如 key-auth、basic-auth、JWT-auth 和 HMAC-auth，提供了更友好的用户体验。
开发者 vs 消费者
来自 API7 门户的开发者也可以管理 API 凭据并通过订阅利用访问控制，但它们通常用于不同的场景。
| 开发者 | 消费者 | |
|---|---|---|
| 凭据 | 由开发者自己管理，对提供者不可见 | 由提供者管理 |
| API 访问控制 | 开发者请求访问，提供者批准订阅 | 提供者可以直接从白名单/黑名单中添加或删除消费者 |
开发者和消费者可以同时用于不同的 API，独立运行。但是，对于给定的已发布服务及其关联的 API 产品，应使用 API7 网关身份验证插件或 API 产品身份验证配置。
对于私有服务，通过 API7 网关中的消费者管理来限制访问。对于公共服务，将它们分组到定义良好的 API 产品中，并通过 API 产品配置管理开发者访问。
强烈建议不要将 API7 网关身份验证插件和 API 产品身份验证配置组合用于同一已发布服务（仅适用于非常特殊的情况）。这可能会导致身份验证冲突，需要多个凭据才能成功进行 API 请求。
相关阅读
- API 安全
- API 消费