diff --git a/docsite/rst/playbooks2.rst b/docsite/rst/playbooks2.rst index dfa993a7d6..ae90f011b9 100644 --- a/docsite/rst/playbooks2.rst +++ b/docsite/rst/playbooks2.rst @@ -209,6 +209,40 @@ some other options, but otherwise works equivalently:: prompt: "Product release version" private: no +If `Passlib `_ is installed, vars_prompt can also crypt the +entered value so you can use it, for instance, with the user module to define a password:: + + vars_prompt: + - name: "my_password2" + prompt: "Enter password2" + private: yes + encrypt: "md5_crypt" + confirm: yes + salt_size: 7 + +You can use any crypt scheme supported by `Passlib `_ : + +- *des_crypt* - DES Crypt +- *bsdi_crypt* - BSDi Crypt +- *bigcrypt* - BigCrypt +- *crypt16* - Crypt16 +- *md5_crypt* - MD5 Crypt +- *bcrypt* - BCrypt +- *sha1_crypt* - SHA-1 Crypt +- *sun_md5_crypt* - Sun MD5 Crypt +- *sha256_crypt* - SHA-256 Crypt +- *sha512_crypt* - SHA-512 Crypt +- *apr_md5_crypt* - Apache’s MD5-Crypt variant +- *phpass* - PHPass’ Portable Hash +- *pbkdf2_digest* - Generic PBKDF2 Hashes +- *cta_pbkdf2_sha1* - Cryptacular’s PBKDF2 hash +- *dlitz_pbkdf2_sha1* - Dwayne Litzenberger’s PBKDF2 hash +- *scram* - SCRAM Hash +- *bsd_nthash* - FreeBSD’s MCF-compatible nthash encoding + +However, the only parameters accepted are 'salt' or 'salt_size'. You can use you own salt using +'salt', or have one generated automatically using 'salt_size'. If nothing is specified, a salt +of size 8 will be generated. Passing Variables On The Command Line ````````````````````````````````````` @@ -910,7 +944,7 @@ priority. 6. Host variables from inventory. 7. Group variables from inventory in inheritance order. This means if a group includes a sub-group, the variables -in the subgroup have higher precedence. + in the subgroup have higher precedence. Therefore, if you want to set a default value for something you wish to override somewhere else, the best place to set such a default is in a group variable. The 'group_vars/all' file makes an excellent place to put global