Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/arillso/ansible.ca-certificates

Ansible role to manage CA certificates in the Linux and Windows system trust store.
https://github.com/arillso/ansible.ca-certificates

ansible ansible-role ca-certificates

Last synced: 1 day ago
JSON representation

Ansible role to manage CA certificates in the Linux and Windows system trust store.

Host: GitHub
URL: https://github.com/arillso/ansible.ca-certificates
Owner: arillso
License: mit
Created: 2019-06-05T16:20:00.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2023-07-11T17:54:18.000Z (over 1 year ago)
Last Synced: 2024-05-08T00:23:26.132Z (6 months ago)
Topics: ansible, ansible-role, ca-certificates
Homepage:
Size: 28.3 KB
Stars: 9
Watchers: 3
Forks: 7
Open Issues: 3
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

# Ansible Role: ca-certificates

[![Build Status](https://img.shields.io/travis/arillso/ansible.ca-certificates.svg?branch=master&style=popout-square)](https://travis-ci.org/arillso/ansible.ca-certificates) [![license](https://img.shields.io/github/license/mashape/apistatus.svg?style=popout-square)](https://sbaerlo.ch/licence) [![Ansible Galaxy](https://img.shields.io/badge/ansible--galaxy-ca_certificates-blue.svg?style=popout-square)](https://galaxy.ansible.com/arillso/ca_certificates) [![Ansible Role](https://img.shields.io/ansible/role/d/42098.svg?style=popout-square)](https://galaxy.ansible.com/arillso/ca_certificates)

## Description

Ansible role to manage CA certificates in the Linux and Windows system trust store. It's possible to add PEM formatted certificates from the local file system, a already trusted HTTP(s) URL, from raw content.

## Installation

```bash
ansible-galaxy install arillso.ca_certificates
```

## Requirements

none

## Role Variables

### ca_certificates_root_directory

Location where the certificates are stored under windows before
they are imported into the certificate store of Windows.

```yml
ca_certificates_root_directory: '{{ ansible_env.TMP }}'
```

### ca_certificates_packages

Packages to be installed.

```yml
ca_certificates_packages:
- ca-certificates
```

### ca_certificates_files

List of CA certificates that are to be added to the certificate store of the system. Each list element is a configuration directory that defines the source (URL, Files or Inline as variable) of the certificate. It must contain a key'name' and one of the following keys in order to use the certificate:

| Option | Comments |
| :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| file | Path to a file on the host running the Ansible playbook. Relative file paths are related to the role's `files/` directory. |
| url | URL to a PEM-formatted certificate file |
| content | Certificate inline as PEM-formatted |
| store_name | Optional in Windows. The store name to use when importing. See: [Ansible doc](https://docs.ansible.com/ansible/latest/modules/win_certificate_store_module.html#win-certificate-store-module) |
| store_location | Optional in Windows. See: [Ansible doc](https://docs.ansible.com/ansible/latest/modules/win_certificate_store_module.html#win-certificate-store-module) |

```yml
ca_certificates_files: []
```

## Dependencies

None

## Example Playbook

```yml
- hosts: all
roles:
- arillso.ca_certificates
```

## Author

- [Simon Bärlocher](https://sbaerlocher.ch)

## License

This project is under the MIT License. See the [LICENSE](https://sbaerlo.ch/licence) file for the full license text.