HTTP头字段

如果您需要自定义HTTP头字段,并希望通过ALB监听的附加HTTP头字段实现部分特定功能,您可以通过本文查看ALB支持的附加头字段及如何添加附加HTTP头字段。

ALB支持的附加头字段

HTTP头字段是指在超文本传输协议(HTTP)的请求和响应消息中的消息头部分。HTTP头字段可以根据需求自定义,因此在Web服务器和浏览器上可能存在非标准的HTTP头字段。下表列出了ALB支持的附加头字段及相关说明。

字段名

说明

适用监听协议

X-Forwarded-For

在您创建监听时,X-Forwarded-For头字段可以获取来访者客户端IP地址。

字段格式:

X-Forwarded-For: <client-ip-address>, <proxy1>, <proxy2>, …

ALB默认开启X-Forwarded-For头字段。

ALB如何获取客户端真实IP教程,请参见通过ALB获取客户端真实IP

  • HTTP

  • HTTPS

SLB-ID

在您创建监听时,可以通过开启SLB-ID头字段来获取负载均衡实例ID。

  • HTTP

  • HTTPS

  • QUIC

X-Forwarded-Proto

在您创建监听时,可以通过开启X-Forwarded-Proto头字段来获取客户端与负载均衡监听连接时所用的协议。您的应用可以使用存储在X-Forwarded-Proto头字段中的协议来重定向至目标URL。

字段格式:

X-Forwarded-Proto: <originatingProtocol>
  • HTTP

  • HTTPS

  • QUIC

X-Forwarded-Port

在您创建监听时,可以通过开启X-Forwarded-Port头字段来获取客户端与负载均衡监听连接时所用的端口。

字段格式:

X-Forwarded-Port: <port>
  • HTTP

  • HTTPS

  • QUIC

X-Forwarded-Clientcert-subjectdn

在您创建监听时,可以通过开启X-Forwarded-Clientcert-subjectdn头字段获取访问负载均衡实例客户端证书的所有者信息。

开启该头字段后,您需输入自定义的HTTP头名称。

HTTPS

X-Forwarded-Clientcert-issuerdn

在您创建监听时,可以通过开启X-Forwarded-Clientcert-issuerdn头字段获取访问负载均衡实例客户端证书的发行者信息。

开启该头字段后,您需输入自定义的HTTP头名称。

HTTPS

X-Forwarded-Clientcert-fingerprint

在您创建监听时,可以通过开启X-Forwarded-Clientcert-fingerprint头字段获取访问负载均衡实例客户端证书的指纹取值。

开启该头字段后,您需输入自定义的HTTP头名称。

HTTPS

X-Forwarded-Clientcert-clientverify

在您创建监听时,可以通过开启X-Forwarded-Clientcert-clientverify头字段获取对访问负载均衡实例客户端证书的校验结果。

开启该头字段后,您需输入自定义的HTTP头名称。

HTTPS

X-Forwarded-Client-srcport

在您创建监听时,可以通过开启X-Forwarded-Client-srcport头字段获取访问负载均衡实例客户端的端口。

字段格式:

X-Forwarded-Client-srcport: <port>
  • HTTP

  • HTTPS

在控制台附加HTTP头字段

在创建监听时附加HTTP头字段

  1. 登录应用型负载均衡ALB控制台

  2. 在顶部菜单栏,选择ALB实例所属的地域。

  3. 选择以下一种方法,打开监听配置向导。

    • 实例页面,在目标实例操作列单击创建监听

    • 实例页面,单击目标实例ID。单击监听页签,然后单击创建监听

  4. 配置监听配置向导,完成以下配置,然后单击下一步

    监听配置

    说明

    选择监听协议

    选择监听的协议类型。

    高级配置

    单击修改展开高级配置。

    附加HTTP头字段

    根据您的业务需求,选择您需要开启的自定义HTTP头字段。

    说明

    此处只罗列头字段相关的配置信息,更多配置参数,请参见:

  5. 根据界面提示,完成创建监听后续的配置步骤。

为已创建的监听附加HTTP头字段

  1. 登录应用型负载均衡ALB控制台

  2. 在顶部菜单栏,选择ALB实例所属的地域。

  3. 实例页面,单击目标实例ID。

  4. 单击监听页签,在目标监听操作列选择更多>编辑监听

  5. 编辑监听对话框,单击高级配置右侧单击修改

  6. 附加HTTP头字段区域添加、保留或移除头字段,然后单击保存

使用API附加HTTP头字段

您可以在创建监听时附加头字段,也可以为已创建的监听添加、保留或移除头字段。

相关文档

控制台操作文档

API文档

  • CreateListener:在创建HTTP、HTTPS或QUIC监听时通过设置XForwardedForConfig来添加HTTP头字段。

  • UpdateListenerAttribute:在更新监听的配置时通过更新XForwardedForConfig参数来添加、保留或移除头字段。