diff --git a/changelogs/fragments/32386_debconf_password.yml b/changelogs/fragments/32386_debconf_password.yml new file mode 100644 index 00000000000..4518930ce37 --- /dev/null +++ b/changelogs/fragments/32386_debconf_password.yml @@ -0,0 +1,2 @@ +minor_changes: +- debconf - add a note about no_log=True since module might expose sensitive information to logs (https://github.com/ansible/ansible/issues/32386). diff --git a/lib/ansible/modules/system/debconf.py b/lib/ansible/modules/system/debconf.py index 3466e0a92ce..115e1cbe22b 100644 --- a/lib/ansible/modules/system/debconf.py +++ b/lib/ansible/modules/system/debconf.py @@ -25,6 +25,7 @@ notes: Use 'debconf-show ' on any Debian or derivative with the package installed to see questions/settings available. - Some distros will always record tasks involving the setting of passwords as changed. This is due to debconf-get-selections masking passwords. + - It is highly recommended to add I(no_log=True) to task while handling sensitive information using this module. requirements: - debconf - debconf-utils @@ -43,6 +44,7 @@ options: vtype: description: - The type of the value supplied. + - It is highly recommended to add I(no_log=True) to task while specifying I(vtype=password). - C(seen) was added in Ansible 2.2. type: str choices: [ boolean, error, multiselect, note, password, seen, select, string, text, title ] @@ -68,7 +70,7 @@ EXAMPLES = r''' value: fr_FR.UTF-8 vtype: select -- name: set to generate locales +- name: Set to generate locales debconf: name: locales question: locales/locales_to_be_generated @@ -85,6 +87,14 @@ EXAMPLES = r''' - name: Specifying package you can register/return the list of questions and current values debconf: name: tzdata + +- name: Pre-configure tripwire site passphrase + debconf: + name: tripwire + question: tripwire/site-passphrase + value: "{{ site_passphrase }}" + vtype: password + no_log: True ''' from ansible.module_utils._text import to_text