community.general.onepassword – извлечение значений полей из 1Password
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.onepassword.
Описание
-
onepasswordоборачивает утилиту командной строкиopдля извлечения определенных значений полей из 1Password.
Требования
Ниже перечислены требования к локальному контроллеру, на котором выполняется данный поиск.
-
opутилита командной строки 1Password. См. https://support.1password.com/command-line/
Параметры
| Параметр | Варианты/Значения по умолчанию | Настройка | Комментарии |
|---|---|---|---|
| _terms строка / обязательно | Идентификатор(ы) элемента(ов) для извлечения (UUID, имя или домен; регистронезависимо). | ||
| field строка | По умолчанию: "пароль" | Поле для возвращения из каждого соответствующего элемента (регистронезависимо). | |
| master_password строка | Пароль для разблокировки указанного хранилища. псевдонимы: vault_password | ||
| secret_key строка | Секретный ключ, используемый при первоначальном входе. | ||
| section строка | Раздел элемента, содержащий поле для извлечения (регистронезависимо). Если отсутствует, будет возвращена первая подходящая запись из любого раздела. | ||
| subdomain строка | Поддомен 1Password для аутентификации. | ||
| username строка | Имя пользователя для входа. | ||
| vault строка | Хранилище, содержащее элемент для извлечения (регистронезависимо). Если отсутствует, поиск будет произведен во всех хранилищах. |
Примечания
Примечание
- Этот поиск воспользуется существующей сессией 1Password, если она есть. Если нет, и вы уже выполнили первоначальный вход (что означает
~/.op/config exists), то необходимо только указатьmaster_password. Вы можете дополнительно указатьsubdomain, в противном случаеopбудет использовать последний использованный поддомен. - Этот поиск может выполнить первоначальный вход, предоставив
subdomain,username,secret_key, иmaster_password. - Из-за очень чувствительной природы этих данных, настоятельно рекомендуется передавать только минимально необходимые данные в каждый момент. Кроме того, храните эти данные в хранилище Ansible Vault с ключом, сила которого равна или превосходит силу мастер-пароля 1Password.
- Этот поиск сохраняет потенциально конфиденциальные данные из 1Password в качестве фактов Ansible. Факты могут быть кэшированы при включенном кэшировании, что означает, что эти данные могут храниться в открытом виде на диске или в базе данных.
- Проверено с
opверсией 0.5.3
Примеры
# These examples only work when already signed in to 1Password
- name: Retrieve password for KITT when already signed in to 1Password
ansible.builtin.debug:
var: lookup('community.general.onepassword', 'KITT')
- name: Retrieve password for Wintermute when already signed in to 1Password
ansible.builtin.debug:
var: lookup('community.general.onepassword', 'Tessier-Ashpool', section='Wintermute')
- name: Retrieve username for HAL when already signed in to 1Password
ansible.builtin.debug:
var: lookup('community.general.onepassword', 'HAL 9000', field='username', vault='Discovery')
- name: Retrieve password for HAL when not signed in to 1Password
ansible.builtin.debug:
var: lookup('community.general.onepassword'
'HAL 9000'
subdomain='Discovery'
master_password=vault_master_password)
- name: Retrieve password for HAL when never signed in to 1Password
ansible.builtin.debug:
var: lookup('community.general.onepassword'
'HAL 9000'
subdomain='Discovery'
master_password=vault_master_password
username='tweety@acme.com'
secret_key=vault_secret_key)
Возвращаемые значения
Общие возвращаемые значения описаны в здесь, следующие поля уникальны для этого поиска:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| _raw список / элементы=строка | успех | Запрошенные данные поля |
Авторы
- Scott Buchanan (@scottsb)
- Andrew Zenk (@azenk)
- Sam Doran (@samdoran)
© 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/onepassword_lookup.html