auth_ldap_servers_size
Директива `auth_ldap_servers_size` задаёт максимальное количество LDAP-серверов, которые могут быть определены в конфигурации для целей аутентификации.
Описание
Директива auth_ldap_servers_size в модуле NGINX LDAP Authentication предназначена для установки ограничения на количество 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.
Убедитесь, что фактическое число определённых серверов не превышает значение, заданное этой директивой.