community.general.onepassword_raw 查询 – 从 1Password 获取完整项目

注意

此查询插件是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 包,则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install community.general。您需要其他需求才能使用此查询插件,请参阅 需求 获取详细信息。

要在 playbook 中使用它,请指定:community.general.onepassword_raw

概要

需求

以下需求是在执行此查询的本地控制器节点上需要的。

术语

参数

注释

术语

列表 / 元素=字符串 / 必需

要检索的项目标识符(不区分大小写的 UUID 或名称)。

关键字参数

此部分描述了查询的关键字参数。这些是在以下示例中的值 key1=value1key2=value2 等:lookup('community.general.onepassword_raw', key1=value1, key2=value2, ...)query('community.general.onepassword_raw', key1=value1, key2=value2, ...)

参数

注释

account_id

字符串

在 community.general 7.5.0 中添加

要定位的帐户 ID。

connect_host

字符串

在 community.general 8.1.0 中添加

1Password Connect 的主机。必须与 connect_token 结合使用。

配置

connect_token

字符串

在 community.general 8.1.0 中添加

1Password Connect 的令牌。必须与 connect_host 结合使用。

配置

domain

字符串

在 community.general 6.0.0 中添加

1Password 的域名。

默认值: "1password.com"

master_password

别名:vault_password

字符串

用于解锁指定保管库的密码。

secret_key

字符串

执行初始登录时使用的密钥。

section

字符串

包含要检索的字段的项目部分(不区分大小写)。如果不存在,则将返回任何部分中的第一个匹配项。

service_account_token

字符串

在 community.general 7.1.0 中添加

服务帐户的访问密钥。

仅适用于 1Password CLI 2.0 或更高版本。

配置

subdomain

字符串

要验证的 1Password 子域名。

username

字符串

用于登录的用户名。

vault

字符串

包含要检索的项目的保管库(不区分大小写)。如果不存在,则将搜索所有保管库。

备注

注意

  • 当同时使用关键字参数和位置参数时,位置参数必须列在关键字参数之前:lookup('community.general.onepassword_raw', term1, term2, key1=value1, key2=value2)query('community.general.onepassword_raw', term1, term2, key1=value1, key2=value2)

  • 如果存在,此查询将使用现有的 1Password 会话。如果不存在,并且您已经执行了初始登录(这意味着 ~/.op/config~/.config/op/config~/.config/.op/config 存在),则只需要 master_password。在此场景中,您可以选择性地指定 subdomain,否则 op 将使用上次使用的子域名。

  • 此查找功能可以通过提供subdomainusernamesecret_keymaster_password来执行初始登录。

  • 可以通过提供account_id来定位特定帐户。

  • 由于这些凭据的非常敏感的性质,强烈建议您只在任何给定时间传递所需的最小凭据。此外,请使用强度等于或高于1Password主密码的密钥将这些凭据存储在Ansible Vault中。

  • 此查找功能将1Password中潜在的敏感数据存储为Ansible事实。如果启用缓存,事实将受到缓存的影响,这意味着这些数据可能会以明文形式存储在磁盘或数据库中。

  • 已通过op版本2.7.2测试。

示例

- name: Retrieve all data about Wintermute
  ansible.builtin.debug:
    var: lookup('community.general.onepassword_raw', 'Wintermute')

- name: Retrieve all data about Wintermute when not signed in to 1Password
  ansible.builtin.debug:
    var: lookup('community.general.onepassword_raw', 'Wintermute', subdomain='Turing', vault_password='DmbslfLvasjdl')

返回值

描述

返回值

列表 / 元素=字典

请求的整个项目。

返回:成功

作者

  • Scott Buchanan (@scottsb)

  • Andrew Zenk (@azenk)

  • Sam Doran (@samdoran)

提示

每个条目类型的配置条目具有从低到高的优先级顺序。例如,列表中较低的变量将覆盖较高的变量。