Модуль community.crypto.openssl_dhparam — создание параметров Диффи — Хеллмана OpenSSL

attributes

псевдонимы: attr

string

Атрибуты, которыми должен обладать результирующий объект файловой системы.

Список поддерживаемых флагов см. на странице руководства chattr в целевой системе.

Эта строка должна содержать атрибуты в том же порядке, в каком они отображаются командой lsattr.

По умолчанию предполагается оператор =; в противном случае в строку необходимо включить операторы + или -.

backup

boolean

Создать резервную копию с временной меткой, чтобы можно было восстановить исходные параметры DH, если вы случайно перезаписали их новыми.

Варианты:

• false ← (по умолчанию)
• true

force

boolean

Следует ли повторно генерировать параметры, даже если они уже существуют.

Варианты:

• false ← (по умолчанию)
• true

group

string

Имя группы, которой должен принадлежать объект файловой системы; это значение передается команде chown.

Если значение не указано, используется текущая группа текущего пользователя, если только вы не root; в этом случае может быть сохранен прежний владелец.

mode

any

Права доступа, которыми должен обладать результирующий объект файловой системы.

Если вы привыкли к /usr/bin/chmod, помните, что режимы на самом деле являются восьмеричными числами. Ansible необходимо передать достаточно информации, чтобы он мог правильно их обработать. Для обеспечения согласованных результатов заключайте восьмеричные числа в кавычки (например, '644' или '1777'), чтобы Ansible получил строку и выполнил собственное преобразование строки в число. Добавление ведущего нуля (например, 0755) иногда работает, но может привести к сбою в циклах и некоторых других ситуациях.

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

Начиная с Ansible 1.8, режим можно задавать в символьной форме (например, u+rwx или u=rw,g=r,o=r).

Если параметр mode не указан и целевой объект файловой системы не существует, при установке режима для нового объекта файловой системы будет использоваться системное значение umask по умолчанию.

Если параметр mode не указан и целевой объект файловой системы существует, будет использоваться режим существующего объекта файловой системы.

Указание mode — лучший способ обеспечить создание объектов файловой системы с правильными правами доступа. Подробности см. в CVE-2020-1736.

owner

string

Имя пользователя, которому должен принадлежать объект файловой системы; это значение передается команде chown.

Если значение не указано, используется текущий пользователь, если только вы не root; в этом случае может быть сохранен прежний владелец.

Числовое имя пользователя будет считаться идентификатором пользователя, а не именем пользователя. Во избежание неоднозначности не используйте числовые имена пользователей.

path

path / обязательный

Имя файла, в который будут сохранены созданные параметры.

return_content

boolean

добавлено в community.crypto 1.0.0

Если задано значение true, содержимое параметров DH (текущих или созданных) будет возвращено в виде dhparams.

Варианты:

• false ← (по умолчанию)
• true

select_crypto_backend

string

добавлено в community.crypto 1.0.0

Определяет, какую криптографическую среду использовать.

По умолчанию выбирается auto: модуль пытается использовать cryptography, если оно доступно, а в противном случае переключается на openssl.

Если задано значение openssl, будет предпринята попытка использовать исполняемый файл OpenSSL openssl.

Если задано значение cryptography, будет предпринята попытка использовать библиотеку cryptography.

Варианты:

• "auto" ← (по умолчанию)
• "cryptography"
• "openssl"

selevel

string

Уровень в контексте объекта файловой системы SELinux.

Это атрибут MLS/MCS, иногда называемый range.

Если задано значение _default, будет использоваться часть политики level, если она доступна.

serole

string

Роль в контексте объекта файловой системы SELinux.

Если задано значение _default, будет использоваться часть политики role, если она доступна.

setype

string

Тип в контексте объекта файловой системы SELinux.

Если задано значение _default, будет использоваться часть политики type, если она доступна.

seuser

string

Пользователь в контексте объекта файловой системы SELinux.

По умолчанию, если применимо, используется политика system.

Если задано значение _default, будет использоваться часть политики user, если она доступна.

size

integer

Размер создаваемых параметров DH (в битах).

По умолчанию: 4096

state

string

Должны ли параметры существовать; модуль выполняет действие, если фактическое состояние отличается от указанного.

Варианты:

• "absent"
• "present" ← (по умолчанию)

unsafe_writes

boolean

Определяет, когда использовать атомарные операции для предотвращения повреждения данных или несогласованного чтения целевого объекта файловой системы.

По умолчанию этот модуль использует атомарные операции для предотвращения повреждения данных или несогласованного чтения целевых объектов файловой системы, однако иногда настройки системы или ее неисправности делают это невозможным. Например, объекты файловой системы, смонтированные в Docker, нельзя атомарно обновить из контейнера — их можно записать только небезопасным способом.

Этот параметр позволяет Ansible при сбое атомарных операций перейти к небезопасным методам обновления объектов файловой системы (однако он не заставляет Ansible выполнять небезопасную запись).

ВАЖНО! Небезопасная запись подвержена гонкам и может привести к повреждению данных.

Варианты:

• false ← (по умолчанию)
• true

check_mode

Поддержка: полная

Может работать в режиме check_mode и возвращать прогноз статуса изменений, не изменяя целевой объект.

diff_mode

Поддержка: нет

В режиме diff возвращает сведения о том, что изменилось (или, возможно, должно измениться в check_mode).

idempotent

Поддержка: частичная

Модуль не является идемпотентным, если force=true.

При повторном запуске с теми же аргументами вне режима проверки второй вызов не сообщает об изменениях.

Предполагается, что система, состояние которой контролирует или запрашивает модуль, не изменилась существенным образом.

safe_file_operations

Поддержка: полная

Использует строгие функции Ansible для работы с файлами, чтобы обеспечивать правильные права доступа и предотвращать повреждение данных.

backup_file

string

Имя созданного файла резервной копии.

Возвращается: при изменении и если backup имеет значение true

Пример: "/path/to/dhparams.pem.2019-03-09@11:22~"

dhparams

string

добавлено в community.crypto 1.0.0

Содержимое параметров DH (текущих или созданных).

Возвращается: если state имеет значение present и return_content имеет значение true

filename

string

Путь к созданным параметрам Диффи — Хеллмана.

Возвращается: при изменении или успешном выполнении

Пример: "/etc/ssl/dhparams.pem"

size

integer

Размер параметров Диффи — Хеллмана (в битах).

Возвращается: при изменении или успешном выполнении

Пример: 4096