gpg
ansible-gpg
Ansible module to import and remove GPG-keys using keybase.io or files.
Based on the work by Brandon Kalinowski and Thelonius Kort. Updated so that this can be published to ansible-galaxy.
With this module, managing gpg keys is very simple. Just specify the keybase username and either the key email or key fingerprint. You can also import keys from files.
The ansible fetch_url method is used for secure download of public keys over https.
When using key_file
, the key_id
is automatically determined from the file.
In addition to adding keybase.io functionality, this module also now automatically marks added keys as ultimately trusted, enabling the provisioned machine to encrypt files for the imported users.
Options
name | default | description |
---|---|---|
keybase_user | null | The Username to fetch on Keybase. The module will download https://keybase.io/ |
key_id | null | The id of the key to be fetched and imported. Only applicable to public keys. Either key_file or key_id is required. |
key_file | null | Filename of key to be imported. Must be on remote machine, not local. Either key_file or key_id is required. |
key_type | 'public' | What type of key to import. Only applicable to key_file |
bin_path | /usr/bin/gpg | Location of remote gpg binary |
state | 'present' | Desired state 'present', 'latest', or 'absent' |
Strange behaviors occur when used with insane keys. But this is a gpg problem.
installation via galaxy:
ansible-galaxy install compscidr.gpg
installation via galaxy / requirements
Add the following to requirements.yml
roles:
- name: compscidr.gpg
Then run
ansible-galaxy install -r requirements.yml
installation via git / requirements
Add the following to your requirements.yml
file:
# from github
- src: https://github.com/compscidr/ansible-gpg
name: compscidr.gpg
Then run
ansible-galaxy install -r requirements.yml
Example Playbook
---
- name: GPG Module Examples
hosts: vagrant
gather_facts: false
roles:
- role: compscidr.gpg
tasks:
- name: Import GPG key from keybase
gpg:
keybase_user: brandonkal
state: present
key_id: F33344CEF855F4FE4C2C55820E9D2E07D3D89BDD
# Key ID can be fingerprint as above or email address
tags:
- keybase
- name: Import Fake Keybase key | Fails
gpg:
keybase_user: jijd
state: present
tags:
- fake
- name: Copy GPG File
copy:
src: publickey.asc
dest: publickey.asc
tags:
- file
- name: Import Public GPG Key from file
gpg:
key_file: publickey.asc
tags:
- file
- name: Import Private GPG Key from file
gpg:
key_file: privatekey.asc
key_type: private
state: latest
tags:
- private
- name: Remove GPG Key
gpg:
keybase_user: gpgtools
key_id: [email protected]
state: absent
ansible-galaxy install compscidr/ansible-gpg