cert-formula

Travis CI Build Status Semantic Release

A SaltStack formula to deploy certificates.

1. General notes

See the full SaltStack Formulas installation and usage instructions.

If you are interested in writing or contributing to formulas, please pay attention to the Writing Formula Section.

If you want to use this formula, please pay attention to the FORMULA file and/or git tag, which contains the currently released version. This formula is versioned according to Semantic Versioning.

See Formula Versioning Section for more details.

If you need (non-default) configuration, please refer to:

2. Contributing to this repo

Commit message formatting is significant!!

Please see How to contribute for more details.

3. Available states

3.1. cert

Meta-state (This is a state that includes other states).

Deploys or removes given certificates and keys.

3.2. cert.package

This state will install the required packages to manage certificates.

3.3. cert.deployed

This state will write the certificates and there matching keys, if any, are store on disk and integrated in the system.

4. Available modules

4.1. cert_formula_helper.get_filenames_matching_content

A helper function to find certificate files that match certificate contents. Useful if a certificate file gets renamed to something you don’t remember and have trouble finding a certificate you wish to remove.

Example

Example that finds all certificate files in /usr/local/share/ca-certificates matching the certificate contents found in the pillar data in cert:certlist:cert.filename:cert

salt-call cert_formula_helper.get_filenames_matching_content /usr/local/share/ca-certificates  pillar_key="cert:certlist:cert.filename:cert"