/community.crypto

The community.crypto collection for Ansible.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Ansible Community Crypto Collection

Shippable build status Codecov

Provides modules for Ansible for various cryptographic operations.

Tested with Ansible

Tested with both the current Ansible 2.9 release and the current development version of Ansible.

External requirements

The exact requirements for every module are listed in the module documentation. Most modules require a recent enough version of the Python cryptography library. See the module documentations for the minimal version supported for each module.

Included content

  • OpenSSL / PKI modules:
    • openssl_csr_info
    • openssl_csr
    • openssl_dhparam
    • openssl_pkcs12
    • openssl_privatekey_info
    • openssl_privatekey
    • openssl_publickey
    • x509_certificate_info
    • x509_certificate
    • x509_crl_info
    • x509_crl
    • certificate_complete_chain
  • OpenSSH modules:
    • openssh_cert
    • openssh_keypair
  • ACME modules:
    • acme_account_info
    • acme_account
    • acme_certificate
    • acme_certificate_revoke
    • acme_challenge_cert_helper
    • acme_inspect
  • ECS modules:
    • ecs_certificate
    • ecs_domain
  • Miscellaneous modules:
    • get_certificate
    • luks_device

Using this collection

See Ansible Using collections for more details.

Contributing to this collection

We're following the general Ansible contributor guidelines; see Ansible Community Guide.

If you want to clone this repositority (or a fork of it) to improve it, you can proceed as follows:

  1. Create a directory ansible_collections/community;
  2. In there, checkout this repository (or a fork) as crypto;
  3. Add the directory containing ansible_collections to your ANSIBLE_COLLECTIONS_PATHS.

Release notes

Roadmap

More information

Licensing

GNU General Public License v3.0 or later.

See COPYING to see the full text.