htpasswd - управление файлами пользователей для аутентификации по основанию

Новое в версии 1.3.

Сводка
- Требования
Параметры
Примечания
Примеры
Статус
- Автор

Сводка

Добавление и удаление записей с именем пользователя/паролем в файле паролей с помощью htpasswd.
Используется веб-серверами, такими как Apache и Nginx, для аутентификации по основанию.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

passlib>=1.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
attributes (добавлено в 2.3)	Значение по умолчанию: None	Атрибуты, которые должен иметь файл или каталог. Чтобы получить поддерживаемые флаги, см. страницу справки для chattr на целевой системе. Эта строка должна содержать атрибуты в том же порядке, что и в выводе lsattr. псевдонимы: attr
create	Варианты: yes ← no	Используется с `state=present`. Если указано, файл будет создан, если он еще не существует. Если установлено "no", произойдет ошибка, если файл не существует
crypt_scheme	Варианты: apr_md5_crypt ← des_crypt ldap_sha1 plaintext	Схема шифрования, которая будет использоваться. Помимо четырех вариантов, перечисленных здесь, можно также использовать любой другой хэш, поддерживаемый passlib, например, md5_crypt и sha256_crypt, которые являются хэшами linux passwd. Если вы это сделаете, файл паролей будет несовместим с Apache или Nginx
group	Значение по умолчанию: None	Имя группы, которая должна владеть файлом/каталогом, как при использовании chown.
mode	Значение по умолчанию: None	Режим файла или каталога. Для тех, кто привык к /usr/bin/chmod, помните, что режимы фактически являются восьмеричными числами (например, `0644` или `01777`). Если опустить ведущую нуль, вероятно, будут непредвиденные результаты. Начиная с версии 1.8, режим может быть указан как символический режим (например, `u+rwx` или `u=rw,g=r,o=r`).
name обязательно		Имя пользователя для добавления или удаления псевдонимы: username
owner	Значение по умолчанию: None	Имя пользователя, который должен владеть файлом/каталогом, как при использовании chown.
password		Пароль, связанный с пользователем. Обязательно должен быть указан, если пользователь еще не существует.
path обязательно		Путь к файлу, содержащему имена пользователей и пароли псевдонимы: dest, destfile
selevel	Значение по умолчанию: s0	Часть контекста файла SELinux. Это атрибут MLS/MCS, иногда известный как `range`. `_default` функция работает так же, как для seuser.
serole	Значение по умолчанию: None	Часть контекста файла SELinux, роль. `_default` функция работает так же, как для seuser.
setype	Значение по умолчанию: None	Часть контекста файла SELinux, тип. `_default` функция работает так же, как для seuser.
seuser	Значение по умолчанию: None	Часть контекста файла SELinux, пользователь. Будет по умолчанию соответствовать политике системы, если применимо. Если установлено `_default`, будет использоваться часть политики `user`, если доступна.
state	Варианты: present ← absent	Является ли запись пользователя необходимой или нет
unsafe_writes (добавлено в 2.2)	Варианты: no ← yes	Обычно этот модуль использует атомарные операции для предотвращения повреждения данных или несогласованного чтения из целевых файлов. Иногда системы настроены или просто неисправны таким образом, что это предотвращает. Одним из примеров являются файлы, смонтированные в docker, они не могут быть обновлены атомарно и могут быть обновлены только небезопасным способом. Этот булевый параметр позволяет Ansible перейти к небезопасным методам обновления файлов в тех случаях, когда у вас нет другого выбора. Имейте в виду, что это подвержено проблемам гонки и может привести к повреждению данных.

Примечания

Примечание

Этот модуль зависит от Python-библиотеки passlib, которую необходимо установить на всех целевых системах.
В Debian, Ubuntu или Fedora: установите python-passlib.
В RHEL или CentOS: включите EPEL, затем установите python-passlib.

Примеры

# Add a user to a password file and ensure permissions are set
- htpasswd:
    path: /etc/nginx/passwdfile
    name: janedoe
    password: '9s36?;fyNp'
    owner: root
    group: www-data
    mode: 0640

# Remove a user from a password file
- htpasswd:
    path: /etc/apache2/passwdfile
    name: foobar
    state: absent

# Add a user to a password file suitable for use by libpam-pwdfile
- htpasswd:
    path: /etc/mail/passwords
    name: alex
    password: oedu2eGh
    crypt_scheme: md5_crypt

Статус

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

Автор

Команда разработчиков Ansible

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/htpasswd_module.html