salt.modules.htpasswd

Support for htpasswd command

New in version 2014.1.0.

The functions here will load inside the webutil module. This allows other functions that don't use htpasswd to use the webutil module name.

salt.modules.htpasswd.useradd(pwfile, user, password, opts='', runas=None)

Add a user to htpasswd file using the htpasswd command. If the htpasswd file does not exist, it will be created.

pwfile
Path to htpasswd file
user
User name
password
User password
opts

Valid options that can be passed are:

  • n Don't update file; display results on stdout.
  • m Force MD5 encryption of the password (default).
  • d Force CRYPT encryption of the password.
  • p Do not encrypt the password (plaintext).
  • s Force SHA encryption of the password.
runas
The system user to run htpasswd command with

CLI Examples:

salt '*' webutil.useradd /etc/httpd/htpasswd larry badpassword
salt '*' webutil.useradd /etc/httpd/htpasswd larry badpass opts=ns
salt.modules.htpasswd.useradd_all(pwfile, user, password, opts='', runas=None)

Add a user to htpasswd file using the htpasswd command. If the htpasswd file does not exist, it will be created.

pwfile
Path to htpasswd file
user
User name
password
User password
opts

Valid options that can be passed are:

  • n Don't update file; display results on stdout.
  • m Force MD5 encryption of the password (default).
  • d Force CRYPT encryption of the password.
  • p Do not encrypt the password (plaintext).
  • s Force SHA encryption of the password.
runas
The system user to run htpasswd command with

CLI Examples:

salt '*' webutil.useradd /etc/httpd/htpasswd larry badpassword
salt '*' webutil.useradd /etc/httpd/htpasswd larry badpass opts=ns
salt.modules.htpasswd.userdel(pwfile, user, runas=None)

Delete a user from the specified htpasswd file.

pwfile
Path to htpasswd file
user
User name
runas
The system user to run htpasswd command with

CLI Examples:

salt '*' webutil.userdel /etc/httpd/htpasswd larry