Модуль Apache mod_authn_dbd

Сводка

Этот модуль предоставляет интерфейсные модули аутентификации, такие как mod_auth_digest и mod_auth_basic, которые проверяют подлинность пользователей, находя их в таблицах SQL. Аналогичные возможности предоставляют, например, mod_authn_file.

Этот модуль использует mod_dbd для указания драйвера базы данных и параметров подключения, а также для управления подключениями к базе данных.

При использовании mod_auth_basic или mod_auth_digest этот модуль вызывается через AuthBasicProvider или AuthDigestProvider со значением dbd.

Производительность и кэширование

Некоторые пользователи аутентификации DBD в HTTPD 2.2/2.4 сообщали о том, что она создает чрезмерную нагрузку на базу данных. Чаще всего это происходит, когда HTML-страница содержит сотни объектов (например, изображений, скриптов и т. д.), каждый из которых требует аутентификации. Пользователям, столкнувшимся с этой проблемой или обеспокоенным ее возникновением, следует использовать mod_authn_socache для кэширования учетных данных и существенного снижения нагрузки на базу данных.

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

В этом простом примере показано использование данного модуля в контексте механизмов аутентификации и DBD.

# mod_dbd configuration
# UPDATED to include authentication caching
DBDriver pgsql
DBDParams "dbname=apacheauth user=apache password=xxxxxx"

DBDMin  4
DBDKeep 8
DBDMax  20
DBDExptime 300

<Directory "/usr/www/myhost/private">
  # mod_authn_core and mod_auth_basic configuration
  # for mod_authn_dbd
  AuthType Basic
  AuthName "My Server"

  # To cache credentials, put socache ahead of dbd here
  AuthBasicProvider socache dbd

  # Also required for caching: tell the cache to cache dbd lookups!
  AuthnCacheProvideFor dbd
  AuthnCacheContext my-server

  # mod_authz_core configuration
  Require valid-user

  # mod_authn_dbd SQL query to authenticate a user
  AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
</Directory>

Предоставление информации о входе в систему

При каждом запросе к серверу базы данных значения всех столбцов первой строки, возвращенной запросом, помещаются в окружение в виде переменных окружения с префиксом "AUTHENTICATE_".

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

Это может значительно упростить написание кода и настройку некоторых веб-приложений.

AuthDBDUserPWQuery query

AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"

AuthDBDUserRealmQuery query

AuthDBDUserRealmQuery "SELECT password FROM authn WHERE user = %s AND realm = %s"