Keeper Secrets Manager Ansible

Overview

This module contains plugins that allow your Ansible automations to use Keeper Secrets Manager.

keeper_copy - Similar to ansible.builtin.copy. Uses the KSM vault for the ource/content.
keeper_get - Retrieve secrets from a record.
keeper_set - Update an existing record from Ansible information.
keeper_lookup - Retrieve secrets from a record using Ansible's lookup.

The full documentation can be found on GitBook.

Quick Start

Install, or update, the module.

$ pip install -U keeper-secrets-manager-ansible

Create a configuration file.

$ cd /path/to/your/ansible/root
$ keeper_ansible --keeper_token XXXX
Config file created at location client-config.json

Get plugins directory paths.

$ keeper_ansible --config

# Below are the directory paths to action and lookup plugins.
ANSIBLE_ACTION_PLUGINS=.../site-packages/keeper_secrets_manager_ansible/plugins/action_plugins
ANSIBLE_LOOKUP_PLUGINS=.../site-packages/keeper_secrets_manager_ansible/plugins/lookup_plugins

Either copy the paths into your ansible.cfg.

[defaults]
action_plugins = ../site-packages/keeper_secrets_manager_ansible/plugins/action_plugins
lookup_plugins = .../site-packages/keeper_secrets_manager_ansible/plugins/lookup_plugins

Or do some DevOps magic

$ export $(keeper_ansible --config)

Use some plugins in your playbooks tasks or roles. See full documentation for examples.

Then run your playbook.

$ ansible-playbook my_playbook.yml

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

keeper-secrets-manager-ansible-1.0.0.tar.gz (8.7 kB view details)

Uploaded Nov 16, 2021 Source

File details

Details for the file keeper-secrets-manager-ansible-1.0.0.tar.gz.

File metadata

Download URL: keeper-secrets-manager-ansible-1.0.0.tar.gz
Upload date: Nov 16, 2021
Size: 8.7 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.8

File hashes

Hashes for keeper-secrets-manager-ansible-1.0.0.tar.gz
Algorithm	Hash digest
SHA256	`ca8a40283b65ab3066619d2317bb7248fd63bcd3e90b00697e50df6e2b0302f3`
MD5	`0d7d2a287a477661b706b550171f2cb1`
BLAKE2b-256	`4275cd36a7ce35e0daffc85dd3b5be58892b4c7561445e832b33ce4076d70201`