/trusted_certificate

Development repository for the trusted_certificate cookbook

Primary LanguageRubyApache License 2.0Apache-2.0

trusted_certificate cookbook

Cookbook Version CI State OpenCollective OpenCollective License

This cookbook provides a trusted_certificate resource to manage adding SSL/TLS certificates to the operating system's trust store.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Requirements

Platforms

  • Debian/Ubuntu
  • RHEL 6+

Chef

  • Chef 12.15+

Cookbooks

  • none

Recipes

default

Installs the ca-certificates package that provides the certificate trust mechanism.

Resources

trusted_certificate

Adds a certificate to the operating system's trust store.

properties

  • content: The contents of the cert to add. This can be specfied as inline content, a URL to a remote file, or a cookbook_file included in a wrapper cookbook.
  • certificate_name: The filename of the cert

actions

  • create
  • delete

example

Create certificate from inline content:

trusted_certificate 'my_corp' do
  action :create
  content 'THIS_WOULD_BE_THE_WHOLE_CERT_CONTENTS'
end

Download from a remote location:

trusted_certificate 'my_corp_remote' do
  action :create
  content 'http://www.example.com/my_corp_remote.crt'
end

Create cert from file included in a wrapper cookbook:

trusted_certificate 'my_corp_cert_wrapper' do
  action :create
  content 'cookbook_file://my_trusted_certs::my_corp_cert.crt'
end

Delete a certificate from the chain:

trusted_certificate 'my_corp' do
  action :delete
end

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

https://opencollective.com/sous-chefs#backers

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.

https://opencollective.com/sous-chefs/sponsor/0/website https://opencollective.com/sous-chefs/sponsor/1/website https://opencollective.com/sous-chefs/sponsor/2/website https://opencollective.com/sous-chefs/sponsor/3/website https://opencollective.com/sous-chefs/sponsor/4/website https://opencollective.com/sous-chefs/sponsor/5/website https://opencollective.com/sous-chefs/sponsor/6/website https://opencollective.com/sous-chefs/sponsor/7/website https://opencollective.com/sous-chefs/sponsor/8/website https://opencollective.com/sous-chefs/sponsor/9/website