avtool

README

avtool

Decrypt ansible vault files in golang.

The tool uses the same command line parameters as the ansible-vault command.

Why?

This is useful if you are writing code in golang and need to manipulate Ansible vault files.

Also useful if you want to decrypt an Ansible vault file, and are not keen on installing python.

Downloading

See the Releases

Code

The code is derived from code in the ansible project:

https://github.com/ansible/ansible

Building

Install golang 1.7. To build, use the Makefile, run:

make ci

The tool will be built and placed in the build/ folder.

Documentation

Index

• func Decrypt(data, password string) (result string, err error)
• func DecryptFile(filename, password string) (result string, err error)
• func Encrypt(body, password string) (result string, err error)
• func EncryptFile(filename, password string) (result string, err error)
• func GenerateRandomBytes(n int) ([]byte, error)

Functions

func Decrypt

func Decrypt(data, password string) (result string, err error)

Decrypt a string containing the ansible vault

func DecryptFile

func DecryptFile(filename, password string) (result string, err error)

func Encrypt

func Encrypt(body, password string) (result string, err error)

see https://github.com/ansible/ansible/blob/0b8011436dc7f842b78298848e298f2a57ee8d78/lib/ansible/parsing/vault/__init__.py#L710

func EncryptFile

func EncryptFile(filename, password string) (result string, err error)

func GenerateRandomBytes

func GenerateRandomBytes(n int) ([]byte, error)