https://github.com/1Password/ansible-onepasswordconnect-collection

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.
https://github.com/1Password/ansible-onepasswordconnect-collection

1password ansible secret-management secrets-management

Last synced: 3 months ago
JSON representation

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.

• Host: GitHub
• URL: https://github.com/1Password/ansible-onepasswordconnect-collection
• Owner: 1Password
• License: other
• Created: 2020-12-02T18:43:23.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-05-28T17:33:26.000Z (6 months ago)
• Last Synced: 2024-07-18T16:33:54.258Z (4 months ago)
• Topics: 1password, ansible, secret-management, secrets-management
• Language: Python
• Homepage: https://developer.1password.com/docs/connect/
• Size: 269 KB
• Stars: 107
• Watchers: 15
• Forks: 16
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        




  
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`: **>=7.x**

- `ansible-core`: **>=2.15**

- `python`: **>=3.9**

- `1Password Connect`: **>= 1.0.0**

## ✨ Get started

### 🚀 Quickstart

1. You can install the Ansible collection from [Ansible Galaxy](https://galaxy.ansible.com/onepassword/connect):

```

ansible-galaxy collection install onepassword.connect

```

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

```yaml

--- 

  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](USAGEGUIDE.md) for documentation for example usage.

## 💙 Community & Support

- File an [issue](https://github.com/1Password/ansible-onepasswordconnect-collection/issues) for bugs and feature requests.

- Join the [Developer Slack workspace](https://join.slack.com/t/1password-devs/shared_invite/zt-1halo11ps-6o9pEv96xZ3LtX_VE0fJQA).

- Subscribe to the [Developer Newsletter](https://1password.com/dev-subscribe/).

## 🔐 Security

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

Please file requests via [**BugCrowd**](https://bugcrowd.com/agilebits).

For information about security practices, please visit the [1Password Bug Bounty Program](https://bugcrowd.com/agilebits).