Модуль Apache mod_authn_anon
| Описание: | Позволяет «анонимным» пользователям получать доступ к защищённым областям |
|---|---|
| Статус: | Расширение |
| Идентификатор модуля: | authn_anon_module |
| Исходный файл: | mod_authn_anon.c |
| Совместимость: | Доступен в Apache 2.1 и более поздних версиях |
Краткое описание
Этот модуль предоставляет интерфейсы аутентификации, такие как mod_auth_basic, для аутентификации пользователей по аналогии с анонимными FTP-сайтами, т. е. с «магическим» идентификатором пользователя «anonymous» и адресом электронной почты в качестве пароля. Эти адреса электронной почты можно записывать в журнал.
В сочетании с другими методами управления доступом (на основе баз данных) это позволяет эффективно отслеживать пользователей и настраивать сайт с учётом профиля пользователя, сохраняя при этом доступ для «незарегистрированных» пользователей. Одно из преимуществ отслеживания пользователей на основе Auth заключается в том, что, в отличие от магических файлов cookie и необычных префиксов или суффиксов URL, этот способ полностью независим от браузера и позволяет пользователям делиться URL-адресами.
При использовании mod_auth_basic этот модуль вызывается с помощью директивы AuthBasicProvider со значением anon.
Пример
В приведённом ниже примере обычная аутентификация на основе файла htpasswd сочетается с дополнительным доступом для пользователей-«гостей» со следующими свойствами:
- Пользователь должен указать свой идентификатор. (
Anonymous_NoUserID) - Пользователь должен указать пароль. (
Anonymous_MustGiveEmail) - Указанный пароль должен быть действительным адресом электронной почты, т. е. содержать как минимум один символ «@» и точку. (
Anonymous_VerifyEmail) - Идентификатор пользователя должен быть одним из следующих:
anonymous guest www test welcome; при сравнении не учитывается регистр. (Anonymous) - Адреса электронной почты, указанные в поле пароля, записываются в файл журнала ошибок. (
Anonymous_LogEmail)
Пример
<Directory "/var/www/html/private">
AuthName "Use 'anonymous' & Email address for guest entry"
AuthType Basic
AuthBasicProvider file anon
AuthUserFile "/path/to/your/.htpasswd"
Anonymous_NoUserID off
Anonymous_MustGiveEmail on
Anonymous_VerifyEmail on
Anonymous_LogEmail on
Anonymous anonymous guest www test welcome
Require valid-user
</Directory> Директива Anonymous
| Описание: | Указывает идентификаторы пользователей, которым разрешён доступ без проверки пароля |
|---|---|
| Синтаксис: | Anonymous user [user] ... |
| Контекст: | directory, .htaccess |
| Переопределение: | AuthConfig |
| Статус: | Расширение |
| Модуль: | mod_authn_anon |
Список из одного или нескольких «магических» идентификаторов пользователей, которым разрешён доступ без проверки пароля. Идентификаторы пользователей разделяются пробелами. Чтобы включить пробел в идентификатор пользователя, можно использовать кавычки ' и ", а также символ экранирования \.
Обратите внимание, что при сравнении не учитывается регистр.
Настоятельно рекомендуется всегда включать магическое имя пользователя «anonymous» в список разрешённых идентификаторов.
Пример:
Anonymous anonymous "Not Registered" "I don't know"
Это позволит пользователю получить доступ без проверки пароля, указав идентификатор «anonymous», «AnonyMous», «Not Registered» или «I Don't Know».
Начиная с Apache 2.1, идентификатор пользователя можно указать как «*». Это позволяет принимать любой указанный идентификатор пользователя.
Директива Anonymous_LogEmail
| Описание: | Определяет, будет ли введённый пароль записываться в журнал ошибок |
|---|---|
| Синтаксис: | Anonymous_LogEmail On|Off |
| Значение по умолчанию: | Anonymous_LogEmail On |
| Контекст: | directory, .htaccess |
| Переопределение: | AuthConfig |
| Статус: | Расширение |
| Модуль: | mod_authn_anon |
Если установлено значение On (значение по умолчанию), введённый «пароль» (который, как предполагается, содержит корректный адрес электронной почты) записывается в журнал ошибок.
Директива Anonymous_MustGiveEmail
| Описание: | Определяет, разрешены ли пустые пароли |
|---|---|
| Синтаксис: | Anonymous_MustGiveEmail On|Off |
| Значение по умолчанию: | Anonymous_MustGiveEmail On |
| Контекст: | directory, .htaccess |
| Переопределение: | AuthConfig |
| Статус: | Расширение |
| Модуль: | mod_authn_anon |
Определяет, должен ли пользователь указывать адрес электронной почты в качестве пароля. Это запрещает использование пустых паролей.
Директива Anonymous_NoUserID
| Описание: | Определяет, может ли поле идентификатора пользователя быть пустым |
|---|---|
| Синтаксис: | Anonymous_NoUserID On|Off |
| Значение по умолчанию: | Anonymous_NoUserID Off |
| Контекст: | directory, .htaccess |
| Переопределение: | AuthConfig |
| Статус: | Расширение |
| Модуль: | mod_authn_anon |
Если установлено значение On, пользователи могут оставить поле идентификатора пользователя (и, возможно, поле пароля) пустым. Это может быть очень удобно для пользователей MS-Explorer, которые могут просто нажать клавишу Enter или непосредственно кнопку OK; это кажется естественной реакцией.
Директива Anonymous_VerifyEmail
| Описание: | Определяет, следует ли проверять правильность формата адреса электронной почты в поле пароля |
|---|---|
| Синтаксис: | Anonymous_VerifyEmail On|Off |
| Значение по умолчанию: | Anonymous_VerifyEmail Off |
| Контекст: | directory, .htaccess |
| Переопределение: | AuthConfig |
| Статус: | Расширение |
| Модуль: | mod_authn_anon |
Если установлено значение On, введённый «пароль» проверяется на наличие как минимум одного символа «@» и точки, чтобы побудить пользователей указывать действительные адреса электронной почты (см. приведённую выше директиву Anonymous_LogEmail).
© 2018 The Apache Software Foundation
Licensed under the Apache License, Version 2.0.
https://httpd.apache.org/docs/2.4/en/mod/mod_authn_anon.html
