jagter / ansible-cryptsetup

Setup and manage encrypted filesystems.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

DebOps project cryptsetup

Travis CI test-suite Ansible Galaxy

debops.cryptsetup allows you to configure encrypted filesystems on top of any given block device using dm-crypt/cryptsetup and LUKS. A random keyfile generated on the Ansible controller will be used for the encryption by default. It is your responsibility that the keyfile is kept secure for this to make sense. For example by storing the keyfile on an already encrypted filesystem (both on the Ansible controller and the remote system).

Features

  • Create a random keyfile or use an already existing keyfile.
  • Manage /etc/crypttab and /etc/fstab and mount point directories.
  • Create a LUKS header backup and store it on the Ansible controller.
  • Decrypt and mount a encrypted filesystem and delete the decryption key from persistent storage after mounting.

Installation

This role requires at least Ansible v1.9.0. To install it, run:

ansible-galaxy install debops.cryptsetup

Documentation

More information about debops.cryptsetup can be found in the official debops.cryptsetup documentation.

Role dependencies

  • debops.secret

Are you using this as a standalone role without DebOps?

You may need to include missing roles from the DebOps common playbook into your playbook.

Try DebOps now for a complete solution to run your Debian-based infrastructure.

Authors and license

cryptsetup role was written by:

License: GPLv3


This role is part of the DebOps project. README generated by ansigenome.

About

Setup and manage encrypted filesystems.

License:GNU General Public License v3.0