ANSIBLE.HTPASSWD(3)

NAME
htpasswd - manage user files for basic authentication

DESCRIPTION

Add and remove username/password entries in a password file using htpasswd.

This is used by web servers such as Apache and Nginx for basic authentication.

OPTIONS

create
    Used with state=present. If specified, the file will be created if it does not already exist. If set to "no", will fail if the file does not exist Choices: yes,no. (default: yes)

crypt_scheme
    Encryption scheme to be used. One of: "apr_md5_crypt", "des_crypt", "ldap_sha1" or "plaintext" (default: apr_md5_crypt)

name
    User name to add or remove(required)

password
    Password associated with user.Must be specified if user does not exist yet

path
    Path to the file that contains the usernames and passwords(required)

state
    Whether the user entry should be present or not Choices: present,absent. (default: present).

NOTES

This module depends on the passlib Python library, which needs to be installed on all target systems.

On Debian, Ubuntu, or Fedora: install python-passlib.

On RHEL or CentOS: Enable EPEL, then install python-passlib.

EXAMPLES
# 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

AUTHOR
Lorin Hochstein

SEE ALSO
ansible(1), http://ansible.github.com/modules.html#htpasswd