Manage the password database on Solaris systems


If you feel that Salt should be using this module to manage passwords on a minion, and it is using a different module (or gives an error similar to '' is not available), see here.


Returns the default hash used for unset passwords

CLI Example:

salt '*' shadow.default_hash

New in version 2015.8.8.

Delete the password from name user

CLI Example:

salt '*' shadow.del_password username
salt.modules.solaris_shadow.gen_password(password, crypt_salt=None, algorithm='sha512')

New in version 2015.8.8.

Generate hashed password


When called this function is called directly via remote-execution, the password argument may be displayed in the system's process list. This may be a security risk on certain systems.

Plaintext password to be hashed.
Crpytographic salt. If not given, a random 8-character salt will be generated.

The following hash algorithms are supported:

  • md5
  • blowfish (not in mainline glibc, only available in distros that add it)
  • sha256
  • sha512 (default)

CLI Example:

salt '*' shadow.gen_password 'I_am_password'
salt '*' shadow.gen_password 'I_am_password' crypt_salt='I_am_salt' algorithm=sha256

Return information for the specified user

CLI Example:

salt '*' root
salt.modules.solaris_shadow.set_maxdays(name, maxdays)

Set the maximum number of days during which a password is valid. See man passwd.

CLI Example:

salt '*' shadow.set_maxdays username 90
salt.modules.solaris_shadow.set_mindays(name, mindays)

Set the minimum number of days between password changes. See man passwd.

CLI Example:

salt '*' shadow.set_mindays username 7
salt.modules.solaris_shadow.set_password(name, password)

Set the password for a named user. The password must be a properly defined hash, the password hash can be generated with this command: openssl passwd -1 <plaintext password>

CLI Example:

salt '*' shadow.set_password root $1$UYCIxa628.9qXjpQCjM4a..
salt.modules.solaris_shadow.set_warndays(name, warndays)

Set the number of days of warning before a password change is required. See man passwd.

CLI Example:

salt '*' shadow.set_warndays username 7