java_cert – Использование keytool для импорта/удаления ключа из хранилища ключей Java (cacerts)

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

Обзор

Этот модуль является оболочкой вокруг keytool, который можно использовать для импорта/удаления сертификатов из заданного хранилища ключей Java.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cert_alias строка		Псевдоним импортированного сертификата. Псевдоним используется при проверке наличия сертификата в хранилище ключей.
cert_path путь		Локальный путь для загрузки сертификата. Для загрузки сертификата требуется один из `cert_url` или `cert_path`.
cert_port целое число	По умолчанию: 443	Порт для подключения к URL. Это будет использоваться для создания URL сервера:PORT.
cert_url строка		Базовый URL для получения SSL-сертификата. Для загрузки сертификата требуется один из `cert_url` или `cert_path`.
executable строка	По умолчанию: "keytool"	Путь к бинарному файлу keytool, если он не используется, поиск в переменной окружения PATH.
keystore_create булево	Варианты: нет да	Создать хранилище ключей, если оно не существует.
keystore_pass строка / обязательно		Пароль к хранилищу ключей.
keystore_path путь		Путь к хранилищу ключей.
keystore_type строка добавлен в 2.8		Тип хранилища ключей (JCEKS, JKS).
pkcs12_alias строка добавлен в 2.4		Псевдоним в хранилище ключей PKCS12.
pkcs12_password строка добавлен в 2.4	По умолчанию: ""	Пароль для импорта из хранилища ключей PKCS12.
pkcs12_path путь добавлен в 2.4		Локальный путь для загрузки хранилища ключей PKCS12.
state строка	Варианты: отсутствует присутствует ←	Определяет действие, которое может быть импортом или удалением сертификата.

Примеры

- name: Import SSL certificate from google.com to a given cacerts keystore
  java_cert:
    cert_url: google.com
    cert_port: 443
    keystore_path: /usr/lib/jvm/jre7/lib/security/cacerts
    keystore_pass: changeit
    state: present

- name: Remove certificate with given alias from a keystore
  java_cert:
    cert_url: google.com
    keystore_path: /usr/lib/jvm/jre7/lib/security/cacerts
    keystore_pass: changeit
    executable: /usr/lib/jvm/jre7/bin/keytool
    state: absent

- name: Import SSL certificate from google.com to a keystore, create it if it doesn't exist
  java_cert:
    cert_url: google.com
    keystore_path: /tmp/cacerts
    keystore_pass: changeit
    keystore_create: yes
    state: present

- name: Import a pkcs12 keystore with a specified alias, create it if it doesn't exist
  java_cert:
    pkcs12_path: "/tmp/importkeystore.p12"
    cert_alias: default
    keystore_path: /opt/wildfly/standalone/configuration/defaultkeystore.jks
    keystore_pass: changeit
    keystore_create: yes
    state: present

- name: Import SSL certificate to JCEKS keystore
  java_cert:
    pkcs12_path: "/tmp/importkeystore.p12"
    pkcs12_alias: default
    pkcs12_password: somepass
    cert_alias: default
    keystore_path: /opt/someapp/security/keystore.jceks
    keystore_type: "JCEKS"
    keystore_pass: changeit
    keystore_create: yes
    state: present

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

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

Ключ	Возвращаемое значение	Описание
cmd строка	успех	Выполненная команда для выполнения действия. Пример: keytool -importcert -noprompt -keystore
msg строка	успех	Вывод в стандартный вывод команды keytool после выполнения заданной команды. Пример: Модуль требует существующего хранилища ключей по пути keystore_path '/tmp/test/cacerts'
rc целое число	успех	Возвращаемое значение команды keytool. Пример: 0

Статус

Гарантии обратной совместимости интерфейса этого модуля нет. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Adam Hamsik (@haad)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/java_cert_module.html