auth_http_pass_client_cert

`auth_http_pass_client_cert` 指令配置是否将客户端证书传递给认证 HTTP 服务器。 — NGINX Mail Core

auth_http_pass_client_cert
mailmail server
语法auth_http_pass_client_cert on | off;
默认值off
上下文mail, mail server
模块NGINX Mail Core
参数flag

说明

`auth_http_pass_client_cert` 指令属于 NGINX Mail Core 模块,控制 HTTP 身份验证过程中客户端证书转发的行为。当设置为 `on` 时,NGINX 会将客户端证书转发到外部 HTTP 身份验证服务器,后者可以根据需要检查或验证该证书。这在客户端证书作为身份验证机制一部分的部署中特别有用,可允许针对集中式服务器进行验证。 该指令可取两个值:`on` 和 `off`。默认情况下该指令为 `off`,意味着不会转发客户端证书。如果需要此功能,运维人员必须在其 NGINX 邮件配置中显式声明。当设置为 `on` 时,相关的客户端 SSL 信息会被传递,这对于通过证书正确验证用户身份至关重要。 在实际使用中,应进行适当测试以确保配置按预期工作,特别是在需要客户端证书才能访问某些资源的环境中。如果错误配置该指令,可能导致认证失败或安全漏洞,例如在不应提供证书时证书被错误处理或暴露。

配置示例

mail {
    auth_http_pass_client_cert on;
    # additional configuration...
}

确保外部 HTTP 身份验证服务器已正确设置,以处理发送的客户端证书。

误解将此指令设置为 `on` 的效果,因为如果 HTTP 服务器未正确处理,可能会暴露客户端证书。