This is a lookup module for secrets stored in HashiCorp Vault.

The plugin is currently written for ansible 2.0 but a working version for ansible 1.9 exists under the 1.0.0 tag.

lookup plugins can be loaded from several different locations similar to $PATH, see docs.

The address to the Vault server and the auth token are fetched from environment variables

export VAULT_ADDR=http://192.168.33.10:8200/
export VAULT_TOKEN=56f48aef-8ad3-a0c4-447b-8e96990776ff

ansible-vault then works as any other lookup plugin.

- debug: msg="{{ lookup('vault', 'secret/foo', 'value') }}"

# templates/example.j2

# Generic secrets
{{ lookup('vault', 'secret/hello').value }} # world
# Generic secrets with parameters
{{ lookup('vault', 'pki/issue/example-dot-com common_name=foo.example.com format=pem_bundle').certificate }}
# Specify field inside lookup
{{ lookup('vault', 'secret/hello', 'value') }} # world

# Dynamic secrets
{% set aws = lookup('vault', 'aws/creds/deploy') %}
access_key = {{ aws.access_key }} # AKSCAIZSFSYHFGA
secret_key = {{ aws.secret_key }} # 4XSLxDUS+hyXgoIHEhCKExHDGAJDHFiUA/adi

• (Ansible Vault) No external dependencies; (hashi_vault) requires hvac
• (Ansible Vault) Uses the same environment variables as vault itself
• (Ansible Vault) Quicker update cycle
• (Ansible Vault) Supports dynamic secrets
• (Ansible Vault) Supports custom fields