# Attach Consumer Label 配置选项

attach-consumer-label 插件将自定义消费者标签附加到已认证的请求中，供上游服务执行额外业务逻辑。<!-- --> <!-- -->配置涵盖插件参数。

## 参数[​](#参数 "参数的直接链接")

请参阅 [插件通用配置](https://docs.apiseven.com/apisix/reference/plugin-common-configurations.md) 了解所有插件可用的配置选项。

* headers

  object

  必填

  ***

  要附加到请求头的消费者标签键值对，其中键是请求头名称（如 `X-Consumer-Role`），值是对自定义标签键的引用（如 `$role`）。请注意，该值应始终以美元符号（`$`）开头。

  网关会先清除每个已配置的请求头，再解析对应的标签。如果引用的标签不存在，上游将收不到该请求头的任何值，包括客户端提供的同名值。此行为自 API7 Gateway 3.9.16 和 3.10.2，以及 APISIX 3.18.0 起可用；更早版本中，标签不存在时不会覆盖客户端提供的请求头值。
