auth_http_header
auth_http_header 指令设置在 NGINX Mail module 中用于认证的 HTTP 头。 — NGINX Mail Core
auth_http_header
mailmail server
语法auth_http_header header_name header_value;
默认值none
上下文mail, mail server
模块NGINX Mail Core
参数2
说明
`auth_http_header` 指令在 NGINX Mail Core 中使用,用于定义在客户端连接时为认证目的而发送的特定 HTTP 头。当认证机制需要特殊头由上游服务器正确处理时,此指令尤其有用。通过指定相应的头,该指令可确保在邮件事务期间认证过程顺利执行。 该指令接受两个参数:第一个参数指定头的名称,第二个参数指示该头的预期值。当客户端尝试认证时,NGINX 会在通信中包含这些头,以便针对远程认证服务验证用户。在需要特殊输入格式来有效管理认证的集成系统环境中,这点尤为重要。 作为邮件服务器配置的一部分,该指令必须在 mail server blocks 的上下文中使用,以确保其有效地应用于目标邮件服务。正确配置此指令对于确保任何外部认证服务能够识别并响应指定的头,从而实现成功的认证流程,至关重要。
配置示例
mail {
auth_http_header "X-Auth-User" "$remote_user";
}⚠
确保标头名称拼写正确,以避免身份验证失败。
⚠
确保所设置的标头不会与 NGINX 服务器或邮件客户端使用的现有标头冲突。