openssl_dhparam - Генерация параметров Diffie-Hellman OpenSSL
Новое в версии 2.5.
Обзор
- Этот модуль позволяет (пере)генерировать параметры DH OpenSSL. Этот модуль использует общие аргументы файла для указания разрешений сгенерированного файла.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- OpenSSL
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| attributes (добавлен в 2.3) | Значение по умолчанию: Нет | Атрибуты, которые должен иметь файл или директория. Для получения поддерживаемых флагов обратитесь к странице руководства для chattr на целевой системе. Эта строка должна содержать атрибуты в том же порядке, что и отображается lsattr. псевдонимы: attr |
| force |
нет | Нужно ли перегенерировать параметры, даже если они уже существуют? |
| group | Значение по умолчанию: Нет | Имя группы, которая должна владеть файлом/директорией, как это будет передано в chown. |
| mode | Значение по умолчанию: Нет | Режим, который должен иметь файл или директория. Для тех, кто знаком с /usr/bin/chmod, помните, что режимы фактически являются восьмеричными числами (например, 0644 или 01777). Опущение ведущего нуля, вероятно, приведет к неожиданным результатам. Начиная с версии 1.8, режим может быть задан как символический режим (например, u+rwx или u=rw,g=r,o=r). |
| owner | Значение по умолчанию: Нет | Имя пользователя, который должен владеть файлом/директорией, как это будет передано в chown. |
| path необходимый | Имя файла, в котором будут сохранены сгенерированные параметры. | |
| selevel | Значение по умолчанию: s0 | Часть контекста файла SELinux. Это атрибут MLS/MCS, иногда известный как range. Функция _default работает так же, как и для seuser. |
| serole | Значение по умолчанию: Нет | Часть контекста файла SELinux, функция _default работает так же, как и для seuser. |
| setype | Значение по умолчанию: Нет | Часть контекста файла SELinux, функция _default работает так же, как и для seuser. |
| seuser | Значение по умолчанию: Нет | Часть контекста файла SELinux. По умолчанию будет использоваться системная политика, если применимо. Если установлено значение _default, будет использована часть политики user, если она доступна. |
| size | Значение по умолчанию: 4096 | Размер (в битах) сгенерированных параметров DH. |
| state |
| Нужно ли, чтобы параметры существовали или нет, выполняя действия, если состояние отличается от заявленного. |
| unsafe_writes (добавлен в 2.2) |
| Обычно этот модуль использует атомарные операции для предотвращения повреждения данных или несогласованных чтений из целевых файлов, иногда системы настраиваются или просто сломаны таким образом, что это невозможно. Одним из примеров являются файлы, смонтированные в Docker; их нельзя обновлять атомарно, а можно только ненадёжным способом. Этот булевый параметр позволяет Ansible перейти к небезопасным методам обновления файлов в тех случаях, когда у вас нет другого выбора. Следует иметь в виду, что это может привести к проблемам гонки и повреждению данных. |
Примеры
# Generate Diffie-Hellman parameters with the default size (4096 bits)
- openssl_dhparam:
path: /etc/ssl/dhparams.pem
# Generate DH Parameters with a different size (2048 bits)
- openssl_dhparam:
path: /etc/ssl/dhparams.pem
size: 2048
# Force regenerate an DH parameters if they already exist
- openssl_dhparam:
path: /etc/ssl/dhparams.pem
force: True
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| filename строка | изменено или успех | Путь к сгенерированным параметрам Diffie-Hellman Пример: /etc/ssl/dhparams.pem |
| size целое число | изменено или успех | Размер (в битах) параметров Diffie-Hellman Пример: 4096 |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.
Автор
- Thom Wiggers (@thomwiggers)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/openssl_dhparam_module.html
