Spec-Zone.ru › Ansible

Модуль 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).

Варианты:

  • false
  • true

failinterval

string

Период (в секундах), по истечении которого счётчик неудачных попыток входа сбрасывается.

gracelimit

integer

добавлено в community.general 8.2.0

Максимальное количество входов в LDAP после истечения срока действия пароля.

group

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

string

Имя группы, к которой применяется политика.

Если не указано, используется глобальная политика.

historylength

string

Количество предыдущих паролей, которые сохраняются в истории.

Пользователи не могут повторно использовать пароли, сохранённые в истории.

ipa_host

string

IP-адрес или имя узла сервера IPA.

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

Если в задаче не указаны ни переменная среды IPA_HOST, ни значение, для поиска сервера FreeIPA используется DNS.

В FreeIPA необходима соответствующая запись ipa-ca.

Если в задаче недоступны ни запись DNS, ни переменная среды IPA_HOST, ни значение, используется значение по умолчанию.

По умолчанию: "ipa.example.com"

ipa_pass

string

Пароль административного пользователя.

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

Обратите внимание: если доступна библиотека urllib_gssapi, для аутентификации в FreeIPA можно использовать GSSAPI.

Если доступна переменная среды KRB5CCNAME, модуль использует этот кэш учётных данных Kerberos для аутентификации на сервере FreeIPA.

Если доступна переменная среды KRB5_CLIENT_KTNAME, а KRB5CCNAME — нет, модуль использует этот файл ключей Kerberos для аутентификации.

Если GSSAPI недоступен, необходимо использовать ipa_pass.

ipa_port

integer

Порт сервера FreeIPA / IPA.

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

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

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

ipa_prot

string

Протокол, используемый сервером IPA.

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

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

Варианты:

  • "http"
  • "https" ← (по умолчанию)

ipa_timeout

integer

Задаёт время ожидания бездействия (в секундах) для соединения.

Для массовых операций это значение можно увеличить, чтобы избежать тайм-аута со стороны сервера IPA.

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

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

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

ipa_user

string

Административная учётная запись, используемая на сервере IPA.

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

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

По умолчанию: "admin"

lockouttime

string

Период (в секундах), в течение которого учётные записи пользователей заблокированы.

maxfailcount

string

Максимальное количество последовательных неудачных попыток до блокировки.

maxpwdlife

string

Максимальный срок действия пароля (в днях).

maxrepeat

integer

добавлено в community.general 8.2.0

Максимальное количество одинаковых идущих подряд символов в новом пароле.

maxsequence

integer

добавлено в community.general 8.2.0

Максимальная длина монотонных последовательностей символов в новом пароле. Пример монотонной последовательности длиной 5: 12345.

minclasses

string

Минимальное количество классов символов.

minlength

string

Минимальная длина пароля.

minpwdlife

string

Минимальный срок действия пароля (в часах).

priority

string

Приоритет политики.

Большее значение означает более низкий приоритет.

Обязательный параметр, если cn не является глобальной политикой.

state

string

Требуемое состояние.

Варианты:

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

usercheck

boolean

добавлено в community.general 8.2.0

Проверять, содержит ли пароль (с возможными изменениями) имя пользователя в той или иной форме (если длина имени больше 3 символов).

Варианты:

  • false
  • true

validate_certs

boolean

Применяется только в том случае, если ipa_prot имеет значение https.

Если задано значение false, сертификаты SSL не проверяются.

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

Варианты:

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

Атрибуты

Атрибут

Поддержка

Описание

check_mode

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

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

diff_mode

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

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

Примечания

Примечание

  • Этот модуль использует 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.

Возвращается: всегда

Пример: {"cn": ["admins"], "cospriority": ["10"], "dn": "cn=admins,cn=EXAMPLE.COM,cn=kerberos,dc=example,dc=com", "krbmaxpwdlife": ["60"], "krbminpwdlife": ["24"], "krbpwdfailurecountinterval": ["600"], "krbpwdhistorylength": ["16"], "krbpwdlockoutduration": ["1200"], "krbpwdmaxfailure": ["4"], "krbpwdmindiffchars": ["4"], "objectclass": ["top", "nscontainer", "krbpwdpolicy"]}

Авторы

  • Adralioh (@adralioh)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Получить помощь
  • Сообщить об ошибке
  • Предложить новую функцию
  • Связь

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API