community.crypto.openssl_pkcs12 модуль — Генерация архива OpenSSL PKCS#12

action

string

export или parse PKCS#12.

Варианты:

• "export" ← (по умолчанию)
• "parse"

attributes

aliases: attr

string

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

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

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

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

backup

boolean

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

Варианты:

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

certificate_path

path

Путь для чтения сертификатов и закрытых ключей.

Должен быть в формате PEM.

encryption_level

string

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

Определяет используемый уровень шифрования.

auto использует значение по умолчанию выбранного бэкенда. Для cryptography, это то, что конкретная версия библиотеки cryptography считает лучшим доступным шифрованием.

compatibility2022 использует параметры совместимости для старого программного обеспечения в 2022 году. Это поддерживается только бэкендом cryptography, если доступна cryptography >= 38.0.0.

Примечание, что этот параметр не используется для идемпотентности.

Варианты:

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

force

boolean

Следует ли пересоздать файл, даже если он уже существует.

Варианты:

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

friendly_name

aliases: name

string

Указывает понятное имя для сертификата и закрытого ключа.

group

string

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

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

iter_size

integer

Количество повторений шага шифрования.

Это не учитывается при проверках идемпотентности.

Это используется только бэкендом pyopenssl, или когда encryption_level=compatibility2022.

При использовании, значение по умолчанию равно 2048 для pyopenssl и 50000 для cryptography.

maciter_size

integer

Количество повторений шага MAC.

Это не учитывается при проверках идемпотентности.

Это используется только бэкендом pyopenssl. При использовании, значение по умолчанию равно 1.

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.

other_certificates

aliases: ca_certificates

list / elements=path

Список других сертификатов для включения. До Ansible 2.8 этот параметр назывался ca_certificates.

Предполагается, что в каждом файле находится один сертификат в кодировке PEM. Если файл содержит несколько сертификатов PEM, установите other_certificates_parse_all в true.

other_certificates_parse_all

boolean

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

Если установлено в true, предполагается, что файлы, упомянутые в other_certificates, могут содержать более одного сертификата в файле (или даже ни одного в файле).

Варианты:

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

owner

string

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

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

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

пароль

строка

Пароль PKCS#12.

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

путь

путь / обязательно

Имя файла для записи файла PKCS#12.

содержимое_приватного_ключа

строка

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

Содержимое файла приватного ключа.

Взаимоисключающее с privatekey_path.

пароль_приватного_ключа

строка

Источник пароля для расшифровки любых входных ключей.

путь_приватного_ключа

путь

Файл для чтения приватного ключа.

Взаимоисключающее с privatekey_content.

возвращать_содержимое

логическое

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

Если установлено в true, вернёт содержимое (текущее или сгенерированное) PKCS#12 как pkcs12.

Варианты:

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

выбрать_криптографический_бэкенд

строка

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

Определяет, какой криптографический бэкенд использовать.

По умолчанию выбран auto, который пытается использовать cryptography, если доступен, и переходит к pyopenssl. Если iter_size используется вместе с encryption_level не compatibility2022, или если maciter_size используется, auto всегда выберет pyopenssl для обратной совместимости.

Если установлено в pyopenssl, будет использована библиотека pyOpenSSL.

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

Варианты:

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

selevel

строка

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

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

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

serole

строка

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

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

setype

строка

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

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

seuser

строка

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

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

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

источник

путь

Путь к файлу PKCS#12 для анализа.

состояние

строка

Указывает, должен ли файл существовать или нет. Все параметры, кроме path, игнорируются, когда состояние равно absent.

Варианты:

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

неопасные_записи

логическое

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

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

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

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

Варианты:

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