Модуль community.general.ipa_config – управление глобальными настройками конфигурации FreeIPA

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать коллекцию в плейбуке, укажите: community.general.ipa_config.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Краткое описание

Изменение глобальных настроек конфигурации сервера FreeIPA.

Параметры

Параметр	Комментарии
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` — нет, модуль использует этот файл keytab 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"`
ipaconfigstring псевдонимы: configstring list / элементы=string добавлено в community.general 2.5.0	Дополнительные хеши для создания в модуле подключаемых паролей. Варианты: `"AllowNThash"` `"KDC:Disable Last Success"` `"KDC:Disable Lockout"` `"KDC:Disable Default Preauth for SPNs"`
ipadefaultemaildomain псевдонимы: emaildomain string	Домен электронной почты по умолчанию для новых пользователей.
ipadefaultloginshell псевдонимы: loginshell string	Оболочка по умолчанию для новых пользователей.
ipadefaultprimarygroup псевдонимы: primarygroup string добавлено в community.general 2.5.0	Группа по умолчанию для новых пользователей.
ipagroupobjectclasses псевдонимы: groupobjectclasses list / элементы=string добавлено в community.general 7.3.0	Список objectclass групп.
ipagroupsearchfields псевдонимы: groupsearchfields list / элементы=string добавлено в community.general 2.5.0	Список полей для поиска групп.
ipahomesrootdir псевдонимы: homesrootdir string добавлено в community.general 2.5.0	Расположение домашних каталогов по умолчанию.
ipakrbauthzdata псевдонимы: krbauthzdata list / элементы=string добавлено в community.general 2.5.0	Типы PAC, поддерживаемые для служб по умолчанию. Варианты: `"MS-PAC"` `"PAD"` `"nfs:NONE"`
ipamaxusernamelength псевдонимы: maxusernamelength integer добавлено в community.general 2.5.0	Максимальная длина имен пользователей.
ipapwdexpadvnotify псевдонимы: pwdexpadvnotify integer добавлено в community.general 2.5.0	Уведомление о скором истечении срока действия пароля, в днях.
ipasearchrecordslimit псевдонимы: searchrecordslimit integer добавлено в community.general 2.5.0	Максимальное число записей для поиска (-1 или 0 означает отсутствие ограничения).
ipasearchtimelimit псевдонимы: searchtimelimit integer добавлено в community.general 2.5.0	Максимальное время поиска (в секундах; -1 или 0 означает отсутствие ограничения).
ipaselinuxusermaporder псевдонимы: selinuxusermaporder list / элементы=string добавлено в community.general 3.7.0	Порядок сопоставления пользователей SELinux (порядок пользователей SELinux по возрастанию приоритета).
ipauserauthtype псевдонимы: userauthtype list / элементы=string добавлено в community.general 2.5.0	Тип аутентификации, используемый по умолчанию. Вариант `idp` добавлен в community.general 7.3.0. Вариант `passkey` добавлен в community.general 8.1.0. Варианты: `"password"` `"radius"` `"otp"` `"pkinit"` `"hardened"` `"idp"` `"passkey"` `"disabled"`
ipauserobjectclasses псевдонимы: userobjectclasses list / элементы=string добавлено в community.general 7.3.0	Список objectclass пользователей.
ipausersearchfields псевдонимы: usersearchfields list / элементы=string добавлено в community.general 2.5.0	Список полей для поиска пользователей.
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: Ensure password plugin features DC:Disable Last Success and KDC:Disable Lockout are enabled
  community.general.ipa_config:
    ipaconfigstring: ["KDC:Disable Last Success", "KDC:Disable Lockout"]
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the default login shell is bash
  community.general.ipa_config:
    ipadefaultloginshell: /bin/bash
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the default e-mail domain is ansible.com
  community.general.ipa_config:
    ipadefaultemaildomain: ansible.com
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the default primary group is set to ipausers
  community.general.ipa_config:
    ipadefaultprimarygroup: ipausers
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the group search fields are set to 'cn,description'
  community.general.ipa_config:
    ipagroupsearchfields: ['cn', 'description']
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the home directory location is set to /home
  community.general.ipa_config:
    ipahomesrootdir: /home
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the default types of PAC supported for services is set to MS-PAC and PAD
  community.general.ipa_config:
    ipakrbauthzdata: ["MS-PAC", "PAD"]
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the maximum user name length is set to 32
  community.general.ipa_config:
    ipamaxusernamelength: 32
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the password expiration notice is set to 4 days
  community.general.ipa_config:
    ipapwdexpadvnotify: 4
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the search record limit is set to 100
  community.general.ipa_config:
    ipasearchrecordslimit: 100
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the search time limit is set to 2 seconds
  community.general.ipa_config:
    ipasearchtimelimit: 2
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the default user auth type is password
  community.general.ipa_config:
    ipauserauthtype: ['password']
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the user search fields is set to 'uid,givenname,sn,ou,title'
  community.general.ipa_config:
    ipausersearchfields: ['uid', 'givenname', 'sn', 'ou', 'title']
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

- name: Ensure the SELinux user map order is set
  community.general.ipa_config:
    ipaselinuxusermaporder:
      - "guest_u:s0"
      - "xguest_u:s0"
      - "user_u:s0"
      - "staff_u:s0-s0:c0.c1023"
      - "unconfined_u:s0-s0:c0.c1023"
    ipa_host: localhost
    ipa_user: admin
    ipa_pass: supersecret

Возвращаемые значения

Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
config dictionary	Конфигурация, возвращенная API IPA. Возвращается: всегда

Авторы

Fran Fitzpatrick (@fxfitz)

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

© 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_config_module.html