1Password Connect Ansible Collection

Access and manage your 1Password items in your Ansible Automation Platform through your self-hosted 1Password Connect server.

The 1Password Connect collection contains modules that interact with your 1Password Connect deployment. The modules communicate with the 1Password Connect API to support Vault Item create/read/update/delete operations.

Requirements

• ansible (community package): >=9.x (includes ansible-core 2.16)
• ansible-core: >=2.16.0
• python: >=3.10
• 1Password Connect: >= 1.0.0

✨ Get started

🚀 Quickstart

1. You can install the Ansible collection from Ansible Galaxy:

ansible-galaxy collection install onepassword.connect

1. Example of getting information about an Item, including fields and metadata:

---
hosts: localhost
vars:
  connect_token: "valid.jwt.here"
environment:
  OP_CONNECT_HOST: http://localhost:8001
collections:
  - onepassword.connect
tasks:
  - name: Find the item with the label "Staging Database" in the vault "Staging Env"
    item_info:
      token: "{{ connect_token }}"
      item: Staging Database
      vault: Staging Env
    no_log: true
    register: op_item

📄 Usage

Refer to the Usage Guide for documentation for example usage.

💙 Community & Support

• File an issue for bugs and feature requests.
• Join the Developer Slack workspace.
• Subscribe to the Developer Newsletter.

🔐 Security

1Password requests you practice responsible disclosure if you discover a vulnerability.

Please file requests by sending an email to bugbounty@agilebits.com.