auth_ldap_servers_size
`auth_ldap_servers_size` 指令指定可在配置中为认证目的定义的最大 LDAP 服务器数量。
LDAP Authentication module for NGINX
·
http
语法auth_ldap_servers_size number;
默认值7
上下文http
参数1
说明
auth_ldap_servers_size 指令在 NGINX LDAP 认证模块中用于设置配置中可指定的 LDAP 服务器数量上限。该指令对于资源管理和确保配置保持可管理性非常重要，特别是在包含多个 LDAP 服务器的大型环境中。该指令接受一个整数参数，表示可为 LDAP 认证配置的最大服务器数。如果定义的 LDAP 服务器数量超过此限制，配置将无效，导致 NGINX 在重启或重新加载时出现错误。
使用此指令时，必须考虑出于冗余、负载均衡或故障切换场景而需要多个服务器的可能性。通过配置最大服务器数，管理员可以防止过度分配资源并维持 NGINX 服务器的性能，尤其是在高负载情况下。该指令与其他与 LDAP 认证相关的配置指令相互补充，通过确保所定义的参数保持在合理范围内，从而为用户认证过程提供更稳定且可预测的运行环境。
配置示例
http {
auth_ldap_servers_size 5;
ldap_server server1 {
url ldap://192.168.1.1:389/dc=example,dc=com?sAMAccountName
binddn "cn=admin,dc=example,dc=com";
binddn_passwd "password";
}
ldap_server server2 {
url ldap://192.168.1.2:389/dc=example,dc=com?sAMAccountName
binddn "cn=admin,dc=example,dc=com";
binddn_passwd "password";
}
}⚠
超过定义的限制将导致在 NGINX 重新加载时出现配置错误。
⚠
该指令必须包含在适当的上下文中；它只能在 http 块中设置。
⚠
请确保实际定义的服务器数量不超过该指令设置的值。