创建 HMAC 插件

HMAC 插件实现了基于 HmacSHA256 算法为 HTTP 请求生成不可伪造的 AK/SK 签名，开启后需要携带相关请求头和签名等信息访问当前资源。本文介绍如何创建一个 HMAC 插件。

前提条件

• 已创建消费者，且生成认证信息。具体操作，请参见 创建消费者和 生成认证信息。

• 如果生效级别选择服务级别，请先创建服务。具体操作，请参见 创建服务。

• 如果生效级别选择路由级别，请先创建路由。具体操作，请参见 创建路由。

使用限制

• 同一插件在同一资源上只能绑定一次。

• 同一插件在不同级别的资源上绑定时，只匹配生效优先级最高的资源，生效优先级由高到低：路由 > 服务。

  例如，服务 Ⅰ 具有两条路由：路由 A 和路由 B，将插件配置在服务 Ⅰ 和路由 A 上，此时路由 A 的生效规则遵循路由 A 的插件配置，路由 B 的生效规则遵循服务 Ⅰ 的插件配置。

• 实例级别的插件所属实例只能选择2024年1月19日00:00以后创建的网关实例。如果您的控制台无法开启插件，请 提交工单。

创建插件

1. 登录 API 网关控制台。

2. 在顶部导航栏，选择目标地域。

3. 在左侧导航栏选择 插件管理 > HMAC 插件。

4. 在 HMAC 页面，单击 创建插件。

5. 在创建 HMAC 插件页面，完成以下配置，然后单击 确定。

   

   配置项说明：

   配置项	说明
   生效级别	选择 HMAC 插件的生效级别。 说明 同一插件在不同级别的资源上绑定时，只会匹配生效优先级最高的资源。生效优先级从高到低：路由 > 服务。
   所属服务	生效级别选择 服务级别，请选择所属实例和所属服务。
   所属路由	生效级别选择 路由级别，请选择所属实例、所属服务和所属路由。
   备注	可选。您可以根据业务需要选择是否编辑备注内容，例如 HMAC 插件的用途，便于后期识别。
   消费者	选择消费者。 注意 消费者必须已生成认证信息。