ANSIBLE.HTPASSWD(3)             ANSIBLE MODULES            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



1.4.5                             2014-02-12               ANSIBLE.HTPASSWD(3)
