Модуль community.general.ldap_passwd — установка паролей в LDAP

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.general.ldap_passwd.

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

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

Устанавливает пароль для записи LDAP. Этот модуль только проверяет, что заданный пароль действителен для указанной записи. Чтобы проверить наличие записи, см. community.general.ldap_entry.

Требования

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

python-ldap

Параметры

Параметр	Комментарии
bind_dn string	DN для привязки. Если этот параметр не указан, по умолчанию используется привязка SASL с механизмом EXTERNAL. Если параметр пуст, используется анонимная привязка.
bind_pw string	Пароль для использования с `bind_dn`. По умолчанию: `""`
ca_path path добавлено в community.general 6.5.0	Указывает путь к PEM-файлу с сертификатами CA.
client_cert path добавлено в community.general 7.1.0	Файл цепочки сертификатов в формате PEM для аутентификации клиента по SSL. Обязателен, если задан `client_key`.
client_key path добавлено в community.general 7.1.0	Файл в формате PEM с закрытым ключом для аутентификации клиента по SSL. Обязателен, если задан `client_cert`.
dn string / обязательный	DN записи, которую нужно добавить или удалить.
passwd string	Пароль (в открытом виде), который нужно установить для `dn`.
referrals_chasing string добавлено в community.general 2.0.0	Задаёт поведение при обработке ссылок перенаправления. `anonymous` следует по ссылкам перенаправления анонимно. Это поведение используется по умолчанию. `disabled` отключает обработку ссылок перенаправления. При этом для `OPT_REFERRALS` устанавливается значение off. Варианты: `"disabled"` `"anonymous"` ← (по умолчанию)
sasl_class string добавлено в community.general 2.0.0	Класс для аутентификации SASL. Варианты: `"external"` ← (по умолчанию) `"gssapi"`
server_uri string	Параметр `server_uri` может содержать список URI, разделённых запятыми или пробелами, в которых указаны только схема, хост и порт. Значение по умолчанию позволяет используемой библиотеке клиента LDAP искать сокет домена UNIX в расположении по умолчанию. Обратите внимание: при использовании нескольких URI невозможно определить, к какому из них будет подключён клиент. Поведение с URI, содержащими дополнительные поля, особенно при использовании запятых, не определено. По умолчанию: `"ldapi:///"`
start_tls boolean	Если установлено значение `true`, используется расширение LDAP START_TLS. Варианты: `false` ← (по умолчанию) `true`
validate_certs boolean	Если установлено значение `false`, сертификаты SSL не проверяются. Используйте этот параметр только на сайтах с самоподписанными сертификатами. Варианты: `false` `true` ← (по умолчанию)
xorder_discovery string добавлено в community.general 6.4.0	Задаёт способ обработки DN с упорядоченными значениями Xordered. `enable` выполняет поиск `ONELEVEL` ниже вышестоящего RDN, чтобы найти соответствующий DN. `disable` всегда использует DN без изменений (переданный параметром `dn`). `auto` выполняет поиск, только если первый RDN не содержит номера индекса (`{x}`). Варианты: `"enable"` `"auto"` ← (по умолчанию) `"disable"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз состояния изменений без внесения изменений в целевой объект.
diff_mode	Поддержка: отсутствует	В режиме сравнения возвращает сведения об изменённых данных (или о данных, которые, возможно, необходимо изменить в `check_mode`).

Примечания

Примечание

По умолчанию для аутентификации выполняется привязка SASL EXTERNAL через сокет домена UNIX. Например, это хорошо работает с установкой Ubuntu по умолчанию, в которую входит правило ACL cn=peercred,cn=external,cn=auth, позволяющее пользователю root изменять конфигурацию сервера. Если для доступа к серверу необходимо использовать простую привязку, передайте учётные данные в bind_dn и bind_pw.

Примеры

- name: Set a password for the admin user
  community.general.ldap_passwd:
    dn: cn=admin,dc=example,dc=com
    passwd: "{{ vault_secret }}"

- name: Setting passwords in bulk
  community.general.ldap_passwd:
    dn: "{{ item.key }}"
    passwd: "{{ item.value }}"
  with_dict:
    alice: alice123123
    bob: "|30b!"
    admin: "{{ vault_secret }}"

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

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

Ключ	Описание
modlist list / элементы=string	Список изменённых параметров. Возвращается: при успехе Пример: `[[2, "olcRootDN", ["cn=root,dc=example,dc=com"]]]`

Авторы

Keller Fuchs (@KellerFuchs)

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

© 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/ldap_passwd_module.html