#!/usr/bin/env python # (c) 2018, Matt Stofko # GNU General Public License v3.0+ (see LICENSE or # https://www.gnu.org/licenses/gpl-3.0.txt) # # This plugin can be run directly by specifying the field followed by a list of # entries, e.g. bitwarden.py password google.com wufoo.com # from __future__ import (absolute_import, division, print_function) __metaclass__ = type import json import os import sys from subprocess import Popen, PIPE, check_output from ansible.errors import AnsibleError from ansible.plugins.lookup import LookupBase try: from __main__ import display except ImportError: from ansible.utils.display import Display display = Display() DOCUMENTATION = """ lookup: bitwarden author: - Matt Stofko requirements: - bw (command line utility) - BW_SESSION environment var (from `bw login` or `bw unlock`) short_description: look up data from a bitwarden vault description: - use the bw command line utility to grab one or more items stored in a bitwarden vault options: _terms: description: name of item that contains the field to fetch required: True field: description: field to return from bitwarden default: 'password' custom_field: description: If True, look up named field in custom fields instead of top-level dictionary. sync: description: If True, call `bw sync` before lookup """ EXAMPLES = """ - name: get 'username' from Bitwarden entry 'Google' debug: msg: "{{ lookup('bitwarden', 'Google', field='username') }}" """ RETURN = """ _raw: description: - Items from Bitwarden vault """ class Bitwarden(object): def __init__(self, path): self._cli_path = path try: check_output([self._cli_path, "--version"]) except OSError: raise AnsibleError("Command not found: {0}".format(self._cli_path)) @property def cli_path(self): return self._cli_path @property def logged_in(self): return 'BW_SESSION' in os.environ def _run(self, args): print("%s %s" % (self.cli_path, args)) p = Popen([self.cli_path] + args, stdin=PIPE, stdout=PIPE, stderr=PIPE) out, err = p.communicate() rc = p.wait() if rc != 0: display.debug("Received error when running '{0} {1}': {2}" .format(self.cli_path, args, out)) if err.startswith(b"Vault is locked."): raise AnsibleError("Error accessing Bitwarden vault. " "Run 'bw unlock' to unlock the vault.") elif err.startswith(b"You are not logged in."): raise AnsibleError("Error accessing Bitwarden vault. " "Run 'bw login' to login.") elif err.startswith(b"Failed to decrypt."): raise AnsibleError("Error accessing Bitwarden vault. " "Make sure BW_SESSION is set properly.") elif err.startswith(b"Not found."): raise AnsibleError("Error accessing Bitwarden vault. " "Specified item not found.") else: raise AnsibleError("Unknown failure in 'bw' command: " "{0}".format(err)) return out.strip() def sync(self): self._run(['sync']) def get_entry(self, key, field): return self._run(["get", field, key]).decode('utf-8') def get_custom_field(self, key, field): data = json.loads(self.get_entry(key, 'item')) return next(x for x in data['fields'] if x['name'] == field)['value'] class LookupModule(LookupBase): def run(self, terms, variables=None, **kwargs): bw = Bitwarden(path=kwargs.get('path', 'bw')) if not bw.logged_in: raise AnsibleError("Not logged into Bitwarden: please run " "'bw login', or 'bw unlock' and set the " "BW_SESSION environment variable first") field = kwargs.get('field', 'password') values = [] if kwargs.get('sync'): bw.sync() for term in terms: if kwargs.get('custom_field'): values.append(bw.get_custom_field(term, field)) else: values.append(bw.get_entry(term, field)) return values def main(): if len(sys.argv) < 3: print("Usage: {0} [name name ...]" .format(os.path.basename(__file__))) return -1 print(LookupModule().run(sys.argv[2:], None, field=sys.argv[1])) return 0 if __name__ == "__main__": sys.exit(main())