ngx_mail_auth_http_module
最后更新于
最后更新于
设置 HTTP 认证服务器的 URL。协议描述如下。
将指定的头附加到发送到身份验证服务器的请求。该头可以用作共享密钥，以验证请求来自 nginx。例如：
将 Auth-SSL-Cert 头和 PEM 格式（已编码）的客户端证书附加到发送到身份验证服务器的请求。
设置与认证服务器通信的超时时间。
HTTP 协议用于与身份验证服务器进行通信。响应正文中的数据将被忽略，信息仅在头中传递。
请求和响应的示例：
请求：
好的响应：
坏的响应：
如果没有 Auth-Wait 头，则将返回错误并关闭连接。当前实现为每次身份验证尝试分配内存。仅在会话结束时才释放内存。因此，必须限制单个会话中无效身份验证尝试的次数 — 服务器必须在 10-20 次尝试后响应不带 Auth-Wait 头（尝试次数在 Auth-Login-Attempt 头中传递）。
使用 APOP 或 CRAM-MD5 时，请求-响应如下所示：
好的响应：
如果响应中存在 Auth-User 头，它将覆盖用于与后端进行身份验证的用户名。
对于 SMTP，响应还考虑了 Auth-Error-Code 头 — 如果存在，则在发生错误时用作响应代码。否则，将 535 5.7.0 代码添加到 Auth-Status 头中。
例如，如果从身份验证服务器收到以下响应：
则 SMTP 客户端将收到错误
如果代理 SMTP 不需要身份验证，则请求将如下所示：
对于 SSL/TLS 客户端连接（1.7.11），添加了 Auth-SSL 头，并且 Auth-SSL-Verify 将包含客户端证书验证的结果（如果启用）：SUCCESS、FAILED:reason 和 NONE（如果不存在证书）。
在 1.11.7 版本之前，
FAILED结果不包含原因字符串。
存在客户端证书时，其详细信息将在以下请求头中传递：Auth-SSL-Subject、Auth-SSL-Issuer、Auth-SSL-Serial 和 Auth-SSL-Fingerprint。如果启用了 auth_http_pass_client_cert，则证书本身将在 Auth-SSL-Cert 头中传递。该请求将如下所示：
-
说明
语法
auth_http URL;
默认
——
上下文
mail、server
-
说明
语法
auth_http_header header value;
默认
——
上下文
mail、server
-
说明
语法
auth_http_pass_client_cert on | off;
默认
auth_http_pass_client_cert off;
上下文
mail、server
提示
该指令在 1.7.11 版本中出现
-
说明
语法
auth_http_timeout time
默认
auth_http_timeout 60s;
上下文
mail、server