Модуль community.general.ipa_pwpolicy — управление политиками паролей FreeIPA
Примечание
Этот модуль входит в коллекцию community.general (версия 12.6.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install community.general.
Чтобы использовать её в плейбуке, укажите: community.general.ipa_pwpolicy.
Добавлено в community.general 2.0.0
Краткое описание
- Добавление, изменение или удаление политики паролей с помощью API IPA.
Параметры
Параметр | Комментарии |
|---|---|
dictcheck boolean добавлено в community.general 8.2.0 | Проверять, совпадает ли пароль (с возможными изменениями) со словом из словаря (с помощью cracklib). Варианты:
|
failinterval string | Период (в секундах), по истечении которого счётчик неудачных попыток входа сбрасывается. |
gracelimit integer добавлено в community.general 8.2.0 | Максимальное количество входов в LDAP после истечения срока действия пароля. |
group псевдонимы: name string | Имя группы, к которой применяется политика. Если не указано, используется глобальная политика. |
historylength string | Количество предыдущих паролей, которые сохраняются в истории. Пользователи не могут повторно использовать пароли, сохранённые в истории. |
ipa_host string | IP-адрес или имя узла сервера IPA. Если значение не указано в задаче, вместо него используется значение переменной среды Если в задаче не указаны ни переменная среды В FreeIPA необходима соответствующая запись Если в задаче недоступны ни запись DNS, ни переменная среды По умолчанию: |
ipa_pass string | Пароль административного пользователя. Если значение не указано в задаче, вместо него используется значение переменной среды Обратите внимание: если доступна библиотека Если доступна переменная среды Если доступна переменная среды Если GSSAPI недоступен, необходимо использовать |
ipa_port integer | Порт сервера FreeIPA / IPA. Если значение не указано в задаче, вместо него используется значение переменной среды Если в задаче не указаны ни переменная среды По умолчанию: |
ipa_prot string | Протокол, используемый сервером IPA. Если значение не указано в задаче, вместо него используется значение переменной среды Если в задаче не указаны ни переменная среды Варианты:
|
ipa_timeout integer | Задаёт время ожидания бездействия (в секундах) для соединения. Для массовых операций это значение можно увеличить, чтобы избежать тайм-аута со стороны сервера IPA. Если значение не указано в задаче, вместо него используется значение переменной среды Если в задаче не указаны ни переменная среды По умолчанию: |
ipa_user string | Административная учётная запись, используемая на сервере IPA. Если значение не указано в задаче, вместо него используется значение переменной среды Если в задаче не указаны ни переменная среды По умолчанию: |
lockouttime string | Период (в секундах), в течение которого учётные записи пользователей заблокированы. |
maxfailcount string | Максимальное количество последовательных неудачных попыток до блокировки. |
maxpwdlife string | Максимальный срок действия пароля (в днях). |
maxrepeat integer добавлено в community.general 8.2.0 | Максимальное количество одинаковых идущих подряд символов в новом пароле. |
maxsequence integer добавлено в community.general 8.2.0 | Максимальная длина монотонных последовательностей символов в новом пароле. Пример монотонной последовательности длиной 5: |
minclasses string | Минимальное количество классов символов. |
minlength string | Минимальная длина пароля. |
minpwdlife string | Минимальный срок действия пароля (в часах). |
priority string | Приоритет политики. Большее значение означает более низкий приоритет. Обязательный параметр, если |
state string | Требуемое состояние. Варианты:
|
usercheck boolean добавлено в community.general 8.2.0 | Проверять, содержит ли пароль (с возможными изменениями) имя пользователя в той или иной форме (если длина имени больше 3 символов). Варианты:
|
validate_certs boolean | Применяется только в том случае, если Если задано значение Для сайтов под личным управлением, использующих самоподписанные сертификаты, следует задавать только значение Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: полная | Может работать в режиме |
diff_mode | Поддержка: нет | В режиме diff возвращает сведения об изменениях (или о том, что, возможно, потребуется изменить в |
Примечания
Примечание
- Этот модуль использует JSON-RPC поверх HTTP(S) для связи с сервером FreeIPA. Если необходимо включить управляемый узел в область FreeIPA, рассмотрите возможность использования коллекции freeipa.ansible_freeipa, однако для управления развёртыванием потребуется доступ к оболочке одного узла из области.
Примеры
- name: Modify the global password policy
community.general.ipa_pwpolicy:
maxpwdlife: '90'
minpwdlife: '1'
historylength: '8'
minclasses: '3'
minlength: '16'
maxfailcount: '6'
failinterval: '60'
lockouttime: '600'
ipa_host: ipa.example.com
ipa_user: admin
ipa_pass: topsecret
- name: Ensure the password policy for the group admins is present
community.general.ipa_pwpolicy:
group: admins
state: present
maxpwdlife: '60'
minpwdlife: '24'
historylength: '16'
minclasses: '4'
priority: '10'
minlength: '6'
maxfailcount: '4'
failinterval: '600'
lockouttime: '1200'
gracelimit: 3
maxrepeat: 3
maxsequence: 3
dictcheck: true
usercheck: true
ipa_host: ipa.example.com
ipa_user: admin
ipa_pass: topsecret
- name: Ensure that the group sysops does not have a unique password policy
community.general.ipa_pwpolicy:
group: sysops
state: absent
ipa_host: ipa.example.com
ipa_user: admin
ipa_pass: topsecret
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
pwpolicy dictionary | Политика паролей, возвращаемая API IPA. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/ipa_pwpolicy_module.html