community.general.ldap_search – Поиск записей на сервере LDAP
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в книге задач, укажите: community.general.ldap_search.
Добавлено в версии 0.2.0: из community.general
Обзор
- Возвращает результаты поиска LDAP.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python-ldap
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| attrs список / элементы=строка | Список атрибутов для ограничения результатов. Используйте фактический список или строку, разделенную запятыми. | |
| bind_dn строка | DN для привязки. Если этот параметр опущен, мы попробуем выполнить привязку SASL с механизмом EXTERNAL. Если параметр пустой, используется анонимная привязка. | |
| bind_pw строка | Пароль для использования с bind_dn. | |
| dn строка / обязательно | LDAP DN для поиска. | |
| filter строка | По умолчанию: "(objectClass=*)" | Используется для фильтрации результатов поиска LDAP. |
| schema логическое значение |
| Установите в значение true, чтобы вернуть полную схему атрибутов записей, а не их значения атрибутов. Переопределяет attrs при указании. |
| scope строка |
| Используемый LDAP-диапазон. |
| server_uri строка | По умолчанию: "ldapi:///" | URI сервера LDAP. Значение по умолчанию позволяет базовой библиотеке клиента LDAP искать сокет доменной Unix в его стандартном расположении. |
| start_tls логическое значение |
| Если значение равно истине, используется расширение START_TLS LDAP. |
| validate_certs логическое значение |
| Если установлено значение no, сертификаты SSL не будут проверены.Это следует использовать только на сайтах, использующих самозаверяющие сертификаты. |
Примечания
Примечание
- Параметры аутентификации по умолчанию попытаются использовать привязку SASL EXTERNAL через сокет домена Unix. Это хорошо работает, например, с установкой Ubuntu по умолчанию, которая включает правило ACL
cn=peercred,cn=external,cn=auth, позволяющее пользователю root изменять конфигурацию сервера. Если вам необходимо использовать простую привязку для доступа к вашему серверу, передайте данные в bind_dn и bind_pw.
Примеры
- name: Return all entries within the 'groups' organizational unit.
community.general.ldap_search:
dn: "ou=groups,dc=example,dc=com"
register: ldap_groups
- name: Return GIDs for all groups
community.general.ldap_search:
dn: "ou=groups,dc=example,dc=com"
scope: "onelevel"
attrs:
- "gidNumber"
register: ldap_group_gids
Авторы
- Sebastian Pfahl (@eryx12o45)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/ldap_search_module.html
