community.general.java_keystore – Создание или удаление Java хранилища ключей в формате JKS.

Примечание

Этот плагин входит в состав коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.java_keystore.

Обзор
Требования
Параметры
Примеры
Возвращаемые значения

Обзор

Создание или удаление Java хранилища ключей в формате JKS для заданного сертификата.

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

openssl
keytool

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
attributes строка добавлен в 2.3 ansible.builtin		Атрибуты, которые должен иметь полученный файл или каталог. Для получения поддерживаемых флагов обратитесь к справочной странице chattr на целевой системе. Эта строка должна содержать атрибуты в том же порядке, что и при выводе lsattr. Оператор `=` предполагается по умолчанию, в противном случае операторы `+` или `-` необходимо включить в строку. псевдонимы: attr
certificate строка / обязательно		Сертификат, который должен быть использован для создания хранилища ключей.
dest путь / обязательно		Абсолютный путь, куда должно быть сгенерировано хранилище jks.
force логическое значение	Варианты: нет ← да	Хранилище ключей будет создано, даже если оно уже существует.
group строка		Имя группы, которой должен принадлежать файл jks.
mode сырое		Режим файла.
name строка / обязательно		Имя сертификата.
owner строка		Имя пользователя, которому должен принадлежать файл jks.
password строка / обязательно		Пароль, который должен быть использован для защиты хранилища ключей.
private_key строка / обязательно		Приватный ключ, который должен быть использован для создания хранилища ключей.
private_key_passphrase строка добавлен в 0.2.0 community.general		Пароль для чтения приватного ключа, если требуется.
selevel строка		Часть уровня SELinux контекста файла. Это атрибут MLS/MCS, иногда известный как `range`. При установке в `_default`, будет использоваться часть политики `level`, если она доступна.
serole строка		Часть роли SELinux контекста файла. При установке в `_default`, будет использоваться часть политики `role`, если она доступна.
setype строка		Часть типа SELinux контекста файла. При установке в `_default`, будет использоваться часть политики `type`, если она доступна.
seuser строка		Часть пользователя SELinux контекста файла. По умолчанию используется политика `system`, где это применимо. При установке в `_default`, будет использоваться часть политики `user`, если она доступна.
unsafe_writes логическое значение добавлен в 2.2 ansible.builtin	Варианты: нет ← да	Влияние на использование атомарных операций для предотвращения повреждения данных или несогласованных чтений из целевого файла. По умолчанию этот модуль использует атомарные операции для предотвращения повреждения данных или несогласованных чтений из целевых файлов, но иногда системы настроены или просто сломаны таким образом, что это невозможно. Одним из примеров являются файлы, смонтированные через docker, которые не могут обновляться атомарно изнутри контейнера и могут записываться только неатомарно. Этот параметр позволяет Ansible использовать неатомарные методы обновления файлов, когда атомарные операции завершаются сбоем (однако он не принуждает Ansible выполнять неатомарные записи). ВАЖНО! Неатомарные записи подвержены гонкам и могут привести к повреждению данных.

Примеры

- name: Create a key store for the given certificate (inline)
  community.general.java_keystore:
    name: example
    certificate: |
      -----BEGIN CERTIFICATE-----
      h19dUZ2co2fI/ibYiwxWk4aeNE6KWvCaTQOMQ8t6Uo2XKhpL/xnjoAgh1uCQN/69
      MG+34+RhUWzCfdZH7T8/qDxJw2kEPKluaYh7KnMsba+5jHjmtzix5QIDAQABo4IB
      -----END CERTIFICATE-----
    private_key: |
      -----BEGIN RSA PRIVATE KEY-----
      DBVFTEVDVFJJQ0lURSBERSBGUkFOQ0UxFzAVBgNVBAsMDjAwMDIgNTUyMDgxMzE3
      GLlDNMw/uHyME7gHFsqJA7O11VY6O5WQ4IDP3m/s5ZV6s+Nn6Lerz17VZ99
      -----END RSA PRIVATE KEY-----
    password: changeit
    dest: /etc/security/keystore.jks

- name: Create a key store for the given certificate (lookup)
  community.general.java_keystore:
    name: example
    certificate: "{{lookup('file', '/path/to/certificate.crt') }}"
    private_key: "{{lookup('file', '/path/to/private.key') }}"
    password: changeit
    dest: /etc/security/keystore.jks

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращено	Описание
cmd строка	изменён и сбой	Выполненная команда для выполнения действия Пример: openssl x509 -noout -in /tmp/cert.crt -fingerprint -sha256
msg строка	изменён и сбой	Вывод stdout команды keytool/openssl после выполнения заданной команды или ошибка. Пример: Невозможно найти текущий отпечаток сертификата в ...
rc целое число	изменён и сбой	Возвращаемое значение выполнения команды keytool/openssl Пример: 0

Авторы

Guillaume Grossetie (@Mogztter)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/java_keystore_module.html