ldap_entry - Добавление или удаление записей LDAP.

Новая версия 2.3.

Описание
- Требования
Параметры
Примечания
Примеры
Статус
- Автор

Описание

Добавление или удаление записей LDAP. Этот модуль только проверяет существование или отсутствие записи LDAP, а не её атрибуты. Для проверки значений атрибутов записи см. ldap_attr.

Требования

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

python-ldap

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
attributes	Значение по умолчанию: None	Если state=present, атрибуты, необходимые для создания записи. Существующие записи никогда не изменяются. Для проверки определенных значений атрибутов в существующей записи используйте модуль ldap_attr.
bind_dn	Значение по умолчанию: None	DN для привязки. Если этот параметр опущен, мы попробуем выполнить привязку SASL с механизмом EXTERNAL. Если он пустой, мы будем использовать анонимную привязку.
bind_pw	Значение по умолчанию: None	Пароль для использования с bind_dn.
dn обязательно		DN записи для добавления или удаления.
objectClass	Значение по умолчанию: None	Если state=present, значение или список значений, используемых при создании записи. Это может быть строка или фактический список строк.
params	Значение по умолчанию: None	Список опций, которые позволяют перезаписать любые параметры задачи или параметры attributes. Для удаления опции установите значение опции в `null`.
server_uri	Значение по умолчанию: ldapi:///	URI сервера LDAP. Значение по умолчанию позволяет библиотеке клиента LDAP искать сокет доменного имени UNIX в его стандартном расположении.
start_tls	Варианты: да нет ←	Если true, мы будем использовать расширение LDAP START_TLS.
state	Варианты: present ← absent	Целевое состояние записи.
validate_certs (добавлено в 2.4)	Варианты: да ← нет	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах с самоподписанными сертификатами.

Примечания

Примечание

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

Примеры

- name: Make sure we have a parent entry for users
  ldap_entry:
    dn: ou=users,dc=example,dc=com
    objectClass: organizationalUnit

- name: Make sure we have an admin user
  ldap_entry:
    dn: cn=admin,dc=example,dc=com
    objectClass:
      - simpleSecurityObject
      - organizationalRole
    attributes:
      description: An LDAP administrator
      userPassword: "{SSHA}tabyipcHzhwESzRaGA7oQ/SDoBZQOGND"

- name: Get rid of an old entry
  ldap_entry:
    dn: ou=stuff,dc=example,dc=com
    state: absent
    server_uri: ldap://localhost/
    bind_dn: cn=admin,dc=example,dc=com
    bind_pw: password

#
# The same as in the previous example but with the authentication details
# stored in the ldap_auth variable:
#
# ldap_auth:
#   server_uri: ldap://localhost/
#   bind_dn: cn=admin,dc=example,dc=com
#   bind_pw: password
- name: Get rid of an old entry
  ldap_entry:
    dn: ou=stuff,dc=example,dc=com
    state: absent
    params: "{{ ldap_auth }}"

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимости.

Автор

Jiri Tyr (@jtyr)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/ldap_entry_module.html