Модуль Apache mod_authn_file
| Описание: | Аутентификация пользователей с помощью текстовых файлов |
|---|---|
| Статус: | Базовый |
| Идентификатор модуля: | authn_file_module |
| Исходный файл: | mod_authn_file.c |
| Совместимость: | Доступен в Apache 2.1 и более поздних версиях |
Краткое описание
Этот модуль предоставляет интерфейсы аутентификации, такие как mod_auth_digest и mod_auth_basic, для проверки подлинности пользователей путём поиска их данных в текстовых файлах с паролями. Аналогичные возможности предоставляет mod_authn_dbm.
При использовании mod_auth_basic или mod_auth_digest этот модуль вызывается через AuthBasicProvider или AuthDigestProvider со значением file.
Директива AuthUserFile
| Описание: | Задаёт имя текстового файла, содержащего список пользователей и паролей для аутентификации |
|---|---|
| Синтаксис: | AuthUserFile file-path |
| Контекст: | directory, .htaccess |
| Переопределение: | AuthConfig |
| Статус: | Базовый |
| Модуль: | mod_authn_file |
Директива AuthUserFile задаёт имя текстового файла, содержащего список пользователей и паролей для аутентификации пользователей. Путь к файлу — это путь к файлу пользователей. Если он не абсолютный, он считается относительно ServerRoot.
Каждая строка файла пользователей содержит имя пользователя, за которым следуют двоеточие и зашифрованный пароль. Если один и тот же идентификатор пользователя указан несколько раз, mod_authn_file будет использовать первое вхождение для проверки пароля.
Формат зашифрованного пароля зависит от используемого интерфейса аутентификации (например, mod_auth_basic или mod_auth_digest). Дополнительные сведения см. в разделе Форматы паролей.
Для mod_auth_basic используйте утилиту htpasswd, которая входит в состав дистрибутива с бинарными файлами или доступна в src/support. Подробнее см. на странице руководства. Кратко:
Создайте файл паролей Filename, указав username в качестве начального идентификатора. Утилита запросит пароль:
htpasswd -c Filename username
Добавьте или измените username2 в файле паролей Filename:
htpasswd Filename username2
Обратите внимание, что поиск в больших текстовых файлах крайне неэффективен; вместо этого следует использовать AuthDBMUserFile.
Для mod_auth_digest используйте вместо этого htdigest. Обратите внимание, что нельзя смешивать данные пользователей для аутентификации Digest и Basic в одном файле.
Безопасность
Убедитесь, что AuthUserFile хранится вне дерева документов веб-сервера. Не помещайте его в каталог, который он защищает. Иначе клиенты могут скачать AuthUserFile.
© 2018 The Apache Software Foundation
Licensed under the Apache License, Version 2.0.
https://httpd.apache.org/docs/2.4/en/mod/mod_authn_file.html
