community.general.passwordstore – управление паролями с помощью утилиты pass от passwordstore.org
Примечание
Этот плагин входит в состав коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в плейбуке укажите: community.general.passwordstore.
Обзор
- Разрешает Ansible извлекать, создавать или обновлять пароли с помощью утилиты pass от passwordstore.org. Также извлекает ключи в формате YAML, хранящиеся как многострочные данные в файле паролей.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| _terms строка / обязательный | Ключ запроса. | ||
| backup логическое |
| Используется с overwrite=yes. Архивировать предыдущий пароль в подключаемом ключе. | |
| create логическое |
| Создать пароль, если он еще не существует. | |
| directory строка | env:PASSWORD_STORE_DIR | Директория хранилища паролей. | |
| length целое число | По умолчанию: 16 | Длина сгенерированного пароля. | |
| nosymbols логическое |
| использовать буквенно-цифровые символы. | |
| overwrite логическое |
| Перезаписать пароль, если он уже существует. | |
| passwordstore строка | По умолчанию: "~/.password-store" | Расположение хранилища паролей. | |
| returnall логическое |
| Возвратить все содержимое пароля, а не только первую строку. | |
| subkey строка | По умолчанию: "password" | Возвратить определенный подключаемый ключ пароля. При установке в password, всегда возвращает первую строку. | |
| umask строка добавлен в 1.3.0 community.general | env:PASSWORD_STORE_UMASK | Устанавливает umask для созданных файлов .gpg. Первый октет должен быть больше 3 (доступ для пользователя). Примечание: значение по умолчанию pass - '077'. | |
| userpass строка | Укажите пароль для сохранения вместо сгенерированного. |
Примеры
# Debug is used for examples, BAD IDEA to show passwords on screen
- name: Basic lookup. Fails if example/test doesn't exist
ansible.builtin.debug:
msg: "{{ lookup('community.general.passwordstore', 'example/test')}}"
- name: Create pass with random 16 character password. If password exists just give the password
ansible.builtin.debug:
var: mypassword
vars:
mypassword: "{{ lookup('community.general.passwordstore', 'example/test create=true')}}"
- name: Different size password
ansible.builtin.debug:
msg: "{{ lookup('community.general.passwordstore', 'example/test create=true length=42')}}"
- name: Create password and overwrite the password if it exists. As a bonus, this module includes the old password inside the pass file
ansible.builtin.debug:
msg: "{{ lookup('community.general.passwordstore', 'example/test create=true overwrite=true')}}"
- name: Create an alphanumeric password
ansible.builtin.debug:
msg: "{{ lookup('community.general.passwordstore', 'example/test create=true nosymbols=true') }}"
- name: Return the value for user in the KV pair user, username
ansible.builtin.debug:
msg: "{{ lookup('community.general.passwordstore', 'example/test subkey=user')}}"
- name: Return the entire password file content
ansible.builtin.set_fact:
passfilecontent: "{{ lookup('community.general.passwordstore', 'example/test returnall=true')}}"
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого поиска:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| _raw список / элементы=строка | успех | пароль |
Авторы
- Patrick Deelman (!UNKNOWN) <patrick@patrickdeelman.nl>
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/passwordstore_lookup.html
