community.general.onepassword_doc (8.5.0) — lookup

Fetch documents stored in 1Password

| "added in version" 8.1.0 of community.general"

Authors: Sam Doran (@samdoran)

Install collection

Install with ansible-galaxy collection install community.general:==8.5.0


Add to requirements.yml

  collections:
    - name: community.general
      version: 8.5.0

Description

P(community.general.onepassword_doc#lookup) wraps C(op) command line utility to fetch one or more documents from 1Password.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Retrieve a private key from 1Password
  ansible.builtin.debug:
    var: lookup('community.general.onepassword_doc', 'Private key')

Inputs

    
vault:
    description: Vault containing the item to retrieve (case-insensitive). If absent will
      search all vaults.
    type: str

_terms:
    description: Identifier(s) (case-insensitive UUID or name) of item(s) to retrieve.
    required: true

domain:
    default: 1password.com
    description: Domain of 1Password.
    type: str

section:
    description: Item section containing the field to retrieve (case-insensitive). If
      absent will return first match from any section.

username:
    description: The username used to sign in.
    type: str

subdomain:
    description: The 1Password subdomain to authenticate against.
    type: str

account_id:
    description: The account ID to target.
    type: str

secret_key:
    description: The secret key used when performing an initial sign in.
    type: str

connect_host:
    description: The host for 1Password Connect. Must be used in combination with O(connect_token).
    env:
    - name: OP_CONNECT_HOST
    type: str
    version_added: 8.1.0
    version_added_collection: community.general

connect_token:
    description: The token for 1Password Connect. Must be used in combination with O(connect_host).
    env:
    - name: OP_CONNECT_TOKEN
    type: str
    version_added: 8.1.0
    version_added_collection: community.general

master_password:
    aliases:
    - vault_password
    description: The password used to unlock the specified vault.
    type: str

service_account_token:
    description:
    - The access key for a service account.
    - Only works with 1Password CLI version 2 or later.
    env:
    - name: OP_SERVICE_ACCOUNT_TOKEN
      version_added: 8.2.0
      version_added_collection: community.general
    type: str

Outputs

_raw:
  description: Requested document
  elements: string
  type: list