/ home / community / community.general / 8.5.0 / lookup / bitwarden_secrets_manager

community.general.bitwarden_secrets_manager (8.5.0) — lookup

Retrieve secrets from Bitwarden Secrets Manager

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

Authors: jantari (@jantari)

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

Retrieve secrets from Bitwarden Secrets Manager.

Requirements

bws (command line utility)

Usage examples

Scanned by Steampunk Spotter

- name: Get a secret relying on the BWS_ACCESS_TOKEN environment variable for authentication
  ansible.builtin.debug:
    msg: >-
      {{ lookup("community.general.bitwarden_secrets_manager", "2bc23e48-4932-40de-a047-5524b7ddc972") }}

Scanned by Steampunk Spotter

- name: Get a secret passing an explicit access token for authentication
  ansible.builtin.debug:
    msg: >-
      {{
        lookup(
          "community.general.bitwarden_secrets_manager",
          "2bc23e48-4932-40de-a047-5524b7ddc972",
          bws_access_token="9.4f570d14-4b54-42f5-bc07-60f4450b1db5.YmluYXJ5LXNvbWV0aGluZy0xMjMK:d2h5IGhlbGxvIHRoZXJlCg=="
        )
      }}

Scanned by Steampunk Spotter

- name: Get two different secrets each using a different access token for authentication
  ansible.builtin.debug:
    msg:
      - '{{ lookup("community.general.bitwarden_secrets_manager", "2bc23e48-4932-40de-a047-5524b7ddc972", bws_access_token=token1) }}'
      - '{{ lookup("community.general.bitwarden_secrets_manager", "9d89af4c-eb5d-41f5-bb0f-4ae81215c768", bws_access_token=token2) }}'
  vars:
    token1: "9.4f570d14-4b54-42f5-bc07-60f4450b1db5.YmluYXJ5LXNvbWV0aGluZy0xMjMK:d2h5IGhlbGxvIHRoZXJlCg=="
    token2: "1.69b72797-6ea9-4687-a11e-848e41a30ae6.YW5zaWJsZSBpcyBncmVhdD8K:YW5zaWJsZSBpcyBncmVhdAo="

Scanned by Steampunk Spotter

- name: Get just the value of a secret
  ansible.builtin.debug:
    msg: >-
      {{ lookup("community.general.bitwarden_secrets_manager", "2bc23e48-4932-40de-a047-5524b7ddc972").value }}

Inputs

    
_terms:
    description: Secret ID(s) to fetch values for.
    elements: str
    required: true
    type: list

bws_access_token:
    description: The BWS access token to use for this lookup.
    env:
    - name: BWS_ACCESS_TOKEN
    required: true
    type: str

Outputs

_raw:
  description: List containing one or more secrets.
  elements: dict
  type: list