auth_ldap_cache_enabled

Включает кэширование результатов аутентификации LDAP в NGINX.

Синтаксисauth_ldap_cache_enabled on | off;
По умолчаниюoff
Контекстhttp
Аргументы1

Описание

Директива auth_ldap_cache_enabled позволяет NGINX кэшировать результаты запросов аутентификации LDAP, что может заметно повысить производительность за счёт уменьшения числа обращений к LDAP-серверу при повторных запросах аутентификации. Когда эта функция включена, успешные и неуспешные попытки аутентификации сохраняются в памяти на указанное время. Это означает, что последующие запросы от того же пользователя могут обходить LDAP-сервер, если результат предыдущей аутентификации остаётся действительным в пределах времени жизни кэша.

Вместе с этой директивой администраторам следует управлять временем истечения кэша с помощью директивы auth_ldap_cache_expiration_time, которая определяет, как долго результат аутентификации считается валидным, прежде чем он будет признан устаревшим. Кэширование эффективно балансирует нагрузку на LDAP-сервер и оптимизирует время отклика при аутентификации пользователей, особенно в средах с большим пользовательским трафиком или при частом доступе к защищенным ресурсам. Однако крайне важно обеспечить соответствие политик кэширования требованиям безопасности организации, поскольку кэшированные результаты могут содержать устаревшую информацию о правах доступа пользователей.

Кроме того, если настроено несколько LDAP-серверов, поведение кэширования зависит от контекста директивы, что позволяет задавать глобальные настройки, которые могут влиять на все настроенные LDAP-серверы. Правильная конфигурация и тестирование этой директивы могут привести к более эффективному и отзывчивому механизму аутентификации в конфигурациях NGINX, обрабатывающих интеграцию LDAP.

Пример конфига

http {
    auth_ldap_cache_enabled on;
    /* Other LDAP configuration settings */
}

Убедитесь, что время жизни кэша настроено надлежащим образом; слишком длительный период может привести к устаревшим результатам аутентификации.

При использовании нескольких LDAP-серверов убедитесь, что настройки кэша применяются последовательно, чтобы избежать несоответствий в результатах аутентификации.

← Ко всем директивам