ansible-vault-mode

Minor mode for in place manipulation of ansible-vault.

Installation

You can install via ELPA:

M-x package-install RET ansible-vault RET

Or manually downloading ansible-vault-mode and adding the following lines to your conf files:

(add-to-list 'load-path "/path/to/ansible-vault")
(require 'ansible-vault)

Usage

Once ansible-vault-mode in installed you will need to do a little configuring before it is useful.

First you will need to set up your ansible-vault password file. By default ansible-vault-mode assumes the file is located at ~/.vault-pass. Either put your password there or customize the mode to change the location.

You will want to make sure that file has the mode 0600 so other people cannot read it.

$ ls -al ~/.vault-pass
-rw------- 1 notroot notroot 33 May 18 16:11 /home/notroot/.vault-pass

Once that is set up we can start using ansible-vault normally.

The majority of my ansible-vault files are called encrypted and are YAML files so I have the following snippet to turn on ansible vault when needed.

(add-to-list 'auto-mode-alist '("/encrypted$" . yaml-mode))

(add-hook 'yaml-mode-hook
  (lambda ()
    (and (string= (file-name-base) "encrypted") (ansible-vault-mode 1))))

The *ansible-vault-error* buffer will contain any errors from ansible-vault execution.

Automatic enabling based on file contents

To enable ansible-vault-mode just based on the buffer contents, not on file extension, you can do:

(defun ansible-vault-mode-maybe ()
  (when (ansible-vault--is-encrypted-vault-file)
    (ansible-vault-mode 1)))

(add-hook 'yaml-mode-hook 'ansible-vault-mode-maybe)

And if you use the handy use-package package replace the last line with:

(use-package ansible-vault
  :init (add-hook 'yaml-mode-hook 'ansible-vault-mode-maybe))

Per directory ansible-vault password file

To override ansible-vault password file on a per directory basis: first, create a .dir-locals.el file in your directory:

((yaml-mode
  (ansible-vault-password-file . "/home/notroot/.ansible-vault/custom_vault_pass")))

then, if all your vaulted files are prefixed by "vault_", you can load ansible-vault-mode in your init file this way:

(add-hook 'hack-local-variables-hook
          (lambda ()
            (when (and
                   (derived-mode-p 'yaml-mode)
                   (string-prefix-p "vault_" (file-name-base)))
              (ansible-vault-mode 1))))

Vault Id configuration

Ansible Vault now supports vault-id for multiple passwords. You can persistently track vault ids between sessions by configuring the ansible-vault-vault-id-alist value with (vault-id . password-file) pairs.

(setq
 ansible-vault-vault-id-alist
 '(("nonprod" . "/home/notprod/ansible/vault/nonprod-secret")
   ("prod" . "/home/notprod/ansible/vault/prod-secret")
   ("foo" . "/etc/foo.secret")))

This allows properly tagged v1.2 vault files to automatically find and use their associated password files.

Notes on version 0.5.0 and beyond

• ansible-vault-mode is now more aggressive in detecting valid password files. If it fails to locate a valid password file it will prompt the user for input.

• The minor mode now defines some key bindings under C-c a

  • C-c a d Decrypts the current file and saves it
  • C-c a D Decrypts the current region
  • C-c a e Encrypts the current file and saves it
  • C-c a E Encrypts the current region
  • C-c a p Updates the password of the current buffer
  • C-c a i Updates the vault-id of the current buffer

Contributing

Bug reports and pull requests are welcome on GitHub issues. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Copyright

Copyright (C) 2016 Zachary Elliott <[email protected]>

This program is free software you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
details.

You should have received a copy of the GNU General Public License along with
this software.  If not, write to the Free Software Foundation, Inc., 51
Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.